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": {
      "body": [
        { "type": "text", "text": "Juan Pérez" },
        { "type": "text", "text": "Orden #9982" }
      ]
    }
  }'
{
  "status": "success"
}

Documentation Index

Fetch the complete documentation index at: https://developer.iobot.chat/llms.txt

Use this file to discover all available pages before exploring further.

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
object
Valores dinámicos para inyectar en los componentes de la plantilla. La estructura sigue el formato de componentes de Meta.
{
  "header": [{ "type": "text", "text": "Juan" }],
  "body": [
    { "type": "text", "text": "Orden #1234" },
    { "type": "text", "text": "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": {
      "body": [
        { "type": "text", "text": "Juan Pérez" },
        { "type": "text", "text": "Orden #9982" }
      ]
    }
  }'
{
  "status": "success"
}