Olay kataloğu

Payload yapısı

Her olay tek bir JSON nesnesidir:

{
  "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ığındaki değerdir ve yeniden denemelerde değişmez. type, snake_case biçiminde <domain>.<noun>.<verb> veya <domain>.<verb> şeklindedir. data, kaynağı ilgili GET endpoint’inin döndüreceği biçimde taşır; böylece bir alıcı API referansına göre yazılabilir ve asla ikinci bir şemaya ihtiyaç duymaz.

Olay aileleri

Aile	Örnekler	Ne zaman gönderilir
conversation.*	conversation.created, conversation.assigned, conversation.resolved, conversation.reopened, conversation.merged	Bir konuşmanın durumu veya sahibi değiştiğinde
message.*	message.created, message.delivered, message.read, message.failed	Bir mesaj gönderildiğinde veya teslimat durumu değiştiğinde
crm.*	crm.lead.created, crm.contact.created, crm.contact.updated, crm.contact.merged, crm.deal.stage_changed, crm.deal.won	Bir potansiyel müşteri, kişi, şirket veya anlaşma değiştiğinde
ticket.*	ticket.created, ticket.status_changed, ticket.assigned, ticket.sla_breached	Bir destek talebi değiştiğinde
visitor.*	visitor.identified, visitor.cobrowse.requested	Bir ziyaretçi tanımlandığında veya ortak tarama oturumu istediğinde
marketing.*	marketing.form.submitted, marketing.booking.created, marketing.campaign.sent, marketing.unsubscribed	Formlar, rezervasyonlar, kampanyalar
kb.*	kb.article.published, kb.article.unpublished	Bilgi bankası değişiklikleri
phone.*	phone.call.started, phone.call.ended, phone.call.recorded, phone.call.transcribed, phone.voicemail.received	Aramalar ve sesli mesaj
automation.*	automation.rule.executed, automation.rule.failed	Bir otomasyon kuralı çalıştığında
privacy.*	privacy.consent.granted, privacy.consent.withdrawn, privacy.dsr.received	Onay ve veri sahibi talepleri
billing.*	billing.invoice.created, billing.trial_expiring, billing.subscription.changed	Abonelik ve faturalar
auth.*	auth.api_key.created, auth.api_key.revoked, auth.account.swapped	Güvenlikle ilgili hesap olayları
ai.*	ai.usage.recorded	Token sayılarıyla birlikte her yapay zeka adaptörü çağrısı

Tam liste ürünle birlikte büyür; abonelik ekranı hesabınızın alabileceği her türü gösterir ve türe göre filtrelemenizi sağlar.

Abone olma

Webhook abonelikleri bir eklentiye aittir. Ayarlar → Eklentiler bölümünde eklentiyi açın (veya özel bir tane oluşturun) ve bir endpoint ekleyin: HTTPS URL’si, istediğiniz olay türleri ve isteğe bağlı bir IP izin listesi. İmzalama anahtarı bir kez gösterilir. O endpoint’e ait teslimatlar, yeniden denemeler ve dead letter’lar eklentinin Webhook kaydında görünür.

Eklentiler sayfasındaki Plugin Protocol, bir eklentinin ihtiyaç duyduğu olayları manifest dosyasında nasıl bildirdiğini açıklar.

Sıralama ve teslimat

• Teslimat en az bir kez yapılır. id değerine göre tekilleştirin.
• Bir kaynağa ait olaylar sırayla gönderilir, ancak yeniden denemeler teslimatların sırasını değiştirebilir. Varış zamanı yerine occurred_at ve kaynağın updated_at değerini kullanın.
• Sürekli başarısız olan bir abonelik dead letter biriktirir; tek bir endpoint için 100’den fazlası RolChat tarafında bir uyarı tetikler ve eklentinin kaydında bir ikaz gösterir.