कोई स्टोर एक ही घटना के बारे में कई ग्राहकों को सूचना भेज सकता है और हर टेक्स्ट को व्यक्तिगत बना सकता है। फिर भी हर प्राप्तकर्ता के लिए अनुमति और डिलीवरी का मान्य रास्ता ज़रूरी है।
कई प्राप्तकर्ताओं को भेजने पर क्या बदलता है?
आप एक अनुरोध को पूरा कैंपेन मानने के बजाय कई स्वतंत्र संदेशों के भेजे जाने का समन्वय करते हैं।
हर प्राप्तकर्ता का गंतव्य, प्रेषक से जुड़ी आवश्यकता या सहमति की स्थिति अलग हो सकती है। एक व्यक्ति तक संदेश सफलतापूर्वक पहुँचने से किसी दूसरे व्यक्ति के फ़ोन के बारे में कुछ पता नहीं चलता।
पर्सनलाइज़ेशन से असली टेक्स्ट भी बदलता है। लंबा नाम या एक इमोजी उसकी एन्कोडिंग और सेगमेंट संख्या बदल सकता है। बिल होने वाली मात्रा का अनुमान लगाते समय पूरे बने हुए संदेशों को गिनें।
मुझे ब्रॉडकास्ट इस्तेमाल करना चाहिए या API बैच?
किसी ऑडियंस, साझा सामग्री और भेजने के शेड्यूल के आधार पर कैंपेन का समन्वय करने के लिए ब्रॉडकास्ट इस्तेमाल करें। अपने एप्लिकेशन से स्वतंत्र संदेश सबमिट करने के लिए बैच इस्तेमाल करें।
SMS कैंपेन वर्कफ़्लो ऑडियंस की तैयारी, पर्सनलाइज़ेशन, लॉन्च से पहले की समीक्षा और प्राप्तकर्ताओं के परिणामों को जोड़ता है। बैच एंडपॉइंट इससे सीमित काम करता है: अलग-अलग अनुरोधों को एक साथ स्वीकार करना।
बैच आइडेंटिफ़ायर कैंपेन के स्वामित्व, सहमति के रिकॉर्ड या शेड्यूल की जगह नहीं लेता।
Bird बैच को कैसे स्वीकार करता है?
आप POST /v1/sms/batches के ज़रिए 1 से 100 तक स्वतंत्र संदेश सबमिट करते हैं।
हर संदेश ऑब्जेक्ट को messages ऐरे में रखें। 250 प्राप्तकर्ताओं वाले कैंपेन के लिए कम से कम तीन अनुरोध चाहिए, क्योंकि एक बैच में अधिकतम 100 आइटम आते हैं।
Bird किसी भी आइटम को कतार में डालने से पहले हर आइटम की जाँच करता है। एक भी अमान्य संदेश होने पर पूरा अनुरोध 422 के साथ विफल हो जाता है। बैच दोबारा सबमिट करने से पहले अमान्य आइटम ठीक करें।
सफल होने पर, data में स्वीकार किए गए संदेश उसी क्रम में होते हैं जिसमें आपने उन्हें भेजा था। summary.accepted_count स्वीकार किए गए संदेशों की संख्या बताता है। बैच संदर्भ में इस प्रतिक्रिया का विवरण है।
लौटाए गए हर संदेश पहचानकर्ता को उसके प्राप्तकर्ता से जोड़कर रखें। बाद के डिलीवरी इवेंट इन्हीं अलग-अलग संदेशों के होते हैं, किसी एक साझा बैच परिणाम के नहीं।
क्या सफल बैच का मतलब है कि सभी को संदेश मिल गया?
202 प्रतिक्रिया का मतलब है कि Bird ने संदेशों को प्रोसेसिंग के लिए स्वीकार कर लिया है।
शुल्क लगना, कैरियर को सबमिट करना और डिलीवरी इसके बाद होते हैं। एक स्वीकार किया गया संदेश विफल हो सकता है, जबकि बाकी संदेश अपने प्राप्तकर्ताओं तक पहुँच जाते हैं। अभियान की स्थिति हर संदेश के डिलीवरी इवेंट के आधार पर अपडेट करें।
किसी एक प्राप्तकर्ता के विफल होने पर पूरा स्वीकार किया गया बैच फिर से न भेजें। उस संदेश की त्रुटि की जाँच करें। फिर तय करें कि अलग से प्रयास करना उचित है या नहीं।
भेजने में लगने वाले समय का अनुमान कैसे लगाएँ?
हर गंतव्य का अनुमान अलग से लगाएँ, उसके भेजने के मार्ग पर लागू सीमाओं और क्षमता के आधार पर।
API अनुरोध सीमा तय करती है कि आप कितनी तेज़ी से काम सबमिट करते हैं। डिलीवरी थ्रूपुट बाद के चरण को नियंत्रित करता है। सबमिशन की समवर्तीता बढ़ाने से कैरियर की सीमा नहीं हटती।
क्षमता की गणना से पहले इकाई जाँचें। सेगमेंट पर आधारित सीमा बहु-भाग संदेश को एक से अधिक बार गिनती है। अनुरोध पर आधारित सीमा इसके बजाय बैच कॉल को गिनती है।
Bird बैच अनुरोधों को sms_batch में रखता है, जो sms_send के अंतर्गत आने वाले एकल संदेशों से अलग है। अनुरोध दर सीमा गाइड इन अनुरोध नीतियों को समझाती है। SMS थ्रूपुट डिलीवरी से जुड़े अलग प्रश्न को समझाता है।
अभियान जारी करने से पहले क्या जाँचना चाहिए?
हर प्राप्तकर्ता के लिए सहमति, प्रेषक की पात्रता और पूरा तैयार संदेश जाँचें।
कतार में रखे काम को जारी करते समय ऑप्ट-आउट की ताज़ा स्थिति का उपयोग करें। पहले निर्यात की गई सूची में कोई ऐसा व्यक्ति हो सकता है जिसने बाद में अपनी अनुमति वापस ले ली हो।
किसी गंतव्य के प्राप्तकर्ताओं को बैच में डालने से पहले उस गंतव्य की प्रेषक आवश्यकताएँ जाँचें। ऐसा न करने पर एक अमान्य आइटम कई मान्य संदेशों वाले पूरे बैच को अस्वीकार करवा सकता है।
एक सीमित समूह से शुरुआत करें। भेजने का दायरा बढ़ाने से पहले लौटाए गए परिणाम जाँचें। इससे गलत प्रेषक या गलत संदेश पूरी सूची तक पहुँचने से पहले आसानी से पकड़ में आ जाता है।
- गंतव्य के नियम और हर प्राप्तकर्ता की अनुमति लागू करें।
- पूरे तैयार संदेशों को मान्य करें।
- उनके सेगमेंट गिनें।
- अनुरोध सीमाओं के भीतर बैच सबमिट करें।
- हर संदेश के डिलीवरी परिणाम अलग से ट्रैक करें। हर विफलता की अलग से जाँच करें।
संक्षेप में
हर प्राप्तकर्ता का संदेश फिर भी स्वतंत्र होता है।
बैच स्वीकार होने से सभी प्राप्तकर्ताओं की डिलीवरी का नतीजा एक नहीं हो जाता।
एक Bird बैच में अधिकतम 100 संदेश होते हैं।
स्वतंत्र API संदेश भेजने के लिए बैच का उपयोग करें। समन्वित कैंपेन वर्कफ़्लो ऑडियंस ब्रॉडकास्ट संभालता है।
जाँच पूरे बैच पर लागू होती है।
एक भी अमान्य आइटम होने पर Bird किसी भी आइटम को कतार में डालने से पहले ही अनुरोध अस्वीकार कर देता है।
सहमति और सेंडर की पात्रता की जाँच हर प्राप्तकर्ता के लिए अलग से होती है।
कैंपेन का हर हिस्सा जारी करते समय अनुमति और गंतव्य की आवश्यकताओं को दोबारा जाँचें।