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 भेजना इस पूर्व-आवश्यकता को कवर करता है।
वन-टाइम सत्यापन कोड के लिए, मैसेज स्वयं बनाने के बजाय Bird Verify पर विचार करें। Verify कोड जनरेट करता है और उसे SMS या ईमेल पर डिलीवर करता है, जवाब जाँचता है, और एक्सपायरी, प्रयास सीमा, और दोबारा भेजने के कूलडाउन लागू करता है।
डैशबोर्ड में SMS ऐप
डैशबोर्ड में, SMS साइडबार में प्रोडक्ट्स में से एक है। इसके पेज, और हर एक की गाइड कहाँ है:
| पेज | किसके लिए है |
|---|---|
| Messages | भेजा गया हर मैसेज, उसकी प्रति-मैसेज इवेंट टाइमलाइन और डिलीवरी विवरण के साथ। गाइड: SMS लॉग |
| Templates | बिल्ट-इन टेम्पलेट जो आप भेज सकते हैं: नाम, कैटेगरी, भाषाएँ, और वेरिएबल। गाइड: SMS टेम्पलेट |
| Metrics | डिलीवरी दर, विफलता दर, और समय के साथ स्वीकृत वॉल्यूम। गाइड: SMS मेट्रिक्स |
| Senders | सेंडर ID और नंबर जिनसे आप भेज सकते हैं, और हर एक कहाँ रजिस्टर्ड है। गाइड: SMS सेंडर ID |
| Destinations | वे देश जहाँ आपका वर्कस्पेस भेज सकता है; वहाँ भेजने से पहले डेस्टिनेशन सक्षम करें। गाइड: SMS भेजना |
दृश्यता
स्वीकृति, कैरियर हैंडऑफ़ और डिलीवरी परिणामों की जाँच करने के लिए मैसेज रिकॉर्ड और उपलब्ध इवेंट टाइमलाइन का उपयोग करें। मैसेज विवरण में सेगमेंट और कोई भी मूल्य-निर्धारित लागत घटक शामिल हैं। मैसेज पढ़ने के सार्वजनिक एंडपॉइंट, SMS लॉग में वर्णित रिटेंशन विंडो को कवर करते हैं।
- SMS लॉग: डैशबोर्ड में प्रति-मैसेज व्यू। हर भेजा गया मैसेज, उसकी इवेंट टाइमलाइन, सेगमेंट, लागत, और कैरियर विवरण।
- SMS मेट्रिक्स: आपके सभी भेजे गए मैसेज की समग्र डिलीवरी दर, विफलता दर, स्वीकृत वॉल्यूम, और डिलीवरी विलंब।
- इवेंट: SMS इवेंट शब्दावली, मैसेज जीवनचक्र, और आपके अपने एंडपॉइंट पर वेबहुक डिलीवरी।
अगले कदम
कैम्पेन, एप्लिकेशन मैसेज और रिप्लाई के लिए SMS प्लेटफ़ॉर्म एक्सप्लोर करें, या वर्कफ़्लो चुनने के लिए SMS रिसोर्स लाइब्रेरी का उपयोग करें।
| पेज | क्या कवर करता है |
|---|---|
| SMS भेजना | भेजने का API: डेस्टिनेशन, सेंडर, बॉडी, सेगमेंट, कैटेगरी, टैग |
| अक्षर सीमाएँ | GSM-7 और UCS-2 एन्कोडिंग, प्रति-सेगमेंट सीमाएँ, और 12-सेगमेंट कैप |
| SMS टेम्पलेट | बिल्ट-इन टेम्पलेट कैटलॉग और टेम्पलेट रेफ़रेंस द्वारा भेजना |
| SMS सेंडर ID | सेंडर प्रकार चुनना और प्रति डेस्टिनेशन देश उसे रजिस्टर करना |
| 10DLC रजिस्ट्रेशन | US A2P भेजने के लिए ब्रांड, कैम्पेन, और नंबर रजिस्टर करना |
| SMS लॉग | हर मैसेज, उसकी इवेंट टाइमलाइन, सेगमेंट, और लागत |
| SMS मेट्रिक्स | डिलीवरी दर, विफलता दर, और विलंब |
| इवेंट | SMS इवेंट प्रकार और वेबहुक डिलीवरी |
| वेबहुक और इवेंट | एंडपॉइंट सेटअप, सिग्नेचर सत्यापन, फिर से प्रयास, और रीप्ले |
| Verify अवलोकन | SMS और ईमेल पर वन-टाइम सत्यापन कोड, Bird द्वारा भेजे और जाँचे गए |
| नियंत्रित करें कि आपका अकाउंट कहाँ भेज सकता है | एक वीडियो: दिखाता है कि अक्षम डेस्टिनेशन पर भेजने पर क्या लौटता है |
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंSMS pumping explainedकॉन्सेप्ट समझेंWhat is SMS pumping, and how do I stop it?क्षमता जानेंSMS destinationsलर्निंग पाथ फ़ॉलो करेंBuild your first integration
इम्प्लीमेंटेशन ब्रीफ़ पाएँ