ByDomuDevelopers

knowledge.suggested

Noa suggested saving an answer as a document

Object · knowledgeInstant

When it fires

Noa suggests saving what a person answered, after Noa handed the conversation over (or the agent asked from the inbox), as a document. It is not a document yet: knowledge carries the proposal without customer data.

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

  • knowledge.suggestedOnly this event
  • knowledge.*Every event of Noa knowledge
  • *The whole catalog

Fields it carries

paths for filters and templates
knowledge.idProposal ID
knowledge.sourceSource (handoff or inbox)
knowledge.titleProposed title
knowledge.questionCustomer question
knowledge.collectionSuggested collection
knowledge.similarCountSimilar questions
knowledge.topicLabelTopic
knowledge.conversationIdConversation
knowledge.agentIdAgent who answered

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": "knowledge.suggested",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "knowledge.suggested",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "NOA",
    "userId": null
  },
  "data": {
    "knowledge": {
      "id": "clx1kpr001",
      "source": "HANDOFF",
      "title": "Horario de atención los sábados",
      "content": "Los sábados atendemos de 9:00 a. m. a 1:00 p. m. en la oficina y por WhatsApp. Los domingos y festivos no hay atención; los mensajes se responden el lunes.",
      "question": "¿Atienden los sábados? Mi número es [teléfono]",
      "collection": "Horarios",
      "webVisible": false,
      "similarCount": 4,
      "topicLabel": "Horario de fin de semana",
      "conversationId": "clx1cnv001",
      "agentId": "clx1usr001",
      "createdAt": "2026-09-22T14:30:00.000Z"
    }
  }
}
Get it with your test dataGET /v1/webhooks/sample/knowledge.suggested
Try it