Eseménykatalógus

A tartalom formátuma

Minden esemény egyetlen JSON-objektum:

{
  "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 … }
}

Az id az X-RolChat-Event-Id fejlécben szereplő érték, és az újrapróbálkozások során változatlan. A type formátuma <domain>.<noun>.<verb> vagy <domain>.<verb>, snake_case írásmóddal. A data az erőforrást ugyanúgy tartalmazza, ahogy a megfelelő GET végpont visszaadná, így a fogadó az API-referencia alapján megírható, és soha nincs szükség második sémára.

Eseménycsaládok

Család	Példák	Mikor jön létre
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Egy beszélgetés állapota vagy felelőse megváltozik
message.*	message.created, message.delivered, message.read, message.failed	Üzenet kerül közzétételre, vagy megváltozik a kézbesítési állapota
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Egy érdeklődő, kapcsolat, cég vagy ügylet megváltozik
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Egy jegy megváltozik
visitor.*	visitor.identified, visitor.cobrowse.requested	Egy látogatót azonosítanak, vagy közös böngészést kér
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Űrlapok, foglalások, kampányok
kb.*	kb.article.published, kb.article.unpublished	A tudásbázis változásai
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Hívások és hangposta
automation.*	automation.rule.executed, automation.rule.failed	Egy automatizálási szabály lefut
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Hozzájárulás és érintetti kérelmek
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Előfizetés és számlák
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Biztonsági szempontból fontos fiókesemények
ai.*	ai.usage.recorded	Minden AI-adapterhívás, tokenszámokkal

A pontos lista a termékkel együtt bővül; a feliratkozási képernyő megmutat minden típust, amelyet a fiókod fogadhat, és típusonként szűrhetsz.

Feliratkozás

A webhook-feliratkozások egy pluginhez tartoznak. A Beállítások → Pluginek menüben nyisd meg a plugint (vagy hozz létre egy egyénit), és adj hozzá egy végpontot: HTTPS URL, a kívánt eseménytípusok és egy opcionális IP-engedélyezési lista. Az aláíró titkos kulcs egyszer jelenik meg. Az adott végpont kézbesítései, újrapróbálkozásai és kézbesíthetetlen üzenetei a plugin Webhooknaplójában jelennek meg.

A Pluginek oldalon található Plugin Protocol leírja, hogyan adja meg egy plugin a manifestjében a szükséges eseményeket.

Sorrend és kézbesítés

• A kézbesítés legalább egyszeri. Szűrd a duplikátumokat az id alapján.
• Egy erőforrás eseményei sorrendben kerülnek kiküldésre, de az újrapróbálkozások felcserélhetik a kézbesítések sorrendjét. Az érkezési idő helyett az occurred_at és az erőforrás updated_at értékét használd.
• A folyamatosan hibázó feliratkozásnál felhalmozódnak a kézbesíthetetlen üzenetek; ha egy végpontnál 100-nál több gyűlik össze, a RolChat oldalán riasztás indul, és figyelmeztetés jelenik meg a plugin naplójában.