---
title: "SMS कॉलबैक URL"
description: "किसी SMS संदेश के इवेंट, या किसी मैसेजिंग प्रोफ़ाइल के जवाब, अपने HTTPS URL पर भेजें। इसमें रूटिंग, हस्ताक्षर की जाँच, फिर से प्रयास और विफल डिलीवरी का रीप्ले शामिल हैं।"
canonical: "https://bird.com/hi-in/dastavez/guides/sms/callbacks"
---

# SMS कॉलबैक URL

कॉलबैक URL आपके वेबहुक एंडपॉइंट की जगह किसी एक SMS संदेश के, या किसी मैसेजिंग प्रोफ़ाइल के हर संदेश के इवेंट प्राप्त करता है। इसका उपयोग तब करें जब किसी संदेश या प्रोग्राम को अपना अलग प्राप्तकर्ता चाहिए।

साइनिंग सीक्रेट, प्रयासों का इतिहास और रीप्ले आप डैशबोर्ड में, या [API](/docs/api/reference/rotate-webhook-callback-signing-secret) और `bird webhooks callbacks` कमांड के ज़रिए प्रबंधित करें। प्रोफ़ाइल का URL आप [मैसेजिंग प्रोफ़ाइल बनाते समय](/docs/api/reference/create-sms-messaging-profile) या [उसे अपडेट करते समय](/docs/api/reference/update-sms-messaging-profile) सेट करें।

## चुनें कि इवेंट कहाँ जाएँ

संदेश स्वीकार होते समय 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 इवेंट](/docs/guides/sms/events) होते हैं।

## हस्ताक्षर सत्यापित करें

कॉलबैक वेबहुक एंडपॉइंट जैसे ही [Standard Webhooks](/docs/guides/webhooks#verify-signatures) हेडर और HMAC-SHA256 हस्ताक्षर का उपयोग करते हैं, इसलिए आपका मौजूदा सत्यापन कोड बिना बदलाव के काम करता है। कुंजी आपके वर्कस्पेस का कॉलबैक साइनिंग सीक्रेट है। यह एक ही सीक्रेट सभी कॉलबैक URL और सभी वॉइस सीक्वेंस वेबहुक अनुरोध साझा करते हैं, इसलिए रोटेशन दोनों पर लागू होता है।

पहला सीक्रेट कभी नहीं दिखाया जाता। उपयोग करने लायक सीक्रेट पाने के लिए डैशबोर्ड में **Webhooks → Direct callbacks** के अंतर्गत या [कॉलबैक साइनिंग सीक्रेट रोटेट करें](/docs/api/reference/rotate-webhook-callback-signing-secret) के ज़रिए उसे रोटेट करें। नया सीक्रेट केवल एक बार दिखता है, इसलिए पेज छोड़ने से पहले उसे सहेज लें। अगले 24 घंटों तक हर कॉलबैक पर पुराने और नए, दोनों सीक्रेट से हस्ताक्षर किया जाता है, ताकि आप डिलीवरी खोए बिना नया सीक्रेट डिप्लॉय कर सकें। एक वर्कस्पेस में एक साथ अधिकतम 5 मान्य सीक्रेट हो सकते हैं, इसलिए इस अवधि के भीतर फिर से रोटेट करने का अनुरोध अस्वीकार हो सकता है। रोटेशन लगभग एक मिनट के भीतर लागू हो जाता है।

सत्यापन पर निर्भर होने से पहले सीक्रेट रोटेट करें: जब तक आप ऐसा नहीं करते, कॉलबैक पर ऐसे सीक्रेट से बना हस्ताक्षर होता है जिसे आप पढ़ नहीं सकते।

## फिर से प्रयास और डुप्लिकेट

कॉलबैक [वेबहुक एंडपॉइंट के फिर से प्रयास के शेड्यूल](/docs/guides/webhooks#delivery-semantics) का पालन करते हैं: लगभग 27.5 घंटों में आठ प्रयास, और 15 सेकंड के भीतर मिला `2xx` सफलता माना जाता है। एंडपॉइंट के विपरीत, कॉलबैक URL कभी रोका नहीं जाता।

डिलीवरी कम से कम एक बार होती है और क्रम में नहीं होती। `webhook-id` हेडर के आधार पर डुप्लिकेट हटाएँ, और पेलोड के अंदर मौजूद `timestamp` के आधार पर क्रम लगाएँ।

## विफल कॉलबैक ढूँढें और रीप्ले करें

डैशबोर्ड में **Webhooks** के अंतर्गत **Direct callbacks** टैब और [कॉलबैक डिलीवरी प्रयासों की सूची](/docs/api/reference/list-webhook-callback-attempts) वर्कस्पेस के कॉलबैक प्रयासों को सबसे नए से शुरू करके दिखाते हैं, साथ में URL, आपके प्राप्तकर्ता द्वारा लौटाया गया स्टेटस और विलंब। प्रयास तीन दिन तक रखे जाते हैं।

[विफल कॉलबैक डिलीवरी का रीप्ले](/docs/api/reference/create-webhook-callback-replay) आपके चुने गए समय-अंतराल में जिन इवेंट के कॉलबैक विफल हुए, उनमें से हर एक के लिए एक और प्रयास कतार में जोड़ता है, ठीक वैसे ही जैसे [एंडपॉइंट डिलीवरी का रीप्ले](/docs/guides/webhooks#replaying-failed-deliveries) एंडपॉइंट के लिए करता है। जो इवेंट उसी अंतराल में सफलतापूर्वक भी डिलीवर हुआ, उसे छोड़ दिया जाता है। अंतराल के बाहर की सफलता नहीं गिनी जाती, इसलिए वह इवेंट फिर से भेजा जाता है। एक रीप्ले अंतराल के अधिकतम 10,000 सबसे पुराने विफल इवेंट भेजता है; लंबी रुकावट के बाद बाकी इवेंट के लिए बाद के प्रारंभ समय के साथ फिर से रीप्ले करें।

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

## अगले कदम

- [SMS इवेंट](/docs/guides/sms/events): हर इवेंट का पेलोड
- [वेबहुक और इवेंट](/docs/guides/webhooks): हस्ताक्षर, फिर से प्रयास और रीप्ले का पूरा विवरण
- [SMS भेजना](/docs/guides/sms/sending-sms): भेजने का अनुरोध

## Related resources

- [Sending your first SMS](/learn/sms/sending-your-first-sms) (video)
- [What does SMS mean?](/explained/sms/what-does-sms-mean) (answer)
- [SMS](/sms-api) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=sms)
