ByDomuDevelopers

conversation.assigned

Conversation assigned

Object · conversationIncludes · contactInstant

When it fires

The conversation moved to another agent. assignment carries from whom to whom and, when it applies, the rule or automation that assigned it.

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.assignedOnly 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.assigned",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "conversation.assigned",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "USER",
    "userId": "clx1usr001"
  },
  "data": {
    "conversation": {
      "id": "clx1cnv001",
      "channel": "WHATSAPP",
      "status": "OPEN",
      "priority": "NORMAL",
      "mode": "AI",
      "contactId": "clx1con001",
      "assignedToId": "clx1usr002",
      "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"
    },
    "assignment": {
      "fromUserId": "clx1usr001",
      "toUserId": "clx1usr002"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/conversation.assigned
Try it