message.received

Message from the customer

Object · messageIncludes · conversationIncludes · contactInstant

When it fires

A customer message arrived on any channel (WhatsApp, Instagram, Facebook, email, web chat…). Carries the message, the conversation and the contact.

Instantly, when it happens in ByDomu: from the app, the API, Noa, an automation or an integration. actor.kind tells you who: USER, NOA, SYSTEM, API, AUTOMATION or INTEGRATION.

Subscribe with

message.receivedOnly this event
message.*Every event of Message
*The whole catalog

Fields it carries

paths for filters and templates

message.idMessage id

message.directionInbound or outbound

message.channelChannel

message.typeMessage type

message.textMessage text

message.conversationIdConversation

message.contactIdContact

message.sentByNoaSent by Noa

conversation.idConversation id

conversation.channelChannel

conversation.statusConversation status

conversation.priorityPriority

conversation.modeWho replies

conversation.contactIdContact

conversation.assignedToIdOwner

conversation.intentIntent

contact.idContact id

contact.codeContact code

contact.firstNameFirst name

contact.lastNameLast name

contact.emailEmail

contact.phonePhone

contact.sourceSource

contact.statusStatus

contact.typeContact type

contact.scoreScore

contact.ownerIdOwner

contact.preferredCityCity of interest

contact.preferredTypeProperty type they want

contact.budgetBudget

contact.tagsTags

Up to 5 attempts (0 s, 5 s, 30 s, 2 min and 10 min) on network errors, 429 or 5xx. Reply 2xx in under 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" } } }