एक नोटिफ़िकेशन सेवा को टेक्स्ट सबमिट करने का तरीका और प्राप्तकर्ताओं के फ़ोन तक पहुँचने का मार्ग दोनों चाहिए। इंटरफ़ेस चुनना इस समस्या के केवल पहले भाग का उत्तर देता है।
हर हिस्सा क्या करता है?
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 इवेंट के ज़रिए ट्रैक करें ताकि अंतिम परिणाम सही अनुरोध को अपडेट करे।
कौन सा पथ मेरे एप्लिकेशन के लिए उपयुक्त है?
वह इंटरफ़ेस चुनें जिसे आपका एप्लिकेशन विश्वसनीय रूप से संचालित कर सके, फिर डिलीवरी क्षमताओं को अलग से सत्यापित करें।
- नए इंटीग्रेशन के लिए HTTP का उपयोग करें जिसमें कोई विशिष्ट SMPP आवश्यकता न हो।
- SMPP का उपयोग तब करें जब कोई मौजूदा सिस्टम या आवश्यक कनेक्शन व्यवहार उसके सेशन प्रबंधन को उचित ठहराता हो।
- किसी भी पथ पर ट्रैफ़िक भेजने से पहले गंतव्यों, सेंडर और डिलीवरी इवेंट का परीक्षण करें।
संक्षेप में
API और गेटवे अलग-अलग काम करते हैं।
API आपका अनुरोध स्वीकार करता है, जबकि गेटवे मोबाइल नेटवर्क तक पहुँचने का मार्ग प्रदान करता है।
HTTP SMPP सेशन प्रबंधन से बचाता है।
SMPP के लिए आपके मैसेज वर्कफ़्लो के अलावा कनेक्शन रिकवरी और सेशन हैंडलिंग भी ज़रूरी होती है।
स्वीकृति और डिलीवरी अलग-अलग रहती हैं।
एक सफल भेजने का अनुरोध यह साबित नहीं करता कि प्राप्तकर्ता को संदेश मिल गया।
इंटरफ़ेस के साथ-साथ डिलीवरी पथ की भी तुलना करें।
कोई इंटीग्रेशन चुनने से पहले गंतव्य सपोर्ट, सेंडर आवश्यकताएँ, थ्रूपुट और विफलता रिपोर्टिंग की जाँच करें।