Skip to main content
POST
/
chats
/
enviar
/
plantilla
/
business
curl -X POST https://beta.api-iobot-desarrollo.com/chats/enviar/plantilla/business \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_APP_KEY" \
  -d '{
    "empresa_id": 1,
    "phone_number": "5215512345678",
    "plantilla_id": 12,
    "name": "Juan Pérez",
    "parameters": ["Juan Pérez", "Orden #9982"]
  }'

{
  "success": true
}
Envía una plantilla de WhatsApp en nombre del negocio. A diferencia del endpoint de arquitectura, este endpoint no requiere un chat_id ni contacto_id preexistentes — crea automáticamente el contacto y la conversación si no existen. Útil para disparos externos, integraciones de CRM, o flujos donde el negocio inicia el contacto sin intervención de un agente.

​
Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

​
Encabezados

​
x-api-key
string
required
App Key del negocio. Consulta Autenticación.

​
Cuerpo de la solicitud

​
empresa_id
number
required
ID del negocio que envía la plantilla.
​
phone_number
string
required
Número de WhatsApp del destinatario. Se aceptan formatos con o sin caracteres especiales (guiones, espacios, +) — el sistema extrae solo los dígitos. Ejemplo: +52 155 1234 5678 o 5215512345678.
​
plantilla_id
number
required
ID interno de la plantilla a enviar. Debe pertenecer al negocio indicado en empresa_id.
​
parameters
string[]
Lista de valores de texto para inyectar en los componentes dinámicos de la plantilla. Cada elemento debe ser un string; el sistema los envuelve automáticamente en el formato { type: "text", text: "..." } al enviar a Meta. Por defecto es un arreglo vacío. Debe ser un arreglo; de lo contrario la solicitud será rechazada con 400.
["Juan Pérez", "Orden #1234"]
​
name
string
Nombre del contacto. Se usa como nombre visible si el contacto es creado por primera vez. Si se omite, se usa el número de teléfono como nombre. Debe ser un texto; de lo contrario la solicitud será rechazada con 400.

​
Respuesta

​
success
boolean
true cuando la plantilla fue enviada y registrada correctamente.
curl -X POST https://beta.api-iobot-desarrollo.com/chats/enviar/plantilla/business \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_APP_KEY" \
  -d '{
    "empresa_id": 1,
    "phone_number": "5215512345678",
    "plantilla_id": 12,
    "name": "Juan Pérez",
    "parameters": ["Juan Pérez", "Orden #9982"]
  }'

{
  "success": true
}