- Webhook एंडपॉइंट्स को
telephony.complete(फोन कॉल) याweb.complete(वेब कॉल और बिल्डर माइक टेस्ट कॉल) नीचे डॉक्यूमेंट किए गए स्थिर पेलोड के साथ, प्रत्येक डिलीवरी के लिए एकevent_id, 30 सेकंड का टाइमआउट, और 24 घंटे तक रिट्राइज़ प्राप्त होते हैं। - लीगेसी सिंगल-URL वेबहुक को थोड़ा अलग पेलोड के साथ एक सिंक्रोनस प्रयास (10 सेकंड टाइमआउट, कोई रिट्राइज़ नहीं) मिलता है — देखें लीगेसी पेलोड अंतर।
अनुरोध पेलोड (एंडपॉइंट डिलीवरी)
समाप्ति के कारण
ट्रांसक्रिप्ट फ़ॉर्मेट
transcripts में हर एंट्री एक बातचीत का टर्न है। रोल हैं
user (कॉलर की आवाज़), model (एजेंट की आवाज़ और टूल कॉल),
tool (टूल के परिणाम), और system (भाषा स्विच जैसे कॉल इवेंट)।
पूर्ण रूप से स्ट्रक्चर्ड टर्न हिस्ट्री (इंटरप्शन मार्कर,
ack-prompts और रॉ पोज़िशन सहित) के लिए
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जोड़ा जाता है। - Builder माइक टेस्ट कॉल लेगसी पाथ पर
telephony.completeके रूप में रिपोर्ट होती हैं (एंडपॉइंट सिस्टम उन्हेंweb.completeपर मैप करता है)। - ट्रांसफ़र कोऑर्डिनेशन: जब कोई कॉल ट्रांसफ़र में समाप्त होती है, लेगसी वेबहुक को सिंक्रोनस रूप से कॉल किया जाता है और हैंडऑफ़ टारगेट तैयार न होने का संकेत देने के लिए वह
{"transfer_ready": false}का जवाब दे सकता है। कोई भी अन्य रिस्पॉन्स (या कोई लेगसी वेबहुक न होना) ट्रांसफ़र को आगे बढ़ने देता है। इसके लिए एंडपॉइंट डिलीवरी से कभी परामर्श नहीं लिया जाता।
उदाहरण हैंडलर
सामान्य उपयोग के मामले
CRM इंटीग्रेशन
प्रत्येक कॉल का ट्रांसक्रिप्ट + रिकॉर्डिंग URL अपने ग्राहक रिकॉर्ड्स के साथ सेव करें।
एनालिटिक्स
टॉपिक मॉडलिंग, CSAT सिग्नल एक्सट्रैक्शन या ट्रांसफर-रेट मॉनिटरिंग के लिए ट्रांसक्रिप्ट्स को पाइपलाइन में स्ट्रीम करें।
क्वालिटी रिव्यू
ह्यूमन रिव्यू के लिए कॉल्स को QA टूल में खोलें, या उन्हें अपने मूल्यांकन मॉडल से चलाएं।
नोटिफिकेशन
ट्रांसफर / फेल्योर पर किसी ह्यूमन टीममेट को ट्रिगर करें।
संबंधित
telephony.incoming / web.incoming
कॉल शुरू होने पर चलने वाला ब्लॉकिंग समकक्ष।
इवेंट्स कैटलॉग
अन्य इवेंट टाइप्स जिन्हें आप सब्सक्राइब कर सकते हैं।
कॉल हिस्ट्री API
बैकफिल / रीप्ले के लिए REST के माध्यम से वही डेटा उपलब्ध है।