Skip to main content
जब एक इनबाउंड फ़ोन कॉल बिना असाइन किए गए एजेंट वाले नंबर पर पहुँचती है, या mode="webhook" में किसी पब्लिशेबल की पर वेब विजेट सेशन शुरू होता है, तो ThunderPhone आपके लीगेसी वेबहुक URL को एक ब्लॉकिंग telephony.incoming / web.incoming रिक्वेस्ट भेजता है और कॉन्फ़िगरेशन रिस्पॉन्स के लिए अधिकतम 10 सेकंड तक प्रतीक्षा करता है। हर कॉल के लिए प्रॉम्प्ट, वॉइस और टूल्स को डायनामिक रूप से चुनने के लिए इस एक्सचेंज का उपयोग करें — एंड-टू-एंड पैटर्न के लिए डायनामिक कॉल कॉन्फ़िगरेशन गाइड देखें।
सब्सक्राइब किए गए वेबहुक एंडपॉइंट्स को भी telephony.incoming / web.incoming मिलते हैं — हर इनबाउंड कॉल और वेब सेशन के लिए, चाहे एजेंट कॉन्फ़िगर हो या नहीं — लेकिन ये डिलीवरी event_id के साथ फायर-एंड-फॉरगेट नोटिफ़िकेशन होते हैं, कभी ब्लॉकिंग नहीं। केवल लीगेसी सिंगल-URL वेबहुक में इस पेज का कॉन्फ़िगरेशन एक्सचेंज होता है। एंडपॉइंट नोटिफ़िकेशन के स्वरूप इवेंट्स कैटलॉग में हैं।
ब्लॉकिंग एक्सचेंज का कोई फ़ॉलबैक नहीं है: यदि आपका हैंडलर non-2xx स्टेटस लौटाता है, टाइम आउट होता है, या वैलिडेशन में विफल होने वाला कॉन्फ़िगरेशन लौटाता है, तो कॉल अस्वीकार कर दी जाती है (फ़ोन कॉल कनेक्ट नहीं होती; विजेट सेशन रिक्वेस्ट 502/422 के साथ विफल होती है)। तेज़ी से जवाब दें — जब आप निर्णय लेते हैं, तब कॉलर को रिंगबैक सुनाई दे रहा होता है।

रिक्वेस्ट पेलोड

फ़ोन कॉल्स (telephony.incoming) के लिए:
वेब विजेट सेशंस (web.incoming) के लिए, data फ़ोन नंबरों के बजाय एम्बेडिंग पेज की पहचान करता है:
वेबहुक-मोड विजेट्स, सेट होने पर, इस रिक्वेस्ट को पब्लिशेबल की के अपने webhook_url पर डिलीवर करते हैं और अन्यथा संगठन-स्तरीय वेबहुक URL पर फ़ॉलबैक करते हैं। दोनों ही स्थितियों में यह संगठन वेबहुक secret से साइन किया जाता है।

रिस्पॉन्स स्कीमा

इस कॉल के लिए एजेंट कॉन्फ़िगरेशन का वर्णन करने वाला JSON ऑब्जेक्ट लौटाएँ। prompt और voice आवश्यक हैं; बाकी सभी वैकल्पिक हैं।
अज्ञात टॉप-लेवल कीज़ को चुपचाप अनदेखा कर दिया जाता है — गलत टाइप किया गया फ़ील्ड नाम कॉन्फ़िग को अस्वीकार नहीं करता, बस लागू नहीं होता। स्पीक-ऑर्डर और max_hold_seconds यहाँ स्वीकार नहीं किए जाते; इन्हें केवल Agent पर ही कॉन्फ़िगर किया जा सकता है।
क्योंकि prompt और voice आवश्यक हैं, {} या ऐसा कोई भी रिस्पॉन्स जो वेलिडेशन में विफल होता है, 422 के साथ कॉल अस्वीकार कर देता है — इस पाथ पर कोई स्टैटिक-एजेंट फ़ॉलबैक नहीं है (वेबहुक मोड में किसी नंबर या की को कोई एजेंट असाइन नहीं होता)।

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


फंक्शन टूल्स के साथ रिस्पॉन्स

टूल्स अटैच करें ताकि AI बातचीत के दौरान आपके API को कॉल कर सके:
टूल-एंडपॉइंट रिक्वेस्ट पर उसी संगठन वेबहुक सीक्रेट से साइन किए जाते हैं, जिससे इस एक्सचेंज पर साइन किया गया था। सटीक संरचना और साइन किए गए रिक्वेस्ट फ़ॉर्मैट के लिए फंक्शन टूल्स देखें।

प्रोडक्ट टियर चीट शीट


संबंधित

telephony.complete / web.complete

कॉल समाप्ति का नॉन-ब्लॉकिंग इवेंट।

फंक्शन टूल्स

tools[] और साइन किए गए एंडपॉइंट कॉन्ट्रैक्ट के लिए पूर्ण JSON स्कीमा।

वेबहुक एंडपॉइंट्स

telephony.incoming / web.incoming के लिए कई URLs सब्सक्राइब करें।

डायनेमिक कॉल कॉन्फ़िगरेशन

प्रति-कॉलर प्रॉम्प्ट्स, टूल्स और A/B टेस्ट के पैटर्न।