conversation.created

New conversation

Object · conversationIncludes · contactInstant

When it fires

A new conversation started with a contact on a channel.

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

conversation.createdOnly this event
conversation.*Every event of Conversation
*The whole catalog

Fields it carries

paths for filters and templates

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": "conversation.created", "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40", "type": "conversation.created", "timestamp": "2026-09-22T14:30:00.000Z", "organizationId": "clx1org001", "actor": { "kind": "SYSTEM", "userId": null }, "data": { "conversation": { "id": "clx1cnv001", "channel": "WHATSAPP", "status": "OPEN", "priority": "NORMAL", "mode": "AI", "contactId": "clx1con001", "assignedToId": null, "intent": null, "lastMessageAt": "2026-09-22T14:30:00.000Z", "createdAt": "2026-09-22T14:30: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" } } }