Gebeurteniskatalogus

Loonvragvorm

Elke gebeurtenis is een JSON-objek:

{
  "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 is die waarde in die X-RolChat-Event-Id-opskrif en is stabiel oor herprobasies heen. type is <domain>.<noun>.<verb> of <domain>.<verb> in snake_case. data dra die hulpbron soos die ooreenstemmende GET-eindpunt dit sou teruggee, sodat ’n ontvanger teen die API-verwysing geskryf kan word en nooit ’n tweede skema nodig het nie.

Gebeurtenisfamilies

Familie	Voorbeelde	Gestuur wanneer
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	’n Gesprek verander van toestand of eienaarskap
message.*	message.created, message.delivered, message.read, message.failed	’n Boodskap word geplaas of sy afleweringstatus verander
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	’n Lead, kontak, maatskappy of transaksie verander
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	’n Kaartjie verander
visitor.*	visitor.identified, visitor.cobrowse.requested	’n Besoeker word geïdentifiseer of vra vir ’n saamblaaisessie
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Vorms, besprekings, veldtogte
kb.*	kb.article.published, kb.article.unpublished	Kennisbasis-veranderinge
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Oproepe en stemboodskappe
automation.*	automation.rule.executed, automation.rule.failed	’n Outomatiseringsreël loop
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Toestemming en versoeke van datasubjekte
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Intekening en fakture
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Sekuriteitsrelevante rekeninggebeurtenisse
ai.*	ai.usage.recorded	Elke KI-adapteroproep, met tokentellings

Die presiese lys groei saam met die produk; die intekeningskerm wys elke tipe wat jou rekening kan ontvang en laat jou per tipe filtreer.

Inteken

Webhook-intekeninge behoort aan ’n inprop. Maak in Instellings → Inproppe die inprop oop (of skep ’n pasgemaakte een) en voeg ’n eindpunt by: HTTPS-URL, die gebeurtenistipes wat jy wil hê, en ’n opsionele IP-toelaatlys. Die ondertekeningsgeheim word een keer gewys. Aflewerings, herprobasies en dooie briewe vir daardie eindpunt verskyn in die inprop se Webhook-log.

Die Plugin Protocol op die bladsy Inproppe beskryf hoe ’n inprop die gebeurtenisse wat dit nodig het, in sy manifes verklaar.

Volgorde en aflewering

• Aflewering is ten minste een keer. Ontdubbel volgens id.
• Gebeurtenisse vir een hulpbron word in volgorde gestuur, maar herprobasies kan aflewerings herorden. Gebruik occurred_at en die hulpbron se updated_at eerder as die aankomstyd.
• ’n Intekening wat aanhou misluk, versamel dooie briewe; meer as 100 vir een eindpunt veroorsaak ’n waarskuwing aan RolChat se kant en wys ’n waarskuwing in die inprop se log.