Eventos

Todos los eventos llegan con la misma envoltura. Lo que cambia es data.

{
  "id": "<id de la entrega>",
  "event": "<nombre del evento>",
  "createdAt": "2026-09-24T17:31:08.412Z",
  "data": { }
}

message.received

Un cliente te escribió. Llega por cada mensaje, de WhatsApp o de Instagram. Las reacciones (👍, ❤️) no lo disparan.

WhatsApp
Instagram

{
  "id": "01a0d4a1-3b4c-7d5e-8f60-7a8b9c0d1e2f",
  "event": "message.received",
  "createdAt": "2026-09-24T17:31:08.412Z",
  "data": {
    "id": "01a0d4a1-3a10-7b21-9c32-4d5e6f7a8b9c",
    "wamid": "wamid.HBgNNTQ5MTE1NTU1MDEwMRUCABIYFjNFQjBDMEY2RTc1QjQ4QjM1QTI0AA==",
    "conversationId": "01a0d456-e5a1-7b2c-8d3e-4f5a6b7c8d9e",
    "phoneNumberId": "109876543210987",
    "contact": {
      "id": "01a0d456-e419-7c69-a35f-38a00ae65b81",
      "phone": "5491155550101",
      "name": "Marta Gómez"
    },
    "type": "text",
    "text": "Hola, ¿tienen envío a Rosario?",
    "receivedAt": "2026-09-24T17:31:07.000Z"
  }
}

{
  "id": "01a0d4b2-1c2d-7e3f-8a4b-5c6d7e8f9a0b",
  "event": "message.received",
  "createdAt": "2026-09-24T19:05:12.880Z",
  "data": {
    "id": "01a0d4b2-1a00-7b11-8c22-3d4e5f6a7b8c",
    "channel": "instagram",
    "conversationId": "01a0d4b1-9f8e-7d6c-8b5a-4f3e2d1c0b9a",
    "instagramAccountId": "17841400000000000",
    "contact": {
      "id": "01a0d4b1-9e00-7a11-8b22-3c4d5e6f7a8b",
      "instagram": "vale.rodriguez",
      "name": "Valentina Rodríguez"
    },
    "type": "text",
    "text": "¿Tienen la taza en color verde?",
    "receivedAt": "2026-09-24T19:05:11.000Z"
  }
}

string

Id del mensaje en eltick.

string

Id del mensaje en WhatsApp. No viene en Instagram.

string

Solo en Instagram: "instagram".

string

La conversación en el chat de eltick.

string

Tu número de WhatsApp que recibió el mensaje (útil si tienes varios).

object

id, name (el nombre de perfil) y phone (WhatsApp) o instagram (usuario de Instagram).

string

El tipo de mensaje: text, image, video, audio, document, sticker, location, contacts, button (tocó un botón de una plantilla), interactive (eligió una opción), entre otros.

string | null

El texto del mensaje. En adjuntos, el pie de foto o una descripción (por ejemplo “📷 Imagen”); en botones, el texto del botón.

string

Cuándo lo mandó el cliente.

Cada mensaje entrante abre (o renueva) la ventana de 24 horas: durante ese tiempo puedes responder con text libre por la API.

message.status

Cambió el estado de un mensaje que mandaste, ya sea por la API, desde el chat o en una campaña.

{
  "id": "01a0d4a2-8c9d-7e0f-8a1b-2c3d4e5f6a7b",
  "event": "message.status",
  "createdAt": "2026-09-24T17:24:36.615Z",
  "data": {
    "wamid": "wamid.HBgMNTczMDAxMjM0NTY3FQIAERgSN0VENTc4NDFGRDk0NEVEQkEA",
    "status": "read",
    "conversationId": "01a0d472-90ae-7187-9bb8-9f34c8d023c1",
    "contactId": "01a0d467-35b0-79f1-a6b6-1f834c8325eb",
    "phoneNumberId": "109876543210987",
    "campaignId": null,
    "errorCode": null
  }
}

string

El id de WhatsApp del mensaje: el mismo wamid que te devolvió POST /messages. Úsalo para encontrar el mensaje en tu sistema.

string

sent, delivered, read o failed.

string | null

Si el mensaje salió de una campaña, su id.

number | null

Con failed, el código de Meta. Por ejemplo 131026 (no se pudo entregar). Mira la tabla en Errores.

El estado solo avanza: sent → delivered → read. Si WhatsApp nos informa varios cambios juntos, te mandamos solo el más avanzado, así que puedes recibir read sin haber recibido delivered. Nunca vas a recibir un estado “hacia atrás”.

Si mandas campañas grandes, este evento llega una o más veces por cada destinatario. Suscríbete solo si lo vas a usar, y asegúrate de que tu servidor aguante el volumen.

contact.created

Se sumó un contacto nuevo a tu cuenta.

{
  "id": "01a0d4a3-1d2e-7f30-8a41-5b6c7d8e9f0a",
  "event": "contact.created",
  "createdAt": "2026-09-24T17:12:54.041Z",
  "data": {
    "id": "01a0d467-e634-7f7f-b98b-bdb48431733e",
    "phone": "525512345678",
    "name": "Ximena Robles",
    "source": "api"
  }
}

string

De dónde vino:

inbound: te escribió por WhatsApp por primera vez.
instagram: te escribió por Instagram por primera vez (en lugar de phone trae instagram, el usuario).
api: lo creaste con POST /contacts.

Los contactos que sumas desde la app (importando una planilla o a mano) y los que se crean al mandar un mensaje con POST /messages a un teléfono nuevo no disparan este evento.

contact.opted_out

Un contacto pidió no recibir más mensajes: tocó el botón de baja de una plantilla o escribió algo como “baja”, “stop”, “no recibir más” o “darme de baja”.

{
  "id": "01a0d4a4-5e6f-7a80-9b1c-2d3e4f5a6b7c",
  "event": "contact.opted_out",
  "createdAt": "2026-09-24T18:02:11.004Z",
  "data": {
    "id": "01a0d456-e44f-787d-a8e7-dc7cb7b0ddb1",
    "phone": "5491155550102",
    "at": "2026-09-24T18:02:10.000Z"
  }
}

eltick deja a ese contacto afuera de las campañas automáticamente. Si tienes otros sistemas que le mandan mensajes (tu CRM, tu tienda), usa este evento para marcarlo también ahí. Más en Bajas y consentimiento.

La API no bloquea los envíos a contactos dados de baja: POST /messages los manda igual. Antes de mandar mensajes de marketing por la API, revisa optedOut en el contacto o guarda estas bajas en tu sistema.

campaign.completed

Una campaña terminó de enviarse.

{
  "id": "01a0d4a5-9f0a-7b1c-8d2e-3f4a5b6c7d8e",
  "event": "campaign.completed",
  "createdAt": "2026-10-15T13:18:40.221Z",
  "data": {
    "id": "01a0d480-2a3b-7c4d-8e5f-6a7b8c9d0e1f",
    "name": "Día de la Madre — 20% off",
    "recipients": 1250,
    "sent": 1238,
    "delivered": 1190,
    "read": 702,
    "failed": 12,
    "completedAt": "2026-10-15T13:18:40.000Z"
  }
}

Los números son una foto del momento en que terminó el envío: las entregas y lecturas siguen subiendo durante las horas siguientes. Para los valores al día, consulta GET /campaigns.

Evento de prueba

El botón Probar de Ajustes › API y webhooks manda este message.received, con "test": true y datos de ejemplo:

{
  "id": "01a0d46c-5d2a-7a1b-9c3d-4e5f6a7b8c9d",
  "event": "message.received",
  "test": true,
  "createdAt": "2026-09-24T17:09:03.458Z",
  "data": {
    "text": "Mensaje de prueba de eltick",
    "contact": { "phone": "5491100000000", "name": "Prueba" }
  }
}

Verifica la firma igual que siempre, pero no lo proceses como un mensaje real.

Empieza aquí

Webhooks

Recetas

Referencia

message.received

message.status

contact.created

contact.opted_out

campaign.completed

Evento de prueba

​message.received

​message.status

​contact.created

​contact.opted_out

​campaign.completed

​Evento de prueba

message.received

message.status

contact.created

contact.opted_out

campaign.completed

Evento de prueba