इवेंट कैटलॉग

पेलोड संरचना

हर इवेंट एक 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 snake_case में <domain>.<noun>.<verb> या <domain>.<verb> है। 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 की ओर अलर्ट उठता है और प्लगइन लॉग में चेतावनी दिखती है।