Hadisələr kataloqu

Payload strukturu

Hər hadisə bir JSON obyektidir:

{
  "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 başlığındakı dəyərdir və təkrar cəhdlərdə dəyişmir. type snake_case formatında <domain>.<noun>.<verb> və ya <domain>.<verb> olur. data resursu müvafiq GET endpoint-inin qaytaracağı formada daşıyır, belə ki, qəbuledici API istinadına əsasən yazıla bilər və heç vaxt ikinci sxemə ehtiyac duymur.

Hadisə ailələri

Ailə	Nümunələr	Nə vaxt göndərilir
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Söhbətin vəziyyəti və ya məsul şəxsi dəyişəndə
message.*	message.created, message.delivered, message.read, message.failed	Mesaj göndəriləndə və ya onun çatdırılma statusu dəyişəndə
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Lead, kontakt, şirkət və ya sövdələşmə dəyişəndə
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Tiket dəyişəndə
visitor.*	visitor.identified, visitor.cobrowse.requested	Ziyarətçi tanınanda və ya birgə baxış sessiyası istəyəndə
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Formalar, bronlar, kampaniyalar
kb.*	kb.article.published, kb.article.unpublished	Bilik bazasında dəyişikliklər
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Zənglər və səsli poçt
automation.*	automation.rule.executed, automation.rule.failed	Avtomatlaşdırma qaydası icra olunanda
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Razılıq və məlumat subyektlərinin sorğuları
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Abunəlik və fakturalar
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Təhlükəsizliklə bağlı hesab hadisələri
ai.*	ai.usage.recorded	Token sayları ilə hər AI adapteri çağırışı

Dəqiq siyahı məhsulla birlikdə böyüyür; abunəlik ekranı hesabınızın ala biləcəyi hər növü göstərir və növ üzrə filtrləməyə imkan verir.

Abunə olmaq

Webhook abunəlikləri plaginə aiddir. Parametrlər → Plaginlər bölməsində plagini açın (və ya xüsusi plagin yaradın) və endpoint əlavə edin: HTTPS URL, istədiyiniz hadisə növləri və istəyə bağlı IP icazə siyahısı. İmzalama açarı bir dəfə göstərilir. Həmin endpoint üçün çatdırılmalar, təkrar cəhdlər və dead letter-lər plaginin Webhook jurnalında görünür.

Plaginlər səhifəsindəki Plugin Protocol plaginin ehtiyac duyduğu hadisələri manifestində necə elan etdiyini təsvir edir.

Ardıcıllıq və çatdırılma

• Çatdırılma ən azı bir dəfə həyata keçirilir. id üzrə dublikatları aradan qaldırın.
• Bir resursun hadisələri ardıcıl göndərilir, lakin təkrar cəhdlər çatdırılmaların sırasını dəyişə bilər. Gəliş vaxtı əvəzinə occurred_at və resursun updated_at dəyərindən istifadə edin.
• Davamlı uğursuz olan abunəlik dead letter-lər toplayır; bir endpoint üçün 100-dən çox olması RolChat tərəfində xəbərdarlıq yaradır və plaginin jurnalında ikaz göstərir.