Каталог на настани

Форма на содржината

Секој настан е еден 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 е вредноста во заглавието X-RolChat-Event-Id и е стабилна низ повторните обиди. type е <domain>.<noun>.<verb> или <domain>.<verb> во snake_case. data го носи ресурсот онака како што би го вратила соодветната крајна точка GET, па приемникот може да се напише според API референцата и никогаш не му треба втора шема.

Фамилии настани

Фамилија	Примери	Се испраќа кога
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Разговор ја менува состојбата или сопственикот
message.*	message.created, message.delivered, message.read, message.failed	Порака е објавена или се менува статусот на нејзината испорака
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Се менува лид, контакт, компанија или зделка
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Се менува тикет
visitor.*	visitor.identified, visitor.cobrowse.requested	Посетител е идентификуван или бара сесија за заедничко прелистување
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Формулари, резервации, кампањи
kb.*	kb.article.published, kb.article.unpublished	Промени во базата на знаење
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Повици и говорна пошта
automation.*	automation.rule.executed, automation.rule.failed	Се извршува правило за автоматизација
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Согласност и барања на субјекти на податоци
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Претплата и фактури
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Безбедносно релевантни настани на сметката
ai.*	ai.usage.recorded	Секој повик до AI адаптер, со број на токени

Точната листа расте заедно со производот; екранот за претплата го прикажува секој тип што вашата сметка може да го прима и овозможува филтрирање по тип.

Претплата

Претплатите на вебхукови припаѓаат на плагин. Во Поставки → Плагини отворете го плагинот (или креирајте сопствен) и додајте крајна точка: HTTPS URL, типовите настани што ги сакате и незадолжителна листа на дозволени IP-адреси. Тајната за потпишување се прикажува еднаш. Испораките, повторните обиди и неиспорачаните пораки за таа крајна точка се појавуваат во Дневник на вебхукови на плагинот.

Plugin Protocol на страницата Плагини опишува како плагинот ги декларира настаните што му се потребни во својот манифест.

Редослед и испорака

• Испораката е најмалку еднаш. Отстранувајте дупликати според id.
• Настаните за еден ресурс се испраќаат по ред, но повторните обиди можат да го променат редоследот на испораките. Користете occurred_at и updated_at на ресурсот наместо времето на пристигнување.
• Претплата што постојано не успева собира неиспорачани пораки; повеќе од 100 за една крајна точка креираат аларм кај RolChat и прикажуваат предупредување во дневникот на плагинот.