Gå til indhold

Hændelseskatalog

Indholdets format

Sektion kaldt “Indholdets format”

Hver hændelse er ét 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 er værdien i headeren X-RolChat-Event-Id og er stabil på tværs af genforsøg. type er <domain>.<noun>.<verb> eller <domain>.<verb> i snake_case. data indeholder ressourcen, som det tilsvarende GET-endpoint ville returnere den, så en modtager kan skrives ud fra API-referencen og aldrig har brug for et ekstra skema.

Hændelsesfamilier

Sektion kaldt “Hændelsesfamilier”
Familie Eksempler Sendes når
conversation.* conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged En samtale skifter tilstand eller ejer
message.* message.created, message.delivered, message.read, message.failed En besked sendes, eller dens leveringsstatus ændres
crm.* crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won Et lead, en kontakt, en virksomhed eller en deal ændres
ticket.* ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached En ticket ændres
visitor.* visitor.identified, visitor.cobrowse.requested En besøgende identificeres eller beder om en cobrowse-session
marketing.* marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed Formularer, bookinger, kampagner
kb.* kb.article.published, kb.article.unpublished Ændringer i vidensbasen
phone.* phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received Opkald og talebeskeder
automation.* automation.rule.executed, automation.rule.failed En automatiseringsregel køres
privacy.* privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received Samtykke og anmodninger fra registrerede
billing.* billing.invoice.created, billing.trial_expiring, billing.subscription.changed Abonnement og fakturaer
auth.* auth.api_key.created, auth.api_key.revoked, auth.account.swapped Sikkerhedsrelevante kontohændelser
ai.* ai.usage.recorded Hvert kald til en AI-adapter med antal tokens

Den præcise liste vokser med produktet; abonnementsskærmen viser alle typer, din konto kan modtage, og lader dig filtrere pr. type.

Abonnement

Sektion kaldt “Abonnement”

Webhookabonnementer hører til et plugin. Under Indstillinger → Plugins åbner du pluginet (eller opretter et brugerdefineret) og tilføjer et endpoint: HTTPS-URL, de hændelsestyper, du ønsker, og en valgfri tilladelsesliste over IP-adresser. Signeringshemmeligheden vises én gang. Leveringer, genforsøg og døde beskeder for det endpoint vises i pluginets Webhooklog.

Plugin Protocol på siden Plugins beskriver, hvordan et plugin angiver de hændelser, det har brug for, i sit manifest.

Rækkefølge og levering

Sektion kaldt “Rækkefølge og levering”
  • Leveringen sker mindst én gang. Dedupliker efter id.
  • Hændelser for én ressource sendes i rækkefølge, men genforsøg kan ændre leveringernes rækkefølge. Brug occurred_at og ressourcens updated_at frem for ankomsttidspunktet.
  • Et abonnement, der bliver ved med at fejle, samler døde beskeder; mere end 100 for ét endpoint udløser en alarm hos RolChat og viser en advarsel i pluginets log.