SMS API क्या है, और यह SMS गेटवे से कैसे अलग है?

SMS API एक इंटरफ़ेस है जिसे आपका एप्लिकेशन कॉल करता है, जबकि SMS गेटवे एप्लिकेशन को मोबाइल नेटवर्क से जोड़ता है।

किसी नोटिफ़िकेशन सेवा को टेक्स्ट सबमिट करने का तरीका भी चाहिए और प्राप्तकर्ताओं के फ़ोन तक पहुँचने का रास्ता भी। इंटरफ़ेस चुनने से इस समस्या का केवल पहला हिस्सा हल होता है।

हर हिस्सा क्या करता है?

API प्रोग्राम से भेजे गए अनुरोध स्वीकार करता है। गेटवे आपके एप्लिकेशन और मोबाइल नेटवर्क के बीच पुल का काम करता है।

आपका एप्लिकेशन इंटरफ़ेस के ज़रिए प्राप्तकर्ता, प्रेषक और संदेश सबमिट करता है। गेटवे संदेशों को उन नेटवर्क सेवाओं तक आगे भेजता है जो उन्हें डिलीवर करती हैं। कोई प्रदाता दोनों हिस्से एक ही सेवा में दे सकता है।

SMPP गेटवे संदर्भ बताता है कि गेटवे एप्लिकेशन को मोबाइल संदेश केंद्रों से जोड़ते हैं। यह भी बताता है कि गेटवे कई इंटरफ़ेस देते हैं, जिनमें HTTP और SMPP शामिल हैं।

इंटरफ़ेस से हर डिलीवरी क्षमता तय नहीं होती। सुविधाजनक अनुरोध फ़ॉर्मैट किसी गंतव्य में असमर्थित प्रेषक को मान्य नहीं बना सकता।

मुझे कौन-सा इंटरफ़ेस चुनना चाहिए?

नए एप्लिकेशन के लिए HTTP चुनें, जब तक कि कोई मौजूदा SMPP इंटीग्रेशन या कनेक्शन की कोई खास ज़रूरत SMPP को संभालने का कारण न हो।

HTTP के साथ आपका एप्लिकेशन अनुरोध भेजता है और प्रतिक्रियाएँ प्रोसेस करता है। फिर भी उसे फिर से प्रयास, दोहरे भेजाव से सुरक्षा और डिलीवरी इवेंट संभालने की ज़रूरत रहती है।

SMPP ऐसे कनेक्शन का उपयोग करता है जो खुला रहता है। आपका क्लाइंट एक सेशन को प्रमाणित करता है और कनेक्शन टूटने, पावतियों और आने वाले ऑपरेशनों को संभालता है। SMPP इस काम को समझाता है।

मौजूदा SMPP सिस्टम होने पर यह इंटरफ़ेस व्यावहारिक विकल्प बन सकता है। यह मानने से पहले कि कोई दूसरा SMPP कनेक्शन बिल्कुल एक जैसा काम करेगा, प्रदाता के समर्थित ऑपरेशनों और सीमाओं का परीक्षण करें।

मुझे किन डिलीवरी क्षमताओं की तुलना करनी चाहिए?

अपने एप्लिकेशन की ज़रूरतों के हिसाब से गंतव्य कवरेज, अनुमत प्रेषकों, थ्रूपुट और उपयोगी विफलता रिपोर्टों की तुलना करें।

  • गंतव्य: जिन भी देशों में आप सेवा देते हैं, उन सभी के लिए समर्थन की पुष्टि करें, क्योंकि एक रूट के काम करने से यह तय नहीं होता कि दूसरा भी काम करेगा।
  • प्रेषक: प्राप्तकर्ताओं को दिखने वाली पहचान तय करने से पहले उसकी उपलब्धता और पंजीकरण जाँच लें।
  • थ्रूपुट: अनुरोध सीमाओं और उस दर में अंतर करें जिस पर डिलीवरी पाथ ट्रैफ़िक ले जा सकता है।
  • इवेंट: जाँचें कि आने वाले संदेश और डिलीवरी विफलताएँ आपके एप्लिकेशन तक कैसे पहुँचती हैं।

Bird के गंतव्य पेज देश-विशिष्ट आवश्यकताएँ प्रकाशित करते हैं। प्रेषक प्रकार पहचान के विकल्पों को समझाता है।

डिलीवरी का परिणाम स्वीकृति से अलग क्यों आता है?

आपका सबमिशन अनुरोध पूरा होने के बाद भी नेटवर्क डिलीवरी पूरी कर सकता है।

फ़ोन तक पहुँच न होने पर मैसेज सेंटर टेक्स्ट को रोककर रख सकता है। मैसेज सेंटर इस प्रतीक्षा चरण को समझाता है।

अपने एप्लिकेशन में सबमिशन और डिलीवरी को अलग-अलग परिणामों के रूप में रखें। अन्यथा स्वीकार किया गया अनुरोध तब भी सफल दिख सकता है जब बाद की डिलीवरी रिपोर्ट विफलता दर्ज करती है।

मैं Bird के HTTP API से कैसे भेजूँ?

आप एक संदेश सबमिट करते हैं, उसका पहचानकर्ता सहेजते हैं और उसके बाद आने वाले डिलीवरी इवेंट प्रोसेस करते हैं।

फ़्री-टेक्स्ट भेजने के लिए POST /v1/sms/messages को to, from, text और category के साथ उपयोग करें। category को marketing, transactional, authentication या service में से किसी एक पर सेट करें। भेजने की गाइड समर्थित फ़ील्ड का दस्तावेज़ देती है।

202 प्रतिक्रिया स्वीकृति की पुष्टि करती है। यह फ़ोन तक डिलीवरी की पुष्टि नहीं करती। लौटाए गए id को SMS इवेंट के ज़रिए ट्रैक करें, ताकि अंतिम परिणाम सही अनुरोध को अपडेट करे।

मेरे एप्लिकेशन के लिए कौन-सा रास्ता सही है?

वह इंटरफ़ेस चुनें जिसे आपका एप्लिकेशन भरोसेमंद ढंग से चला सके, फिर डिलीवरी क्षमताओं की अलग से जाँच करें।

  1. जिस नए इंटीग्रेशन में SMPP की कोई खास ज़रूरत नहीं है, उसके लिए HTTP का उपयोग करें।
  2. SMPP का उपयोग तब करें, जब कोई मौजूदा सिस्टम या ज़रूरी कनेक्शन व्यवहार उसके सेशन प्रबंधन को उचित ठहराए।
  3. किसी भी रास्ते पर ट्रैफ़िक भेजने से पहले गंतव्यों, सेंडर और डिलीवरी इवेंट का परीक्षण करें।

संक्षेप में

  1. API और गेटवे अलग-अलग काम करते हैं।

    API आपका अनुरोध स्वीकार करता है, जबकि गेटवे मोबाइल नेटवर्क तक का रास्ता देता है।

  2. HTTP के साथ आपको SMPP सेशन प्रबंधित नहीं करना पड़ता।

    SMPP में आपको मैसेज वर्कफ़्लो के अलावा कनेक्शन रिकवरी और सेशन हैंडलिंग भी संभालनी पड़ती है।

  3. स्वीकृति और डिलीवरी अलग-अलग रहती हैं।

    भेजने का अनुरोध सफल होने से यह साबित नहीं होता कि प्राप्तकर्ता को मैसेज मिल गया।

  4. इंटरफ़ेस के साथ-साथ डिलीवरी पाथ की भी तुलना करें।

    इंटीग्रेशन चुनने से पहले गंतव्य सपोर्ट, सेंडर की आवश्यकताएँ, थ्रूपुट और विफलता रिपोर्टिंग जाँच लें।

व्यवहार में लाएँ।

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

उसी नेटवर्क पर बनाएँ।

एक टेस्ट API key आपको तुरंत मिल जाती है। भुगतान विधि जोड़ने और सेंडर सत्यापित करने पर प्रोडक्शन अनलॉक होता है।

आपका अगला आइडिया। जुड़ने के लिए तैयार।