पोस्ट-कॉल वेबहुक
कॉल समाप्त होने और विश्लेषण पूरा होने पर वेबहुक के ज़रिए सूचना पाएं।
ओवरव्यू
पोस्ट-कॉल Webhooks आपको विश्लेषण पूरा होने के बाद कॉल की विस्तृत जानकारी पाने देते हैं। सक्षम होने पर, ElevenLabs व्यापक कॉल डेटा के साथ आपके तय किए गए एंडपॉइंट पर POST अनुरोध भेजेगा।
ElevenLabs तीन प्रकार के पोस्ट-कॉल वेबहुक का समर्थन करता है:
- ट्रांसक्रिप्शन वेबहुक (
post_call_transcription): ट्रांसक्रिप्ट, विश्लेषण परिणाम और मेटाडेटा सहित पूरी बातचीत का डेटा शामिल होता है - ऑडियो वेबहुक (
post_call_audio): पूरी बातचीत के base64-एन्कोडेड ऑडियो के साथ न्यूनतम डेटा शामिल होता है - कॉल शुरू करने में विफलता वाले वेबहुक (
call_initiation_failure): विफलता के कारणों और मेटाडेटा सहित कॉल शुरू करने के विफल प्रयासों की जानकारी शामिल होती है
पोस्ट-कॉल वेबहुक सक्षम करना
पोस्ट-कॉल वेबहुक को ElevenAgents settings page के ज़रिए आपके वर्कस्पेस के सभी एजेंट के लिए सक्षम किया जा सकता है।

सफल माने जाने के लिए पोस्ट-कॉल वेबहुक को 200 स्टेटस कोड लौटाना होगा। बार-बार विफल होने वाले वेबहुक अपने-आप अक्षम हो जाते हैं, अगर लगातार 10 या अधिक विफलताएं हों और आखिरी सफल डिलीवरी 7 दिन से अधिक पहले हुई हो या कभी सफल डिलीवरी न हुई हो।
पोस्ट-कॉल वेबहुक विफल होने पर अपने-आप फिर से आजमाए जा सकते हैं। वेबहुक रिट्राई देखें।
ऑथेंटिकेशन
लिस्नर के लिए सभी इनकमिंग वेबहुक को वैलिडेट करना ज़रूरी है। वेबहुक फ़िलहाल HMAC सिग्नेचर के ज़रिए ऑथेंटिकेशन सपोर्ट करते हैं। HMAC ऑथेंटिकेशन सेट अप करने के लिए:
- वेबहुक बनाते समय जनरेट हुए शेयर किए गए सीक्रेट को सुरक्षित रूप से स्टोर करें
- SDK का इस्तेमाल करके अपने एंडपॉइंट में ElevenLabs-Signature हेडर को वेरिफ़ाई करें
JavaScript SDK में constructEvent और Python SDK में rawBody, sig_header, और secret के साथ construct_event उपलब्ध है (Python में इनके नाम payload / signature नहीं हैं)। दोनों सिग्नेचर वेरिफ़ाई करते हैं, टाइमस्टैम्प वैलिडेट करते हैं और JSON पेलोड पार्स करते हैं।
Python
JavaScript
FastAPI का इस्तेमाल करने वाले वेबहुक हैंडलर का उदाहरण:
कस्टम रिक्वेस्ट हेडर
HMAC सिग्नेचर वैलिडेशन के अलावा, आप हर वेबहुक डिलीवरी के साथ कस्टम हेडर शामिल कर सकते हैं। यह API कुंजी, बेयरर टोकन या अन्य ऑथेंटिकेशन हेडर पास करने के लिए उपयोगी है, जिनकी आपके रिसीविंग एंडपॉइंट को ज़रूरत होती है।
डैशबोर्ड
CLI
SDK
कस्टम हेडर अभी ElevenAgents डैशबोर्ड के ज़रिए कॉन्फ़िगर नहीं किए जा सकते। कस्टम हेडर सेट करने के लिए SDK या API का उपयोग करें।
कस्टम हेडर HMAC ऑथेंटिकेशन के साथ काम करते हैं। auth_type को फिर भी hmac पर सेट करना होगा, और कस्टम हेडर ElevenLabs-Signature हेडर के अतिरिक्त भेजे जाते हैं।
कस्टम हेडर केवल लिखने के लिए हैं। list webhooks endpoint अपने रिस्पॉन्स में request_headers नहीं लौटाता, इसलिए आप वेबहुक के लिए कॉन्फ़िगर किए गए हेडर दोबारा नहीं पढ़ सकते।
IP अलाउलिस्टिंग
अतिरिक्त सुरक्षा के लिए, आप ElevenLabs के स्टैटिक इग्रेस IP को अपनी अलाउलिस्ट में जोड़ सकते हैं। IP पतों की पूरी सूची के लिए IP अलाउलिस्टिंग देखें।
HMAC सिग्नेचर वैलिडेशन के साथ IP अलाउलिस्टिंग का उपयोग करने से सुरक्षा की कई परतें मिलती हैं।
प्रति-एजेंट वेबहुक ओवरराइड
डिफ़ॉल्ट रूप से, आपके वर्कस्पेस के सभी एजेंट आपकी वर्कस्पेस सेटिंग्स में कॉन्फ़िगर किए गए वेबहुक का उपयोग करते हैं। अलग-अलग एजेंट के लिए पोस्ट-कॉल डेटा अलग एंडपॉइंट पर भेजने हेतु आप इसे हर एजेंट के लिए ओवरराइड कर सकते हैं।
डैशबोर्ड
CLI
SDK
post_call_webhook_id को ऐसे वेबहुक का संदर्भ देना चाहिए जो आपके वर्कस्पेस में पहले से मौजूद हो। आप events ऐरे का उपयोग करके यह भी तय कर सकते हैं कि कौन से इवेंट टाइप भेजने हैं:
वेबहुक रिस्पॉन्स स्ट्रक्चर
ElevenLabs तीन अलग प्रकार के पोस्ट-कॉल वेबहुक भेजता है, और हर एक का डेटा स्ट्रक्चर अलग होता है:
ट्रांसक्रिप्शन वेबहुक (post_call_transcription)
पूरे ट्रांसक्रिप्ट, विश्लेषण परिणाम और मेटाडेटा सहित व्यापक बातचीत डेटा शामिल होता है।
टॉप-लेवल फ़ील्ड
डेटा ऑब्जेक्ट स्ट्रक्चर
data ऑब्जेक्ट में ये शामिल हैं:
conversation_initiation_client_data.dynamic_variables वेरिएबल नामों को लिस्ट और ऑब्जेक्ट सहित किसी भी JSON वैल्यू से मैप करता है। इसमें बिल्ट-इन system__ वेरिएबल शामिल हैं और नए वेरिएबल जोड़े जा सकते हैं, इसलिए जिन कुंजियों या वैल्यू टाइप को आप नहीं पहचानते उन्हें अस्वीकार न करें। डायनामिक वेरिएबल देखें।
ऑडियो वेबहुक (post_call_audio)
base64-एन्कोडेड MP3 के रूप में पूरी बातचीत के ऑडियो के साथ न्यूनतम डेटा शामिल होता है।
टॉप-लेवल फ़ील्ड
डेटा ऑब्जेक्ट स्ट्रक्चर
data ऑब्जेक्ट में केवल ये शामिल हैं:
ऑडियो वेबहुक में केवल ऊपर सूचीबद्ध फ़ील्ड होते हैं। इनमें ट्रांसक्रिप्ट डेटा, मेटाडेटा, विश्लेषण परिणाम या बातचीत के अन्य विवरण शामिल नहीं होते।
कॉल शुरू करने में विफलता वाले वेबहुक (call_initiation_failure)
विफलता के कारणों और टेलीफ़ोनी-प्रोवाइडर मेटाडेटा सहित टेलीफ़ोनी कॉल शुरू करने के प्रयासों की जानकारी शामिल होती है।
कनेक्शन त्रुटियों, यूज़र द्वारा कॉल अस्वीकार करने या यूज़र द्वारा कॉल न उठाने के कारण कॉल शुरू न होने पर कॉल शुरू करने में विफलता वाले वेबहुक इवेंट भेजे जाते हैं। अगर कॉल वॉइसमेल पर जाती है या किसी ऑटोमेटेड सर्विस द्वारा उठाई जाती है, तो कॉल शुरू करने में विफलता वाला वेबहुक नहीं भेजा जाता, क्योंकि कॉल सफलतापूर्वक शुरू हो गई थी।
टॉप-लेवल फ़ील्ड
डेटा ऑब्जेक्ट स्ट्रक्चर
data ऑब्जेक्ट में ये शामिल हैं:
Twilio के ज़रिए की गई आउटबाउंड कॉल के लिए, failure_reason Twilio CallStatus से लिया जाता है: busy और no-answer को ज्यों का त्यों पास किया जाता है, और failed को unknown के रूप में रिपोर्ट किया जाता है। Twilio के अन्य कॉल स्टेटस कॉल शुरू करने में विफलता वाला वेबहुक नहीं भेजते।
मेटाडेटा ऑब्जेक्ट स्ट्रक्चर
metadata ऑब्जेक्ट स्ट्रक्चर इस पर निर्भर करता है कि आउटबाउंड कॉल Twilio के ज़रिए की गई थी या SIP ट्रंकिंग के ज़रिए। ऑब्जेक्ट में type फ़ील्ड होता है जो दोनों में अंतर करता है, और प्रोवाइडर-विशिष्ट विवरण वाला body फ़ील्ड होता है।
SIP मेटाडेटा (type: "sip"):
SIP मेटाडेटा के लिए body ऑब्जेक्ट में ये शामिल हैं:
Twilio मेटाडेटा (type: "twilio"):
उदाहरण वेबहुक पेलोड
ट्रांसक्रिप्शन वेबहुक उदाहरण
ऑडियो वेबहुक उदाहरण
कॉल शुरू न हो पाने पर वेबहुक उदाहरण
Twilio मेटाडेटा उदाहरण
SIP मेटाडेटा उदाहरण
ऑडियो वेबहुक डिलीवरी
ऑडियो वेबहुक, ट्रांसक्रिप्शन वेबहुक से अलग भेजे जाते हैं और इनमें बातचीत की पहचान करने के लिए ज़रूरी फ़ील्ड के साथ सिर्फ़ base64-एन्कोड किया गया ऑडियो डेटा होता है।
ऑडियो वेबहुक को अपनी वेबहुक सेटिंग्स में “ऑडियो डेटा भेजें” टॉगल से चालू या बंद किया जा सकता है। यह सेटिंग वर्कस्पेस स्तर (ElevenAgents सेटिंग्स में) और एजेंट स्तर (अलग-अलग एजेंट वेबहुक ओवरराइड में) दोनों पर कॉन्फ़िगर की जा सकती है।
स्ट्रीमिंग डिलीवरी
बड़ी ऑडियो फ़ाइलों को कुशलता से संभालने के लिए, ऑडियो वेबहुक transfer-encoding: chunked हेडर के साथ स्ट्रीमिंग HTTP रिक्वेस्ट के रूप में भेजे जाते हैं। हर रिक्वेस्ट 5 मिनट बाद टाइम आउट हो जाती है।
फिर से कोशिशें
वेबहुक पर फिर से कोशिशें चालू होने पर, असफल ऑडियो डिलीवरी की फिर से कोशिश ट्रांसक्रिप्शन वेबहुक वाले ही शेड्यूल के अनुसार की जाती है। फिर से कोशिश करने पर पूरा ऑडियो पेलोड दोबारा भेजा जाता है, इसलिए conversation_id के आधार पर डुप्लिकेट हटाएं। शेड्यूल, दोबारा कोशिश योग्य एरर और ऑडियो साइज़ सीमाओं के लिए वेबहुक रीट्राई देखें।
ऑडियो वेबहुक प्रोसेस करना
ऑडियो वेबहुक चंक्ड ट्रांसफ़र एन्कोडिंग के ज़रिए भेजे जाते हैं, इसलिए आपको स्ट्रीमिंग डेटा को सही तरीके से संभालना होगा:
ऑडियो वेबहुक बड़ी फ़ाइलें हो सकती हैं, इसलिए सुनिश्चित करें कि आपका वेबहुक एंडपॉइंट स्ट्रीमिंग रिक्वेस्ट संभाल सकता है और उसमें पर्याप्त मेमोरी/स्टोरेज क्षमता है। ऑडियो MP3 फ़ॉर्मैट में भेजा जाता है।
उपयोग के मामले
ऑटोमेटेड कॉल फ़ॉलो-अप
पोस्ट-कॉल वेबहुक की मदद से आप ऐसे ऑटोमेटेड वर्कफ़्लो बना सकते हैं जो कॉल खत्म होते ही ट्रिगर हों। यहां कुछ व्यावहारिक उपयोग दिए गए हैं:
CRM इंटीग्रेशन
कॉल पूरी होते ही बातचीत के डेटा से अपने कस्टमर रिलेशनशिप मैनेजमेंट सिस्टम को अपडेट करें:
स्टेटफ़ुल बातचीत
स्टेट को स्टोर और रिट्रीव करके कई इंटरैक्शन में बातचीत का कॉन्टेक्स्ट बनाए रखें:
- कॉल शुरू होने पर, अपनी यूज़र आईडी को डायनामिक वेरिएबल के रूप में पास करें।
- कॉल खत्म होने पर, dynamic_variables से निकाली गई यूज़र आईडी के आधार पर अपने डेटाबेस में बातचीत का डेटा स्टोर करने के लिए अपना वेबहुक एंडपॉइंट सेट अप करें।
- जब यूज़र दोबारा कॉल करे, तो आप यह कॉन्टेक्स्ट रिट्रीव करके इसे नई बातचीत में
{{previous_topics}}डायनामिक वेरिएबल में पास कर सकते हैं। - इससे एक सहज अनुभव बनता है, जिसमें एजेंट पिछले इंटरैक्शन को “याद” रखता है