message.received

Mensaje del cliente

Objeto · messageIncluye · conversationIncluye · contactAl instante

Cuándo se emite

Llegó un mensaje del cliente por cualquier canal (WhatsApp, Instagram, Facebook, correo, chat web…). Trae el mensaje, la conversación y el contacto.

Al instante, cuando pasa en ByDomu: desde la app, la API, Noa, una automatización o una integración. actor.kind dice quién fue: USER, NOA, SYSTEM, API, AUTOMATION o INTEGRATION.

Suscríbete con

message.receivedSolo este evento
message.*Todos los de Mensaje
*Todo el catálogo

Campos que trae

rutas para filtrar y plantillas

message.idIdentificador del mensaje

message.directionEntrante o saliente

message.channelCanal

message.typeTipo de mensaje

message.textTexto del mensaje

message.conversationIdConversación

message.contactIdContacto

message.sentByNoaLo envió Noa

conversation.idIdentificador de la conversación

conversation.channelCanal

conversation.statusEstado de la conversación

conversation.priorityPrioridad

conversation.modeQuién responde

conversation.contactIdContacto

conversation.assignedToIdResponsable

conversation.intentIntención

contact.idIdentificador del contacto

contact.codeCódigo del contacto

contact.firstNameNombre

contact.lastNameApellido

contact.emailCorreo

contact.phoneTeléfono

contact.sourceOrigen

contact.statusEstado

contact.typeTipo de contacto

contact.scorePuntaje

contact.ownerIdResponsable

contact.preferredCityCiudad de interés

contact.preferredTypeTipo de inmueble que busca

contact.budgetPresupuesto

contact.tagsEtiquetas

Hasta 5 intentos (0 s, 5 s, 30 s, 2 min y 10 min) ante error de red, 429 o 5xx. Responde 2xx en menos de 10 s.

{ "event": "message.received", "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40", "type": "message.received", "timestamp": "2026-09-22T14:30:00.000Z", "organizationId": "clx1org001", "actor": { "kind": "SYSTEM", "userId": null }, "data": { "message": { "id": "clx1msg001", "direction": "INBOUND", "channel": "WHATSAPP", "type": "TEXT", "text": "Hola, ¿el apartamento de Chapinero sigue disponible?", "mediaUrl": null, "conversationId": "clx1cnv001", "contactId": "clx1con001", "agentId": null, "sentByNoa": false, "timestamp": "2026-09-22T14:30:00.000Z" }, "conversation": { "id": "clx1cnv001", "channel": "WHATSAPP", "status": "OPEN", "priority": "NORMAL", "mode": "AI", "contactId": "clx1con001", "assignedToId": "clx1usr001", "intent": "QUIERE_VISITA", "lastMessageAt": "2026-09-22T14:30:00.000Z", "createdAt": "2026-09-20T15:04:00.000Z" }, "contact": { "id": "clx1con001", "code": "C-0042", "firstName": "Laura", "lastName": "Restrepo", "fullName": "Laura Restrepo", "email": "[email protected]", "phone": "+573000000001", "source": "WEBSITE", "status": "QUALIFIED", "type": "CLIENT", "score": 72, "ownerId": "clx1usr001", "preferredCity": "Bogotá", "preferredType": "APARTMENT", "budget": 450000000, "currency": "COP", "tags": [ "Compra", "Chapinero" ], "createdAt": "2026-09-20T15:04:00.000Z" } } }