message.received

Mensagem do cliente

Objeto · messageInclui · conversationInclui · contactNa hora

Quando é emitido

Chegou uma mensagem do cliente por qualquer canal (WhatsApp, Instagram, Facebook, e-mail, chat do site…). Traz a mensagem, a conversa e o contato.

Na hora, quando acontece no ByDomu: pelo app, pela API, pela Noa, por uma automação ou uma integração. actor.kind diz quem foi: USER, NOA, SYSTEM, API, AUTOMATION ou INTEGRATION.

Assine com

message.receivedSó este evento
message.*Todos os de Mensagem
*O catálogo inteiro

Campos que traz

caminhos para filtros e modelos

message.idIdentificador da mensagem

message.directionEntrada ou saída

message.channelCanal

message.typeTipo de mensagem

message.textTexto da mensagem

message.conversationIdConversa

message.contactIdContato

message.sentByNoaEnviada pela Noa

conversation.idIdentificador da conversa

conversation.channelCanal

conversation.statusStatus da conversa

conversation.priorityPrioridade

conversation.modeQuem responde

conversation.contactIdContato

conversation.assignedToIdResponsável

conversation.intentIntenção

contact.idIdentificador do contato

contact.codeCódigo do contato

contact.firstNameNome

contact.lastNameSobrenome

contact.emailE-mail

contact.phoneTelefone

contact.sourceOrigem

contact.statusStatus

contact.typeTipo de contato

contact.scorePontuação

contact.ownerIdResponsável

contact.preferredCityCidade de interesse

contact.preferredTypeTipo de imóvel que procura

contact.budgetOrçamento

contact.tagsEtiquetas

Até 5 tentativas (0 s, 5 s, 30 s, 2 min e 10 min) em erro de rede, 429 ou 5xx. Responda 2xx em 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" } } }