message_createdMensaje creado
Notifica a tu endpoint cuando se recibe o se envía un mensaje de WhatsApp.
Registro de tu endpoint
El equipo de Eclectic registra tu endpoint. Envíanos su URL HTTPS y, si quieres verificar nuestras llamadas, una cabecera para incluir en cada solicitud (por ejemplo un token de autorización). Cada evento llega como un POST con cuerpo JSON.
Disparador
Se envía cuando un contacto te escribe, cuando tu agente de IA responde, cuando tu equipo escribe desde la app WhatsApp Business y cuando envías un mensaje con POST /messages/send. Los mensajes enviados desde la bandeja de Eclectic, las campañas y los flujos no lo disparan. Cubre solo WhatsApp.
Campos del payload
uuidIdentificador del mensaje.statusreceived para mensajes del contacto, sent para mensajes de tu negocio, o failed si la entrega falló.sentByQuién lo escribió: contact (el cliente), agent (tu agente de IA), whatsapp_app (tu equipo, desde la app WhatsApp Business) o api (un mensaje enviado con esta API).channelSiempre whatsapp.createdAtCuándo se creó el mensaje (ISO 8601, UTC).fromTeléfono del remitente, solo dígitos y con código de país.toTeléfono del destinatario, solo dígitos y con código de país.textTexto del mensaje. Vacío en mensajes que solo traen archivos.attachmentsURLs de descarga de los archivos del mensaje.mediaLos mismos archivos como objetos: id, url, filename y contentType (filename y contentType pueden ser null).metadataLos metadatos que enviaste con POST /messages/send, o un objeto vacío.contactEl contacto: uuid, name, phoneNumber (con +), email, tags, customFields, assignedUser (email del miembro del equipo asignado), createdAt, closedAt, y enlaces para abrir el contacto (href) y el chat (conversationHref) en Eclectic.
Las URLs de los archivos expiran 120 minutos después del evento. Descarga los archivos de inmediato o llama a GET /media/:id con el id del item de media para obtener una URL nueva.
Cada evento se envía una vez y no se reintenta: responde rápido con un 2xx y procesa el evento después. No se siguen redirecciones. Para recuperar mensajes que tu endpoint no recibió, usa GET /messages.
Ejemplo de payload
{
"event": "message_created",
"payload": {
"uuid": "7f1c2d9e-4b8a-4f0e-9c3d-2a6b5e8f1c42",
"status": "received",
"sentBy": "contact",
"channel": "whatsapp",
"createdAt": "2026-10-18T12:06:29.481203Z",
"from": "56912345678",
"to": "56987654321",
"text": "Hello, here is the quote",
"attachments": [
"https://storage.example.com/cotizacion.pdf?signature=..."
],
"media": [
{
"id": 482,
"url": "https://storage.example.com/cotizacion.pdf?signature=...",
"filename": "cotizacion.pdf",
"contentType": "application/pdf"
}
],
"metadata": {},
"contact": {
"uuid": "eb2b914a-977e-4ab8-96e7-b886698b3eac",
"name": "John Doe",
"phoneNumber": "+56912345678",
"email": "john@example.com",
"tags": ["Lead"],
"customFields": { "rut": "12.345.678-9" },
"assignedUser": "seller@example.com",
"avatarUrl": null,
"source": "whatsapp",
"createdAt": "2026-10-12T15:57:16.120938Z",
"closedAt": null,
"href": "https://www.eclecticlabs.com/app/contacts/contact?contactId=eb2b914a-977e-4ab8-96e7-b886698b3eac",
"conversationHref": "https://www.eclecticlabs.com/app/inbox/f3670b13-446b-4127-9623-8b1cd78899f9"
}
}
}