Katalóg udalostí

Tvar obsahu

Každá udalosť je jeden objekt JSON:

{
  "id": "evt_01HKQN9…",
  "type": "conversation.created",
  "occurred_at": "2026-04-20T14:23:45.123Z",
  "account_id": "7c1d2c6e-…",
  "site_id": "0f3a…",
  "data": { … the resource, in the same shape the API returns it … }
}

id je hodnota z hlavičky X-RolChat-Event-Id a pri opakovaniach sa nemení. type má tvar <domain>.<noun>.<verb> alebo <domain>.<verb> v snake_case. data nesie zdroj tak, ako by ho vrátil zodpovedajúci endpoint GET, takže príjemcu možno napísať podľa referencie API a nikdy nepotrebuje druhú schému.

Rodiny udalostí

Rodina	Príklady	Posiela sa, keď
`conversation.*`	`conversation.created`, `conversation.assigned`, `conversation.resolved`, `conversation.reopened`, `conversation.merged`	Konverzácia zmení stav alebo vlastníka
`message.*`	`message.created`, `message.delivered`, `message.read`, `message.failed`	Správa je odoslaná alebo sa zmení stav jej doručenia
`crm.*`	`crm.lead.created`, `crm.contact.created`, `crm.contact.updated`, `crm.contact.merged`, `crm.deal.stage_changed`, `crm.deal.won`	Zmení sa lead, kontakt, firma alebo obchod
`ticket.*`	`ticket.created`, `ticket.status_changed`, `ticket.assigned`, `ticket.sla_breached`	Zmení sa tiket
`visitor.*`	`visitor.identified`, `visitor.cobrowse.requested`	Návštevník je identifikovaný alebo požiada o spoločné prezeranie
`marketing.*`	`marketing.form.submitted`, `marketing.booking.created`, `marketing.campaign.sent`, `marketing.unsubscribed`	Formuláre, rezervácie, kampane
`kb.*`	`kb.article.published`, `kb.article.unpublished`	Zmeny v báze znalostí
`phone.*`	`phone.call.started`, `phone.call.ended`, `phone.call.recorded`, `phone.call.transcribed`, `phone.voicemail.received`	Hovory a hlasová schránka
`automation.*`	`automation.rule.executed`, `automation.rule.failed`	Spustí sa pravidlo automatizácie
`privacy.*`	`privacy.consent.granted`, `privacy.consent.withdrawn`, `privacy.dsr.received`	Súhlasy a žiadosti dotknutých osôb
`billing.*`	`billing.invoice.created`, `billing.trial_expiring`, `billing.subscription.changed`	Predplatné a faktúry
`auth.*`	`auth.api_key.created`, `auth.api_key.revoked`, `auth.account.swapped`	Bezpečnostne významné udalosti účtu
`ai.*`	`ai.usage.recorded`	Každé volanie adaptéra AI, s počtami tokenov

Presný zoznam rastie s produktom; obrazovka odberu ukazuje každý typ, ktorý môže váš účet prijímať, a umožňuje filtrovať podľa typu.

Odber

Odbery webhookov patria k pluginu. V Nastavenia → Pluginy otvorte plugin (alebo vytvorte vlastný) a pridajte endpoint: URL s HTTPS, požadované typy udalostí a voliteľný zoznam povolených IP. Podpisový tajný kľúč sa zobrazí iba raz. Doručenia, opakovania a nedoručiteľné správy pre tento endpoint sa objavia v Logu webhookov pluginu.

Plugin Protocol na stránke Pluginy opisuje, ako plugin v manifeste deklaruje udalosti, ktoré potrebuje.

Poradie a doručovanie

Doručovanie prebieha aspoň raz. Deduplikujte podľa id.
Udalosti jedného zdroja sa odosielajú v poradí, ale opakovania môžu poradie doručení zmeniť. Používajte occurred_at a updated_at zdroja namiesto času doručenia.
Odber, ktorý stále zlyháva, hromadí nedoručiteľné správy; viac ako 100 pre jeden endpoint vyvolá upozornenie na strane RolChat a varovanie v logu pluginu.