ऑर्डर की पुष्टि वाला संदेश हर प्राप्तकर्ता के लिए ऑर्डर नंबर बदलते हुए वही शब्द दोबारा इस्तेमाल कर सकता है। इससे डेटा बदलने पर भी वर्कफ़्लो एक जैसा रहता है।
टेम्पलेट में क्या होता है?
टेम्पलेट में स्थिर टेक्स्ट, वेरिएबल की परिभाषाएँ और संदेश की श्रेणी होती है। श्रेणी बताती है कि आप संदेश किस उद्देश्य से भेज रहे हैं। कोई गंतव्य अपने पंजीकरण नियमों में सामग्री के इसी वर्गीकरण का उपयोग कर सकता है।
हर वेरिएबल ऐसे मान का नाम है जो हर बार भेजने पर बदलता है, जैसे ऑर्डर नंबर। टेम्पलेट तय करता है कि वेरिएबल किस प्रकार का मान स्वीकार करता है, वह अनिवार्य है या नहीं और उसके मान पर कोई प्रतिबंध है या नहीं।
कैंपेन की सामग्री और टेम्पलेट दोबारा उपयोग होने वाले शब्दों को हर प्राप्तकर्ता के अपने मानों के साथ जोड़ते हैं। Bird के टेम्पलेट कैटलॉग में प्रमाणीकरण और लेन-देन संबंधी संदेशों के लिए सिस्टम टेम्पलेट शामिल हैं। वर्कस्पेस टेम्पलेट से आप अपना टेक्स्ट कई भाषाओं में प्रकाशित कर सकते हैं। टेम्पलेट बनाने की सुविधा टेम्पलेट प्रबंधन API के ज़रिए उपलब्ध है।
टेम्पलेट चुनने से पहले उसके वेरिएबल देखें। प्रीव्यू जाना-पहचाना दिखे, तब भी इससे यह तय नहीं होता कि उसके अनिवार्य मान आपके एप्लिकेशन के डेटा से मेल खाते हैं।
क्या SMS टेम्पलेट को मंज़ूरी चाहिए?
बिल्ट-इन टेम्पलेट भेजने के लिए तैयार होते हैं। वर्कस्पेस टेम्पलेट प्रकाशित करने पर उसके टेक्स्ट और वेरिएबल की जाँच होती है। प्रकाशित संस्करण Meta की मंज़ूरी के बिना तुरंत उपलब्ध हो जाता है। फिर भी गंतव्य के नियमों के तहत सामग्री का पंजीकरण ज़रूरी हो सकता है।
ये अलग-अलग प्रक्रियाएँ हैं। किसी प्रदाता का दोबारा उपयोग होने वाला संदेश अपने आप में यह साबित नहीं करता कि वह गंतव्य के नियमों का पालन करता है।
उदाहरण के लिए, भारत में पंजीकृत प्रेषक पहचानों से भेजे जाने वाले संदेशों के लिए TRAI के प्रेषक दिशानिर्देश सामग्री टेम्पलेट का पंजीकरण अनिवार्य करते हैं। यह आवश्यकता संदेश की संरचना से जुड़ी है, जिसमें स्थिर और बदलने वाले हिस्से शामिल हैं।
भेजने का तरीका चुनने से पहले गंतव्य के नियम जाँचें। प्रेषक पंजीकरण भेजने वाली पहचान से जुड़ा है और सामग्री पंजीकरण की आवश्यकता के साथ-साथ लागू हो सकता है।
Bird श्रेणी और प्रेषक कैसे चुनता है?
श्रेणी टेम्पलेट से आती है। यह सामग्री का वर्गीकरण है जो बताता है कि आप संदेश क्यों भेज रहे हैं। बिल्ट-इन टेम्पलेट गंतव्य के लिए प्रेषक खुद चुनते हैं, जबकि वर्कस्पेस टेम्पलेट आपके दिए गए प्रेषक का उपयोग करते हैं।
टेम्पलेट भेजने का अनुरोध template के साथ text, category और media_urls को अस्वीकार करता है। बिल्ट-इन टेम्पलेट के लिए from न दें, और वर्कस्पेस टेम्पलेट के लिए इसे दें। टेम्पलेट भेजने का अनुबंध इन आवश्यकताओं का दस्तावेज़ है।
जब आपके एप्लिकेशन को कोई खास प्रेषक चुनना हो, तो वर्कस्पेस टेम्पलेट या फ्री टेक्स्ट का उपयोग करें।
प्रतिक्रिया में from और category देखें। ये फ़ील्ड बताते हैं कि Bird ने उस संदेश के लिए कौन-सा प्रेषक और कौन-सा सामग्री वर्गीकरण चुना।
मैं Bird में टेम्पलेट कैसे भेजूँ?
एक प्रकाशित टेम्पलेट की पहचान करें और भेजने के अनुरोध के template ऑब्जेक्ट में उसके वेरिएबल के मान दें।
इसकी पहचान के लिए slug या id का उपयोग करें। इसका live_version_id जानने के लिए GET /v1/sms/templates/{template_ref} पढ़ें, फिर इसकी सामग्री और वेरिएबल परिभाषाओं के लिए GET /v1/sms/templates/{template_ref}/versions/{version_id} पढ़ें।
मान parameters में वेरिएबल के नाम को कुंजी बनाकर रखें। आवश्यक मान न होने, अघोषित कुंजियाँ होने या फ़ॉर्मैट अमान्य होने पर 422 लौटता है, इसलिए भेजने से पहले मानों की जाँच करें।
सीरियलाइज़ किया गया parameters ऑब्जेक्ट 16 KB के भीतर होना चाहिए। Bird इस सीमा से बड़े अनुरोध को अस्वीकार करता है, इसलिए इसमें केवल टेम्पलेट के घोषित मान रखें।
ज़रूरत हो तो language चुनें। टेम्पलेट की भाषा सेटिंग डिफ़ॉल्ट और किसी भी फ़ॉलबैक को तय करती हैं, इसलिए यह मानने के बजाय कि हर अनुरोधित भाषा मौजूद है, उन सेटिंग को देखें।
क्या टेम्पलेट से SMS की बिलिंग बदलती है?
रेंडर किया गया टेक्स्ट किसी भी अन्य SMS बॉडी की तरह गिना जाता है।
सेगमेंट का अनुमान लगाने से पहले असली मान डालें। लंबा ऑर्डर संदर्भ या संक्षिप्त वर्णमाला से बाहर का नाम गिनती बढ़ा सकता है।
टेम्पलेट का संदर्भ हर प्राप्तकर्ता के लिए तय कीमत नहीं है। प्रतिक्रिया में segments.count उस रेंडर किए गए संदेश के बिल योग्य भाग बताता है।
मुझे टेम्पलेट कब चुनना चाहिए?
कैटलॉग टेम्पलेट तब चुनें जब उसका मुख्य भाग, वेरिएबल और प्रेषक चुनने का तरीका आपके वर्कफ़्लो के अनुकूल हों।
- टेम्पलेट का उपयोग तब करें जब दिया गया मुख्य भाग संदेश से मेल खाता हो और आपके पास उसके आवश्यक मान हों।
- अपने प्रेषक के साथ दोबारा उपयोग होने वाले शब्दों के लिए वर्कस्पेस टेम्पलेट प्रकाशित करें, या किसी एक संदेश के लिए फ़्री टेक्स्ट का उपयोग करें।
- दोनों में से किसी भी विकल्प पर गंतव्य की पंजीकरण आवश्यकताएँ लागू करें।
संक्षेप में
टेम्पलेट में दोबारा इस्तेमाल होने वाला टेक्स्ट और वेरिएबल की परिभाषाएं होती हैं।
कोई बिल्ट-इन टेम्पलेट चुनें या वर्कस्पेस का प्रकाशित टेम्पलेट इस्तेमाल करें, फिर उसके ज़रूरी मान दें।
सेंडर का चुनाव टेम्पलेट के दायरे पर निर्भर करता है।
बिल्ट-इन टेम्पलेट Bird द्वारा चुने गए सेंडर का इस्तेमाल करते हैं। वर्कस्पेस टेम्पलेट के लिए आपका अपना सेंडर ज़रूरी है। श्रेणी टेम्पलेट से तय होती है।
वर्कस्पेस टेम्पलेट प्रकाशित करने के लिए Meta की समीक्षा की ज़रूरत नहीं होती।
वर्कस्पेस टेम्पलेट प्रकाशित करने पर उसके ड्राफ़्ट की जांच होती है। प्रकाशित संस्करण तुरंत भेजने के लिए उपलब्ध हो जाता है। गंतव्य के कंटेंट पंजीकरण नियम इससे अलग लागू होते हैं।
भरे गए मान भी सेगमेंट की संख्या पर असर डालते हैं।
तैयार संदेश की जांच करें, क्योंकि लंबे मान बिल होने वाले सेगमेंट बढ़ा सकते हैं।