ByDomuDevelopers

conversation.handoff_requested

El cliente pidió hablar con una persona

Objeto · conversationIncluye · contactAl instante

Cuándo se emite

Noa pasó la conversación a una persona. handoff trae el motivo y, si lo hay, un resumen.

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

  • conversation.handoff_requestedSolo este evento
  • conversation.*Todos los de Conversación
  • *Todo el catálogo

Campos que trae

rutas para filtrar y plantillas
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": "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"
    }
  }
}
Pídelo con tus datos de pruebaGET /v1/webhooks/sample/conversation.handoff_requested
Probar