Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

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 साइडबार में प्रोडक्ट्स में से एक है। इसके पेज, और हर एक की गाइड कहाँ है:

पेजकिसके लिए है
Messagesभेजा गया हर मैसेज, उसकी प्रति-मैसेज इवेंट टाइमलाइन और डिलीवरी विवरण के साथ। गाइड: SMS लॉग
Templatesबिल्ट-इन टेम्पलेट जो आप भेज सकते हैं: नाम, कैटेगरी, भाषाएँ, और वेरिएबल। गाइड: SMS टेम्पलेट
Metricsडिलीवरी दर, विफलता दर, और समय के साथ स्वीकृत वॉल्यूम। गाइड: SMS मेट्रिक्स
Sendersसेंडर ID और नंबर जिनसे आप भेज सकते हैं, और हर एक कहाँ रजिस्टर्ड है। गाइड: SMS सेंडर ID
Destinationsवे देश जहाँ आपका वर्कस्पेस भेज सकता है; वहाँ भेजने से पहले डेस्टिनेशन सक्षम करें। गाइड: SMS भेजना

दृश्यता

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

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

अगले कदम

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

संबंधित संसाधन

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

इम्प्लीमेंटेशन ब्रीफ़ पाएँ