ByDomuDevelopers

ticket.note_added

Internal note on a ticket

Object · ticketIncludes · contactInstant

When it fires

An internal note was added to the ticket, in ByDomu or as a Linear comment (note.source).

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

  • ticket.note_addedOnly this event
  • ticket.*Every event of Ticket
  • *The whole catalog

Fields it carries

paths for filters and templates
ticket.idTicket id
ticket.numberNumber (#1042)
ticket.codeCode (T-1042)
ticket.titleTitle
ticket.summarySummary
ticket.statusStatus
ticket.priorityPriority
ticket.channelChannel
ticket.labelsLabels
ticket.assignedToIdAssignee
ticket.assignedToNameAssignee name
ticket.contactIdContact
ticket.conversationIdConversation
ticket.linearIssueKeyLinear issue
ticket.urlTicket link
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": "ticket.note_added",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "ticket.note_added",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "USER",
    "userId": "clx1usr001"
  },
  "data": {
    "ticket": {
      "id": "clx1tkt001",
      "number": 12,
      "code": "T-0012",
      "title": "No llegan las fotos al portal",
      "summary": "La clienta dice que la ficha P-0042 se ve sin fotos desde ayer.",
      "status": "PENDING",
      "priority": "HIGH",
      "channel": "WHATSAPP",
      "labels": [
        "Portales"
      ],
      "assignedToId": "clx1usr001",
      "assignedToName": "Andrés Mejía",
      "contactId": "clx1con001",
      "conversationId": "clx1cnv001",
      "linearIssueKey": "SOP-128",
      "url": "https://www.bydomu.com/inbox/tickets/clx1tkt001",
      "resolvedAt": null,
      "createdAt": "2026-09-22T14:30:00.000Z",
      "updatedAt": "2026-09-22T15:10: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"
    },
    "note": {
      "body": "Ya reprocesamos las fotos; pedirle que recargue la página.",
      "author": "Andrés Mejía",
      "source": "bydomu"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/ticket.note_added
Try it