Enviar Plantilla de Mensaje (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"
}

{
  "success": false,
  "error": "La plantilla aún no ha sido aprobada por meta. Espera unos segundos y vuelve a intentarlo."
}

{
  "status": "error",
  "error": "Limite de templates alcanzado"
}

{
  "status": "error",
  "error": "Error al enviar la plantilla"
}

{
  "estatus": "error",
  "error": "La empresa no existe"
}

{
  "estatus": "error",
  "error": "La plantilla no existe"
}

{
  "status": "error",
  "error": "Error: ..."
}

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"
}

{
  "success": false,
  "error": "La plantilla aún no ha sido aprobada por meta. Espera unos segundos y vuelve a intentarlo."
}

{
  "status": "error",
  "error": "Limite de templates alcanzado"
}

{
  "status": "error",
  "error": "Error al enviar la plantilla"
}

{
  "estatus": "error",
  "error": "La empresa no existe"
}

{
  "estatus": "error",
  "error": "La plantilla no existe"
}

{
  "status": "error",
  "error": "Error: ..."
}

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

string

required

App Key del negocio. Consulta Autenticación.

Cuerpo de la solicitud

string

required

Número de WhatsApp del contacto en formato internacional (ej. 5215512345678).

number

required

ID interno del contacto que recibirá la plantilla.

number

required

ID interno de la conversación.

number

required

ID del negocio que envía la plantilla.

number

required

ID interno de la plantilla a enviar.

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"]

number

ID del usuario (agente) que realiza el envío. Se usa para atribución del mensaje.

string

Nombre del usuario que envía la plantilla.

number

ID de categoría opcional para fines de reporte.

string

Fecha asociada al mensaje en formato ISO 8601 (opcional).

Respuesta

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"
}

{
  "success": false,
  "error": "La plantilla aún no ha sido aprobada por meta. Espera unos segundos y vuelve a intentarlo."
}

{
  "status": "error",
  "error": "Limite de templates alcanzado"
}

{
  "status": "error",
  "error": "Error al enviar la plantilla"
}

{
  "estatus": "error",
  "error": "La empresa no existe"
}

{
  "estatus": "error",
  "error": "La plantilla no existe"
}

{
  "status": "error",
  "error": "Error: ..."
}

Plantillas de Mensajes

Chats

Campañas

Reporte Compartido

Campañas Meta

Ordenes

Enviar Plantilla de Mensaje (Arquitectura)

Autenticación

Encabezados

Cuerpo de la solicitud

Respuesta

​Autenticación

​Encabezados

​Cuerpo de la solicitud

​Respuesta

Autenticación

Encabezados

Cuerpo de la solicitud

Respuesta