Katalog dogodkov

Oblika vsebine

Vsak dogodek je en 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 vrednost v glavi X-RolChat-Event-Id in se pri ponovnih poskusih ne spremeni. type ima obliko <domain>.<noun>.<verb> ali <domain>.<verb> v snake_case. data nosi vir v obliki, v kateri bi ga vrnila ustrezna končna točka GET, zato je prejemnika mogoče napisati po referenci API in nikoli ne potrebuje druge sheme.

Družine dogodkov

Družina	Primeri	Poslano, ko
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Pogovor spremeni stanje ali lastnika
message.*	message.created, message.delivered, message.read, message.failed	Sporočilo je objavljeno ali se spremeni stanje njegove dostave
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Spremeni se potencialna stranka, stik, podjetje ali posel
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Spremeni se zahtevek
visitor.*	visitor.identified, visitor.cobrowse.requested	Obiskovalec je prepoznan ali zahteva skupno brskanje
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Obrazci, rezervacije, kampanje
kb.*	kb.article.published, kb.article.unpublished	Spremembe v bazi znanja
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Klici in glasovna pošta
automation.*	automation.rule.executed, automation.rule.failed	Izvede se pravilo avtomatizacije
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Privolitve in zahteve posameznikov
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Naročnina in računi
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Varnostno pomembni dogodki računa
ai.*	ai.usage.recorded	Vsak klic adapterja AI, s številom žetonov

Natančen seznam raste z izdelkom; zaslon naročnine prikaže vsako vrsto, ki jo lahko prejema vaš račun, in omogoča filtriranje po vrsti.

Naročnina

Naročnine na webhooke pripadajo vtičniku. V Nastavitve → Vtičniki odprite vtičnik (ali ustvarite vtičnik po meri) in dodajte končno točko: URL HTTPS, želene vrste dogodkov in neobvezen seznam dovoljenih IP naslovov. Skrivnost za podpisovanje je prikazana samo enkrat. Dostave, ponovni poskusi in nedostavljiva sporočila za to končno točko se prikažejo v Dnevniku webhookov vtičnika.

Plugin Protocol na strani Vtičniki opisuje, kako vtičnik v svojem manifestu navede dogodke, ki jih potrebuje.

Vrstni red in dostava

• Dostava je vsaj enkrat. Dvojnike odstranite po id.
• Dogodki za en vir se pošiljajo po vrsti, vendar lahko ponovni poskusi spremenijo vrstni red dostav. Uporabite occurred_at in updated_at vira namesto časa prispetja.
• Naročnina, ki nenehno ne uspe, kopiči nedostavljiva sporočila; več kot 100 za eno končno točko sproži opozorilo na strani RolChat in prikaže opozorilo v dnevniku vtičnika.