SMS का अवलोकन

Bird SMS उसी प्लेटफ़ॉर्म और उन्हीं API कुंजियों से टेक्स्ट मैसेज भेजता है जिनसे Bird Email काम करता है। अपने क्षेत्रीय होस्ट (https://us1.platform.bird.com या https://eu1.platform.bird.com) पर bk_{region}_… कुंजी के साथ Bird को कॉल करें। Bird प्राप्तकर्ता के कैरियर तक का रूट चुनता है, आपके टेक्स्ट को बिल होने वाले सेगमेंट में बाँटता है, और हर मैसेज की स्थिति उसकी डिलीवरी रसीद से बताता है। SMS एंडपॉइंट /v1/sms/ से शुरू होते हैं।

आप अपने चुने हुए सेंडर और कैटेगरी के साथ फ़्री-फ़ॉर्म टेक्स्ट भेज सकते हैं, या Bird के बिल्ट-इन टेम्पलेट में से किसी एक का उपयोग कर सकते हैं, जो बॉडी, कैटेगरी और सेंडर तय करता है। Bird आपके नंबरों पर आए जवाब भी प्राप्त करता है। यह हर इनबाउंड मैसेज को आपके भेजे गए मैसेज के साथ सहेजता है और sms.received भेजता है। जब कोई जवाब STOP जैसे समर्थित ऑप्ट-आउट कीवर्ड से मेल खाता है, तो Bird उस सेंडर और सब्सक्राइबर के लिए एक सप्रेशन भी दर्ज करता है। कवरेज और कॉन्फ़िगरेशन के लिए ऑप्ट-आउट और कीवर्ड देखें।

भेजना कैसे काम करता है

POST /v1/sms/messages से एक SMS भेजें: एक प्राप्तकर्ता और एक मैसेज, जिसमें या तो सेंडर और कैटेगरी के साथ आपका अपना text हो, या उसके वेरिएबल मानों के साथ template रेफ़रेंस हो। Bird अनुरोध और गंतव्य की जाँच करता है, सेंडर तय करता है, और मैसेज ID के साथ 202 Accepted लौटाता है। इसके बाद डिलीवरी एसिंक्रोनस रूप से होती है। नतीजे को इवेंट और वेबहुक या मैसेज पढ़ने वाले एंडपॉइंट से ट्रैक करें। एक ही कॉल में कई स्वतंत्र मैसेज भेजने के लिए बैच एंडपॉइंट का उपयोग करें।

पूरे API को तीन बातें आकार देती हैं:

• भेजना और डिलीवरी अलग-अलग चरण हैं। 202 का अर्थ है कि Bird ने मैसेज स्वीकार कर लिया है। स्वीकार होने के बाद कैरियर उसे प्रोसेस करता है और बाद में डिलीवरी रसीद लौटा सकता है। विफलता की रसीद भी एक अंतिम नतीजा है, इसलिए भेजे गए मैसेज को डिलीवर मानने से पहले बताई गई स्थिति जाँचें।
• टेक्स्ट का बिल सेगमेंट के हिसाब से बनता है। एक सेगमेंट से लंबा मैसेज बाँटा जाता है और हर सेगमेंट का बिल अलग बनता है। एक सेगमेंट में कितने अक्षर आते हैं, यह आपके इस्तेमाल किए गए अक्षरों पर निर्भर करता है। अक्षर सीमाएँ में एन्कोडिंग के नियम, पूरा अक्षर सेट और मैसेज को एक सेगमेंट में रखने का तरीका दिया गया है।
• आप किस वजह से भेजते हैं, यह मायने रखता है। हर मैसेज की एक कैटेगरी होती है: transactional, marketing, authentication या service। Bird और कैरियर इससे मैसेज का उद्देश्य समझते हैं। टेम्पलेट से भेजने पर कैटेगरी टेम्पलेट से आती है।

पहली बार भेजने से पहले, SMS > Destinations में वे गंतव्य देश चालू करें जिनमें आप मैसेज भेजते हैं। अनुमति सूची डिफ़ॉल्ट रूप से सब कुछ रोकती है: आपके वर्कस्पेस ने जो देश चालू नहीं किया है, वहाँ भेजने का अनुरोध Bird अस्वीकार कर देता है। SMS भेजना इस शर्त को समझाता है, और अपना पहला SMS भेजें पहली बार भेजने के चरण बताता है।

एक बार इस्तेमाल होने वाले सत्यापन कोड के लिए संदेश ख़ुद लिखने के बजाय Bird Verify का उपयोग करने पर विचार करें। Verify कोड बनाता है और उसे SMS या ईमेल से भेजता है, उत्तर की जाँच करता है, और समाप्ति अवधि, प्रयास की सीमा और दोबारा भेजने के बीच के प्रतीक्षा समय को लागू करता है।

डैशबोर्ड में SMS ऐप

डैशबोर्ड में SMS साइडबार के उत्पादों में से एक है। इसके पेज, और हर पेज की गाइड कहाँ है:

दृश्यता

स्वीकृति, कैरियर को सौंपे जाने और डिलीवरी के परिणामों की जाँच के लिए मैसेज रिकॉर्ड और उपलब्ध इवेंट टाइमलाइन का उपयोग करें। मैसेज विवरण में सेगमेंट और मूल्य-निर्धारित लागत के घटक शामिल होते हैं। सार्वजनिक मैसेज रीड उस रिटेंशन अवधि को कवर करते हैं जिसका वर्णन SMS लॉग में है।

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

अगले कदम

कैंपेन, एप्लिकेशन मैसेज और जवाबों के लिए SMS प्लेटफ़ॉर्म देखें, या कोई वर्कफ़्लो चुनने के लिए SMS संसाधन लाइब्रेरी का उपयोग करें।

• अपना पहला SMS भेजें: एक API कुंजी, एक गंतव्य, बिल्ट-इन टेम्पलेट से भेजना और उसकी डिलीवरी स्थिति
• SMS भेजना: भेजने का API: गंतव्य, सेंडर, बॉडी, सेगमेंट, श्रेणियाँ, टैग
• वर्ण सीमाएँ: GSM-7 और UCS-2 एन्कोडिंग, प्रति सेगमेंट सीमाएँ और अधिकतम 12 सेगमेंट की सीमा
• SMS टेम्पलेट: बिल्ट-इन टेम्पलेट कैटलॉग और टेम्पलेट संदर्भ से भेजना
• SMS सेंडर ID: सेंडर का प्रकार चुनना और हर गंतव्य देश के लिए उसे पंजीकृत करना
• 10DLC पंजीकरण: US में A2P भेजने के लिए ब्रांड, कैंपेन और नंबर पंजीकृत करना
• SMS लॉग: हर मैसेज, उसकी इवेंट टाइमलाइन, सेगमेंट और लागत
• SMS मेट्रिक्स: डिलीवरी दर, विफलता दर और विलंब
• इवेंट: SMS इवेंट प्रकार और वेबहुक डिलीवरी
• वेबहुक और इवेंट: एंडपॉइंट सेटअप, सिग्नेचर सत्यापन, फिर से प्रयास और रीप्ले
• Verify का अवलोकन: SMS और ईमेल से भेजे जाने वाले एक बार के सत्यापन कोड, जिन्हें Bird भेजता और जाँचता है
• नियंत्रित करें कि आपका अकाउंट कहाँ भेज सकता है: एक वीडियो, जो दिखाता है कि अक्षम गंतव्य पर भेजने पर क्या लौटता है