Skip to main content
हर कॉल समाप्त होने के बाद एक कंप्लीशन इवेंट ट्रिगर होता है — इनबाउंड टेलीफोनी, आउटबाउंड टेलीफोनी, वेब कॉल या टेस्ट कॉल (बिल्डर माइक सेशन)। यह नॉन-ब्लॉकिंग है: किसी भी 2xx के साथ रिस्पॉन्ड करें। इवेंट दोनों पाथ पर डिलीवर होता है:
  • Webhook एंडपॉइंट्स को telephony.complete (फोन कॉल) या web.complete (वेब कॉल और बिल्डर माइक टेस्ट कॉल) मिलता है, जिसमें नीचे डॉक्यूमेंट किया गया स्टेबल पेलोड, प्रत्येक डिलीवरी का event_id, 30 s टाइमआउट और 24 h तक रिट्राई शामिल होते हैं।
  • लेगसी सिंगल-URL वेबहुक को थोड़ा अलग पेलोड के साथ एक सिंक्रोनस प्रयास मिलता है (10 s टाइमआउट, कोई रिट्राई नहीं) — देखें लेगसी पेलोड अंतर

रिक्वेस्ट पेलोड (एंडपॉइंट डिलीवरी)

समाप्ति के कारण

ट्रांसक्रिप्ट फ़ॉर्मैट

transcripts में प्रत्येक एंट्री एक संवादात्मक टर्न है। भूमिकाएँ हैं user (कॉलर का भाषण), model (एजेंट का भाषण और टूल कॉल), tool (टूल परिणाम), और system (कॉल इवेंट, जैसे भाषा स्विच)।
पूरी तरह स्ट्रक्चर्ड टर्न हिस्ट्री (इंटरप्शन मार्कर, ack-प्रॉम्प्ट और रॉ पोज़िशन के साथ) के लिए, GET /v1/calls/{call_id}/history का उपयोग करें।

लेगेसी पेलोड अंतर

लेगेसी सिंगल-URL वेबहुक एनवेलप है {"type": "telephony.complete" | "web.complete", "data": {…}}, जिसमें कोई event_id नहीं होता, और इसका data एंडपॉइंट पेलोड से अलग होता है:
  • टर्न ऐरे transcripts नहीं, बल्कि history के अंतर्गत होता है (ऊपर जैसा ही टर्न स्कीमा)।
  • फ़ील्ड सेट रॉ एंड-ऑफ़-कॉल रिपोर्ट होता है और इसमें ऊपर दी गई टेबल से परे अतिरिक्त इंटरनल फ़ील्ड शामिल हो सकते हैं — अज्ञात फ़ील्ड को जानकारी के रूप में मानें।
  • वेब कॉल (direction: "web") from_number / to_number को छोड़ती हैं और origin_domain जोड़ती हैं।
  • बिल्डर माइक टेस्ट कॉल लेगेसी पाथ पर telephony.complete के रूप में रिपोर्ट होती हैं (एंडपॉइंट सिस्टम उन्हें web.complete पर मैप करता है)।
  • ट्रांसफर कोऑर्डिनेशन: जब कोई कॉल ट्रांसफर में समाप्त होती है, तो लेगेसी वेबहुक को सिंक्रोनस रूप से कॉल किया जाता है और हैंडऑफ टारगेट तैयार नहीं होने का संकेत देने के लिए वह {"transfer_ready": false} उत्तर दे सकता है। कोई अन्य उत्तर (या कोई लेगेसी वेबहुक न होना) ट्रांसफर को आगे बढ़ने देता है। इसके लिए एंडपॉइंट डिलीवरी से कभी परामर्श नहीं किया जाता।

उदाहरण हैंडलर


सामान्य उपयोग के मामले

CRM इंटीग्रेशन

प्रत्येक कॉल की ट्रांसक्रिप्ट और रिकॉर्डिंग URL को आपके ग्राहक रिकॉर्ड के साथ सेव करें।

एनालिटिक्स

टॉपिक मॉडलिंग, CSAT सिग्नल एक्सट्रैक्शन या ट्रांसफर-रेट मॉनिटरिंग के लिए ट्रांसक्रिप्ट को पाइपलाइन में स्ट्रीम करें।

क्वालिटी रिव्यू

मानव रिव्यू के लिए कॉल को QA टूल में खोलें, या उन्हें अपने मूल्यांकन मॉडल से चलाएं।

नोटिफिकेशन

ट्रांसफर / विफलता पर मानव टीममेट को ट्रिगर करें।

संबंधित

telephony.incoming / web.incoming

कॉल शुरू होने पर चलने वाला ब्लॉकिंग समकक्ष।

इवेंट्स कैटलॉग

अन्य इवेंट प्रकार जिन्हें आप सब्सक्राइब कर सकते हैं।

कॉल हिस्ट्री API

बैकफिल / रीप्ले के लिए REST के माध्यम से उपलब्ध वही डेटा।