Skip to main content
POST
/
chats
/
enviar
/
mensaje
/
plantilla
/
arquitectura
curl -X POST https://beta.api-iobot-desarrollo.com/chats/enviar/mensaje/plantilla/arquitectura \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_APP_KEY" \
  -d '{
    "meta_id": "5215512345678",
    "contacto_id": 101,
    "chat_id": 55,
    "empresa_id": 1,
    "plantilla_id": 12,
    "user_id": 42,
    "user_name": "Carlos",
    "parameters": ["Juan Pérez", "Orden #9982"]
  }'

{
  "status": "success"
}
Versión avanzada del endpoint de envío de plantillas. Soporta inyección de variables dinámicas en los componentes de la plantilla (cuerpo, encabezado, botones), valida el estado de aprobación con Meta antes de enviar, y mueve automáticamente las conversaciones de pendiente a proceso al enviar el mensaje. Compatible con WhatsApp Business API Cloud (Meta), Messenger, Instagram DM y proveedores QR.

​
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

​
meta_id
string
required
Número de WhatsApp del contacto en formato internacional (ej. 5215512345678).
​
contacto_id
number
required
ID interno del contacto que recibirá la plantilla.
​
chat_id
number
required
ID interno de la conversación.
​
empresa_id
number
required
ID del negocio que envía la plantilla.
​
plantilla_id
number
required
ID interno de la plantilla a enviar.
​
parameters
string[]
Lista de valores de texto para inyectar en el cuerpo (body) de la plantilla. Cada elemento debe ser un string; el sistema los envuelve automáticamente en { type: "text", text: "..." } al enviar a Meta. Solo se inyectan en el componente body — los parámetros de encabezado o botones no son soportados por este campo.
["Orden #1234", "mañana a las 10am"]
​
user_id
number
ID del usuario (agente) que realiza el envío. Se usa para atribución del mensaje.
​
user_name
string
Nombre del usuario que envía la plantilla.
​
categoria_id
number
ID de categoría opcional para fines de reporte.
​
fecha
string
Fecha asociada al mensaje en formato ISO 8601 (opcional).

​
Respuesta

​
status
string
"success" cuando la plantilla fue aceptada y registrada.
curl -X POST https://beta.api-iobot-desarrollo.com/chats/enviar/mensaje/plantilla/arquitectura \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_APP_KEY" \
  -d '{
    "meta_id": "5215512345678",
    "contacto_id": 101,
    "chat_id": 55,
    "empresa_id": 1,
    "plantilla_id": 12,
    "user_id": 42,
    "user_name": "Carlos",
    "parameters": ["Juan Pérez", "Orden #9982"]
  }'

{
  "status": "success"
}