Katalog događaja

Oblik sadržaja

Svaki događaj jedan je JSON objekt:

{
  "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 vrijednost u zaglavlju X-RolChat-Event-Id i ne mijenja se pri ponavljanjima. type ima oblik <domain>.<noun>.<verb> ili <domain>.<verb> u snake_caseu. data nosi resurs onako kako bi ga vratila odgovarajuća GET krajnja točka, pa se primatelj može napisati prema API referenci i nikada mu ne treba druga shema.

Obitelji događaja

Obitelj	Primjeri	Šalje se kada
`conversation.*`	`conversation.created`, `conversation.assigned`, `conversation.resolved`, `conversation.reopened`, `conversation.merged`	Razgovor promijeni stanje ili vlasnika
`message.*`	`message.created`, `message.delivered`, `message.read`, `message.failed`	Poruka je objavljena ili se promijeni status njezine isporuke
`crm.*`	`crm.lead.created`, `crm.contact.created`, `crm.contact.updated`, `crm.contact.merged`, `crm.deal.stage_changed`, `crm.deal.won`	Promijeni se lead, kontakt, tvrtka ili posao
`ticket.*`	`ticket.created`, `ticket.status_changed`, `ticket.assigned`, `ticket.sla_breached`	Promijeni se tiket
`visitor.*`	`visitor.identified`, `visitor.cobrowse.requested`	Posjetitelj je identificiran ili zatraži zajedničko pregledavanje
`marketing.*`	`marketing.form.submitted`, `marketing.booking.created`, `marketing.campaign.sent`, `marketing.unsubscribed`	Obrasci, rezervacije, kampanje
`kb.*`	`kb.article.published`, `kb.article.unpublished`	Promjene u bazi znanja
`phone.*`	`phone.call.started`, `phone.call.ended`, `phone.call.recorded`, `phone.call.transcribed`, `phone.voicemail.received`	Pozivi i govorna pošta
`automation.*`	`automation.rule.executed`, `automation.rule.failed`	Izvršava se pravilo automatizacije
`privacy.*`	`privacy.consent.granted`, `privacy.consent.withdrawn`, `privacy.dsr.received`	Privola i zahtjevi ispitanika
`billing.*`	`billing.invoice.created`, `billing.trial_expiring`, `billing.subscription.changed`	Pretplata i računi
`auth.*`	`auth.api_key.created`, `auth.api_key.revoked`, `auth.account.swapped`	Sigurnosno važni događaji računa
`ai.*`	`ai.usage.recorded`	Svaki poziv AI adaptera, s brojem tokena

Točan popis raste s proizvodom; zaslon pretplate prikazuje svaku vrstu koju vaš račun može primati i omogućuje filtriranje po vrsti.

Pretplata

Pretplate na webhookove pripadaju dodatku. U Postavke → Dodaci otvorite dodatak (ili izradite prilagođeni) i dodajte krajnju točku: HTTPS URL, vrste događaja koje želite i neobavezni popis dopuštenih IP adresa. Tajna za potpisivanje prikazuje se samo jednom. Isporuke, ponavljanja i neisporučive poruke za tu krajnju točku pojavljuju se u Zapisniku webhookova dodatka.

Plugin Protocol na stranici Dodaci opisuje kako dodatak u svom manifestu navodi događaje koji su mu potrebni.

Redoslijed i isporuka

Isporuka je najmanje jednom. Deduplicirajte po id.
Događaji za jedan resurs šalju se redom, ali ponavljanja mogu promijeniti redoslijed isporuka. Koristite occurred_at i updated_at resursa umjesto vremena dolaska.
Pretplata koja stalno ne uspijeva gomila neisporučive poruke; više od 100 za jednu krajnju točku pokreće upozorenje na strani RolChata i prikazuje upozorenje u zapisniku dodatka.