Händelsekatalog

Nyttolastens form

Varje händelse är ett 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 är värdet i headern X-RolChat-Event-Id och är stabilt mellan nya försök. type är <domain>.<noun>.<verb> eller <domain>.<verb> i snake_case. data innehåller resursen så som motsvarande GET-endpoint skulle returnera den, så en mottagare kan skrivas utifrån API-referensen och behöver aldrig ett andra schema.

Händelsefamiljer

Familj	Exempel	Skickas när
`conversation.*`	`conversation.created`, `conversation.assigned`, `conversation.resolved`, `conversation.reopened`, `conversation.merged`	En konversation byter tillstånd eller ägare
`message.*`	`message.created`, `message.delivered`, `message.read`, `message.failed`	Ett meddelande publiceras eller dess leveransstatus ändras
`crm.*`	`crm.lead.created`, `crm.contact.created`, `crm.contact.updated`, `crm.contact.merged`, `crm.deal.stage_changed`, `crm.deal.won`	Ett lead, en kontakt, ett företag eller en affär ändras
`ticket.*`	`ticket.created`, `ticket.status_changed`, `ticket.assigned`, `ticket.sla_breached`	Ett ärende ändras
`visitor.*`	`visitor.identified`, `visitor.cobrowse.requested`	En besökare identifieras eller ber om en samsurfningssession
`marketing.*`	`marketing.form.submitted`, `marketing.booking.created`, `marketing.campaign.sent`, `marketing.unsubscribed`	Formulär, bokningar, kampanjer
`kb.*`	`kb.article.published`, `kb.article.unpublished`	Ändringar i kunskapsbasen
`phone.*`	`phone.call.started`, `phone.call.ended`, `phone.call.recorded`, `phone.call.transcribed`, `phone.voicemail.received`	Samtal och röstbrevlåda
`automation.*`	`automation.rule.executed`, `automation.rule.failed`	En automatiseringsregel körs
`privacy.*`	`privacy.consent.granted`, `privacy.consent.withdrawn`, `privacy.dsr.received`	Samtycke och förfrågningar från registrerade
`billing.*`	`billing.invoice.created`, `billing.trial_expiring`, `billing.subscription.changed`	Prenumeration och fakturor
`auth.*`	`auth.api_key.created`, `auth.api_key.revoked`, `auth.account.swapped`	Säkerhetsrelevanta kontohändelser
`ai.*`	`ai.usage.recorded`	Varje anrop till en AI-adapter, med antal tokens

Den exakta listan växer med produkten; prenumerationsskärmen visar varje typ som ditt konto kan ta emot och låter dig filtrera per typ.

Prenumerera

Webhook-prenumerationer tillhör ett plugin. Under Inställningar → Plugins öppnar du pluginet (eller skapar ett anpassat) och lägger till en endpoint: HTTPS-URL, de händelsetyper du vill ha och en valfri tillåtelselista för IP-adresser. Signeringshemligheten visas en gång. Leveranser, nya försök och döda meddelanden för den endpointen visas i pluginets Webhook-logg.

Plugin Protocol på sidan Plugins beskriver hur ett plugin anger de händelser det behöver i sitt manifest.

Ordning och leverans

Leveransen sker minst en gång. Ta bort dubbletter utifrån id.
Händelser för en resurs skickas i ordning, men nya försök kan ändra ordningen på leveranserna. Använd occurred_at och resursens updated_at i stället för ankomsttiden.
En prenumeration som fortsätter att misslyckas samlar på sig döda meddelanden; fler än 100 för en endpoint utlöser ett larm hos RolChat och visar en varning i pluginets logg.