SMS कॉलबैक URL
कॉलबैक URL आपके वेबहुक एंडपॉइंट की जगह किसी एक SMS संदेश के, या किसी मैसेजिंग प्रोफ़ाइल के हर संदेश के इवेंट प्राप्त करता है। इसका उपयोग तब करें जब किसी संदेश या प्रोग्राम को अपना अलग प्राप्तकर्ता चाहिए।
साइनिंग सीक्रेट, प्रयासों का इतिहास और रीप्ले आप डैशबोर्ड में, या API और bird webhooks callbacks कमांड के ज़रिए प्रबंधित करें। प्रोफ़ाइल का URL आप मैसेजिंग प्रोफ़ाइल बनाते समय या उसे अपडेट करते समय सेट करें।
चुनें कि इवेंट कहाँ जाएँ
संदेश स्वीकार होते समय URL एक बार तय किया जाता है और संदेश के पूरे जीवनकाल तक वही रहता है। बाद में प्रोफ़ाइल में किया गया बदलाव भेजे जा रहे संदेश का रास्ता नहीं बदलता।
| संदेश | उपयोग किया जाने वाला URL |
|---|---|
options.callback_url के साथ भेजा गया | वही URL |
options.callback_url को null पर सेट करके भेजा गया | कोई नहीं: इवेंट आपके वेबहुक एंडपॉइंट पर जाते हैं |
| इसके बिना, किसी मैसेजिंग प्रोफ़ाइल पर भेजा गया | प्रोफ़ाइल का options.callback_url |
| किसी मैसेजिंग प्रोफ़ाइल के नंबर पर प्राप्त | प्रोफ़ाइल का inbound.callback_url, फिर उसका options.callback_url |
| ऊपर दिए गए किसी भी स्रोत से कोई URL नहीं | कोई नहीं: इवेंट आपके वेबहुक एंडपॉइंट पर जाते हैं |
URL HTTPS होना चाहिए, उसमें अधिकतम 2,048 अक्षर होने चाहिए, और उसका पता सार्वजनिक होना चाहिए। निजी, लूपबैक या लिंक-लोकल होस्ट होने पर 422 लौटाया जाता है।
प्राप्त संदेश का इवेंट कहाँ डिलीवर हुआ, यह कॉलबैक प्रयासों की सूची में दिखता है।
URL किसकी जगह लेता है
जब तक कोई URL लागू रहता है, उस संदेश के इवेंट आपके वेबहुक एंडपॉइंट पर नहीं जाते। वर्कस्पेस के बाकी संदेशों के इवेंट उन तक पहुँचते रहते हैं। कॉलबैक विफल होने पर इवेंट आपके एंडपॉइंट पर वापस नहीं भेजे जाते: उसे पुनः प्राप्त करने के लिए रीप्ले का उपयोग करें।
MCP Events सब्सक्रिप्शन और कनेक्टर एंडपॉइंट को संदेश के इवेंट मिलते रहते हैं।
मैसेजिंग प्रोफ़ाइल के callback_events तय करते हैं कि कौन-से आउटबाउंड इवेंट URL पर जाएँ, और ये sms.accepted, sms.sent, sms.delivered, sms.undelivered, sms.failed, sms.rejected और sms.expired में से चुने जाते हैं। जो इवेंट सूची में नहीं है, वह उस संदेश के लिए किसी वेबहुक एंडपॉइंट तक भी नहीं पहुँचता। बिना सूची वाली प्रोफ़ाइल, और बिना प्रोफ़ाइल के भेजा गया संदेश, हर आउटबाउंड इवेंट भेजते हैं। sms.received को कभी फ़िल्टर नहीं किया जाता। पेलोड SMS इवेंट होते हैं।
हस्ताक्षर सत्यापित करें
कॉलबैक वेबहुक एंडपॉइंट जैसे ही Standard Webhooks हेडर और HMAC-SHA256 हस्ताक्षर का उपयोग करते हैं, इसलिए आपका मौजूदा सत्यापन कोड बिना बदलाव के काम करता है। कुंजी आपके वर्कस्पेस का कॉलबैक साइनिंग सीक्रेट है। यह एक ही सीक्रेट सभी कॉलबैक URL और सभी वॉइस सीक्वेंस वेबहुक अनुरोध साझा करते हैं, इसलिए रोटेशन दोनों पर लागू होता है।
पहला सीक्रेट कभी नहीं दिखाया जाता। उपयोग करने लायक सीक्रेट पाने के लिए डैशबोर्ड में Webhooks → Direct callbacks के अंतर्गत या कॉलबैक साइनिंग सीक्रेट रोटेट करें के ज़रिए उसे रोटेट करें। नया सीक्रेट केवल एक बार दिखता है, इसलिए पेज छोड़ने से पहले उसे सहेज लें। अगले 24 घंटों तक हर कॉलबैक पर पुराने और नए, दोनों सीक्रेट से हस्ताक्षर किया जाता है, ताकि आप डिलीवरी खोए बिना नया सीक्रेट डिप्लॉय कर सकें। एक वर्कस्पेस में एक साथ अधिकतम 5 मान्य सीक्रेट हो सकते हैं, इसलिए इस अवधि के भीतर फिर से रोटेट करने का अनुरोध अस्वीकार हो सकता है। रोटेशन लगभग एक मिनट के भीतर लागू हो जाता है।
सत्यापन पर निर्भर होने से पहले सीक्रेट रोटेट करें: जब तक आप ऐसा नहीं करते, कॉलबैक पर ऐसे सीक्रेट से बना हस्ताक्षर होता है जिसे आप पढ़ नहीं सकते।
फिर से प्रयास और डुप्लिकेट
कॉलबैक वेबहुक एंडपॉइंट के फिर से प्रयास के शेड्यूल का पालन करते हैं: लगभग 27.5 घंटों में आठ प्रयास, और 15 सेकंड के भीतर मिला 2xx सफलता माना जाता है। एंडपॉइंट के विपरीत, कॉलबैक URL कभी रोका नहीं जाता।
डिलीवरी कम से कम एक बार होती है और क्रम में नहीं होती। webhook-id हेडर के आधार पर डुप्लिकेट हटाएँ, और पेलोड के अंदर मौजूद timestamp के आधार पर क्रम लगाएँ।
विफल कॉलबैक ढूँढें और रीप्ले करें
डैशबोर्ड में Webhooks के अंतर्गत Direct callbacks टैब और कॉलबैक डिलीवरी प्रयासों की सूची वर्कस्पेस के कॉलबैक प्रयासों को सबसे नए से शुरू करके दिखाते हैं, साथ में URL, आपके प्राप्तकर्ता द्वारा लौटाया गया स्टेटस और विलंब। प्रयास तीन दिन तक रखे जाते हैं।
विफल कॉलबैक डिलीवरी का रीप्ले आपके चुने गए समय-अंतराल में जिन इवेंट के कॉलबैक विफल हुए, उनमें से हर एक के लिए एक और प्रयास कतार में जोड़ता है, ठीक वैसे ही जैसे एंडपॉइंट डिलीवरी का रीप्ले एंडपॉइंट के लिए करता है। जो इवेंट उसी अंतराल में सफलतापूर्वक भी डिलीवर हुआ, उसे छोड़ दिया जाता है। अंतराल के बाहर की सफलता नहीं गिनी जाती, इसलिए वह इवेंट फिर से भेजा जाता है। एक रीप्ले अंतराल के अधिकतम 10,000 सबसे पुराने विफल इवेंट भेजता है; लंबी रुकावट के बाद बाकी इवेंट के लिए बाद के प्रारंभ समय के साथ फिर से रीप्ले करें।
रीप्ले विफल प्रयासों पर दर्ज URL पर भेजता है, न कि आपके वेबहुक एंडपॉइंट पर और न ही प्रोफ़ाइल के मौजूदा URL पर। यह आपके प्राप्तकर्ता की रुकावट से उबरने में मदद करता है। यह गलत URL पर भेजे गए संदेश को ठीक नहीं कर सकता, इसलिए वह संदेश फिर से भेजें। रीप्ले उसी दैनिक सीमा में गिने जाते हैं जिसमें एंडपॉइंट रीप्ले गिने जाते हैं।
अगले कदम
- SMS इवेंट: हर इवेंट का पेलोड
- वेबहुक और इवेंट: हस्ताक्षर, फिर से प्रयास और रीप्ले का पूरा विवरण
- SMS भेजना: भेजने का अनुरोध
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।