conversation.handoff_requested

The customer asked for a person

Object · conversationIncludes · contactInstant

When it fires

Noa handed the conversation to a person. handoff carries the reason and, when available, a summary.

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.handoff_requestedOnly 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.handoff_requested", "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40", "type": "conversation.handoff_requested", "timestamp": "2026-09-22T14:30:00.000Z", "organizationId": "clx1org001", "actor": { "kind": "NOA", "userId": null }, "data": { "conversation": { "id": "clx1cnv001", "channel": "WHATSAPP", "status": "OPEN", "priority": "NORMAL", "mode": "HUMAN", "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" }, "handoff": { "reason": "La clienta quiere negociar el precio", "reasonCategory": "COMPLEX_NEGOTIATION", "summary": "Interesada en P-0042, ofrece 430 millones con crédito preaprobado.", "requestedBy": "NOA" } } }