- 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 के माध्यम से उपलब्ध वही डेटा।
