ऑप्ट-आउट और कीवर्ड
जब कोई आपके किसी नंबर पर टेक्स्ट भेजता है, तो संदेश आप तक पहुँचने से पहले Bird उसे कीवर्ड के एक कैटलॉग से मिलाता है। पहचाना गया stop कीवर्ड उस सेंडर से उस सब्सक्राइबर को आगे के संदेश रोक देता है, start कीवर्ड यह सप्रेशन खत्म कर देता है, और help सहायता जानकारी के साथ जवाब देता है। समर्थित देशों में इस व्यवहार के लिए कोई सेटअप ज़रूरी नहीं है।
यह गाइड बताती है कि Bird डिफ़ॉल्ट रूप से क्या करता है, आप इसे कैसे देख सकते हैं और कैसे बदल सकते हैं।
डिफ़ॉल्ट रूप से क्या होता है
कोई सब्सक्राइबर आपके किसी नंबर पर STOP टेक्स्ट करता है। Bird:
- उस नंबर के देश के कीवर्ड कैटलॉग से मिलाकर उसे पहचानता है।
- ठीक उसी सेंडर और सब्सक्राइबर की जोड़ी पर एक सप्रेशन दर्ज करता है।
- उस देश के ऑप्ट-आउट संदेश के साथ जवाब देकर इसकी पुष्टि करता है।
इसके बाद, उस सेंडर से उस सब्सक्राइबर को भेजा गया संदेश बाहर जाने के बजाय E12077 SMSRecipientSuppressed के साथ अस्वीकार कर दिया जाता है। START सप्रेशन खत्म करता है और इसकी भी पुष्टि करता है, और HELP कुछ भी बदले बिना जवाब देता है।
एक सप्रेशन एक सेंडर और एक सब्सक्राइबर पर लागू होता है। यह आपके पूरे वर्कस्पेस पर लागू नहीं होता। इस रोक का तकनीकी दायरा किसी दूसरे सेंडर का उपयोग करने की अनुमति नहीं देता। ग्राहक ने जिन संदेशों और प्रोग्राम को रोकने के लिए कहा है, उन पर उसकी बताई गई पसंद लागू करें। वर्कस्पेस के सभी सेंडर को एक साथ रोकने के लिए नीचे सभी सेंडर से ऑप्ट-आउट करना देखें।
पुष्टि संदेश पर वह सप्रेशन लागू नहीं होता जिसे वह दर्ज करता है। नया सप्रेशन बाद में भेजे जाने वाले आउटबाउंड संदेशों को रोकता है, फिर भी Bird इनबाउंड संदेश का जवाब दे सकता है।
कवरेज हर देश के लिए अलग है
Bird का कैटलॉग कुछ ही देशों को कवर करता है। जिस देश को कवर किया गया है, वहाँ Bird डिफ़ॉल्ट रूप से ऑप्ट-आउट, ऑप्ट-इन और सहायता कीवर्ड संभालता है। जहाँ कवरेज नहीं है, वहाँ Bird कोई कीवर्ड नहीं पहचानता, कोई जवाब नहीं भेजता और कोई ऑप्ट-आउट दर्ज नहीं करता। अगर आप किसी ऐसे देश में भेजते हैं जिसे कवर नहीं किया गया है, तो ऑप्ट-आउट का पालन आपको खुद करना होगा।
किसी देश पर निर्भर होने से पहले देखें कि उसके लिए क्या उपलब्ध है:
bird sms keyword-rules list --country NLखाली परिणाम का मतलब है कि उस देश का कोई कवरेज नहीं है। वहाँ आप अपने खुद के custom कीवर्ड जोड़ सकते हैं। बाकी हर ऑपरेशन Bird की दी हुई किसी चीज़ को बदलता है, इसलिए ऐसा नियम आप केवल उसी देश के लिए बना सकते हैं जो Bird के कैटलॉग में है।
यह देखना कि क्या लागू होता है
GET /v1/sms/keyword-rules बताता है कि आपके नंबरों पर आए जवाबों को कैसे संभाला जाता है। बिना फ़िल्टर के यह Bird का पूरा कैटलॉग और आपके बनाए सभी नियम लौटाता है। परिणाम सीमित करने के लिए country, number, operation या scope का उपयोग करें:
scope=systemकेवल Bird का कैटलॉग लौटाता है, जिसमें वह डिफ़ॉल्ट भी शामिल है जिसे किसी वर्कस्पेस नियम ने बदल दिया है।scope=workspaceकेवल आपके अपने नियम लौटाता है।number=+18005551234आपके किसी एक नंबर पर लागू होने वाले नियम उसी क्रम में लौटाता है जिसमें वे इनबाउंड संदेश पर लागू होते हैं। किसी दूसरी जगह से संदेश भेजने वाले पर क्या लागू होता है, यह देखने के लिएfrom_countryजोड़ें, क्योंकि यह अलग हो सकता है।
नियम सबसे विशिष्ट से शुरू होकर लौटते हैं, और हर नियम में effective_keywords होता है: उस ऑपरेशन और देश के लिए Bird का सेट और उसके साथ आपके जोड़े गए कीवर्ड।
सूची में stop, start और help के अलावा दो और ऑपरेशन आते हैं:
infoआपके प्रोग्राम की जानकारी के साथ जवाब देता है और ठीक वैसे ही काम करता है जैसेhelpकरता है। इसे अलग रखा गया है ताकि जिस देश में INFO का जवाब HELP के जवाब से अलग होना ज़रूरी हो, वहाँ दोनों रखे जा सकें। जहाँ Bird किसी देश के लिए कोईinfoनियम नहीं देता, वहाँ INFO उस देश केhelpकीवर्ड में से एक होता है औरhelpवाले जवाब से उत्तर देता है।confirmडबल ऑप्ट-इन जवाब को चिह्नित करता है, जैसेJOINयाYES। यह अभी कुछ नहीं भेजता, इसलिए इसका जवाब अपने हैंडलर से दें। Bird इन कीवर्ड को अपने पास रखता है ताकि कोईcustomनियम इन पर दावा न कर सके।
जवाब बदलना
Bird के डिफ़ॉल्ट जवाब सही हैं, पर सामान्य हैं। अपने नाम से जवाब देने के लिए उस देश और ऑपरेशन के लिए एक नियम बनाएँ:
bird sms keyword-rules create \
--operation stop \
--country NL \
--reply "You are unsubscribed from MyBrand. Reply START to resume."आपका नियम उस देश के लिए Bird के डिफ़ॉल्ट जवाब की जगह लेता है और Bird के कीवर्ड बनाए रखता है, जब तक आप और कीवर्ड न जोड़ें। Bird बाद में जो कीवर्ड जोड़ता है, वे भी इसे मिल जाते हैं। ऑप्ट-आउट या ऑप्ट-इन कीवर्ड को दिया गया ऑपरेशन आप नहीं बदल सकते। जो नियम STOP को किसी दूसरे ऑपरेशन से जोड़ने की कोशिश करता है, उसे Bird अस्वीकार कर देता है।
जहाँ Bird किसी देश के कीवर्ड एक से ज़्यादा भाषाओं में देता है, वहाँ हर भाषा का अपना नियम होता है, इसलिए नियम बनाते समय यह बताना ज़रूरी है कि वह किस भाषा के नियम की जगह ले रहा है। अभी ऐसा देश कनाडा है: उसके stop, start और help नियम en और fr में आते हैं। वहाँ language ज़रूरी है, और जिस देश के लिए Bird केवल एक भाषा में नियम देता है, वहाँ इसे अस्वीकार कर दिया जाता है।
bird sms keyword-rules create \
--operation stop \
--country CA \
--language fr \
--reply "Vous etes desabonne de MyBrand. Repondez DEBUT pour reprendre."किसी देश के नियमों की सूची देखकर पता चलता है कि यह भाषा-विभाजन लागू होता है या नहीं, और कौन-सी भाषाएँ उपलब्ध हैं।
किसी नियम को उस देश के आपके सभी नंबरों के बजाय केवल एक नंबर तक सीमित करने के लिए, सिर्फ़ देश पर निर्भर रहने के बजाय number सेट करें।
अगर आप इन संदेशों का जवाब Bird के बजाय अपने सिस्टम से देते हैं, तो confirmed_self_managed के साथ reply को null पर सेट करें। इससे उस नियम के लिए Bird का ऑटो-रिप्लाई बंद हो जाता है, जबकि सप्रेशन काम करता रहता है।
कैंपेन कीवर्ड
custom नियमों में कोई अंतर्निहित व्यवहार नहीं होता। वे आपके चुने हुए कीवर्ड से मेल खाते हैं और आपका लिखा जवाब भेजते हैं, जिससे PIZZA जैसे कैंपेन कीवर्ड संभव होते हैं। custom नियम को कोई कीवर्ड विरासत में नहीं मिलता, इसलिए उसमें कम से कम एक अपना कीवर्ड होना ज़रूरी है। आप जहाँ भी भेजते हैं, वहाँ लागू करने के लिए इसमें country छोड़ा जा सकता है।
जिस कीवर्ड को Bird ने किसी अनुपालन ऑपरेशन से जोड़ा है, उसे कस्टम कीवर्ड के रूप में दोबारा इस्तेमाल नहीं किया जा सकता।
सप्रेशन देखना और प्रबंधित करना
GET /v1/sms/suppressions उन जोड़ियों की सूची देता है जिनके लिए आपके संदेश अभी रोके गए हैं, सबसे हाल वाले पहले। किसी सब्सक्राइबर को भेजने से पहले उसे जाँचने के लिए destination से फ़िल्टर करें, अपने किसी एक सेंडर के लिए originator से, या reason से:
keyword_stop: सब्सक्राइबर ने स्टॉप कीवर्ड टेक्स्ट किया।carrier_opted_out: उनके कैरियर ने ऑप्ट-आउट की सूचना दी।manual: API या डैशबोर्ड के ज़रिए जोड़ा गया।
समाप्त हो चुके सप्रेशन सूची में नहीं दिखते, इसलिए प्रतिक्रिया उन्हीं प्राप्तकर्ताओं को दिखाती है जिन्हें आप अभी संदेश नहीं भेज सकते।
किसी ग्राहक ने फ़ोन पर ऑप्ट-आउट किया हो, तो उसका पालन करने के लिए आप खुद एक सप्रेशन जोड़ सकते हैं:
bird sms suppressions add --destination +15550001234 --originator +15557654321मैन्युअल सप्रेशन हर श्रेणी को, ट्रांज़ैक्शनल सहित, ब्लॉक करता है, और इसे जोड़ना idempotent है, यानी दोबारा जोड़ने से कुछ नहीं बदलता। इसे हटाने की अनुमति जानबूझकर सीमित है: इस तरीके से केवल manual सप्रेशन समाप्त किया जा सकता है। सब्सक्राइबर के अपने स्टॉप कीवर्ड और कैरियर के ऑप्ट-आउट को हटाने का अनुरोध अस्वीकार होता है, क्योंकि उन्हें पलटना आपका अधिकार नहीं है।
हर सेंडर से ऑप्ट-आउट करना
स्टॉप कीवर्ड और ऊपर बताए गए मैन्युअल सप्रेशन, दोनों एक ही सेंडर को रोकते हैं। कुछ सब्सक्राइबर वर्कस्पेस के हर सेंडर से एक साथ बाहर होना चाहते हैं, जैसे कोई व्यक्ति जो हर नंबर को अलग-अलग जवाब देने के बजाय आपकी सपोर्ट टीम से सभी टेक्स्ट बंद करने को कहता है।
यह सप्रेशन नहीं, बल्कि बताई गई प्राथमिकता है, इसलिए यह ऊपर वाली सूची में नहीं, बल्कि SMS > Suppressions के Preferences टैब पर रहती है। टैब खोलें और Every sender in the workspace के साथ ऑप्ट-आउट दर्ज करें: उस नंबर को वर्कस्पेस के हर सेंडर से, बाद में जोड़े गए सेंडर सहित, SMS मिलना बंद हो जाता है। इस टैब पर दर्ज ऑप्ट-आउट सभी संदेशों पर लागू होता है, ऑथेंटिकेशन टेक्स्ट सहित। केवल मार्केटिंग रोकने वाला ऑप्ट-आउट दर्ज करने के लिए पूरे वर्कस्पेस वाला Contacts > Preferences पेज इस्तेमाल करें, जिसके डायलॉग में कवरेज चुनने का विकल्प है।
Bird पहले इस गाइड के सप्रेशन जाँचता है, इसलिए साधारण कीवर्ड स्टॉप पहले की तरह ही E12077 के साथ अस्वीकार होता है। जिस नंबर पर पूरे वर्कस्पेस का ऑप्ट-आउट दर्ज है, उसे भेजा गया संदेश इसके बजाय E25000 PreferenceRevoked के साथ अस्वीकार होता है। सब्सक्राइबर के कहने पर भेजना फिर शुरू करने के लिए Preferences टैब से वह एंट्री हटाएँ (आपने उसे दर्ज किया था, इसलिए आप उसे हटा सकते हैं), या पूरे वर्कस्पेस वाले Contacts > Preferences पेज पर ऑप्ट-इन दर्ज करें।
अगले कदम
किसी ऑडियंस को भेजने से पहले कैंपेन सहमति और भेजने के नियंत्रण की समीक्षा करें, या अपने इंटीग्रेशन के लिए SMS ऑप्ट-आउट हैंडलिंग देखें।
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।