ऑप्ट-आउट और कीवर्ड

जब कोई व्यक्ति आपके किसी नंबर पर टेक्स्ट करता है, तो Bird संदेश को आपको देने से पहले कीवर्ड की एक कैटलॉग से मिलाता है। एक पहचाना गया stop कीवर्ड उस सेंडर से उस सब्सक्राइबर को भविष्य के संदेश रोक देता है, एक start कीवर्ड यह रोक हटाता है, और help सहायता जानकारी के साथ जवाब देता है। समर्थित देशों में इस व्यवहार के लिए कोई सेटअप ज़रूरी नहीं है।

यह गाइड बताती है कि Bird डिफ़ॉल्ट रूप से क्या करता है, इसे कैसे देखें, और इसे कैसे बदलें।

डिफ़ॉल्ट रूप से क्या होता है

एक सब्सक्राइबर आपके किसी नंबर पर STOP टेक्स्ट करता है। Bird:

उस नंबर के देश की कीवर्ड कैटलॉग से इसे पहचानता है।
उस विशिष्ट सेंडर-और-सब्सक्राइबर जोड़ी पर एक सप्रेशन दर्ज करता है।
उस देश के ऑप्ट-आउट संदेश के साथ जवाब देकर पुष्टि करता है।

इसके बाद, उस सेंडर से उस सब्सक्राइबर को कोई भी संदेश भेजने की बजाय E12077 SMSRecipientSuppressed के साथ अस्वीकार कर दिया जाता है। START सप्रेशन समाप्त करता है और उसकी भी पुष्टि करता है, और HELP बिना कुछ बदले जवाब देता है।

एक सप्रेशन एक सेंडर और एक सब्सक्राइबर को कवर करता है। यह आपके पूरे वर्कस्पेस को कवर नहीं करता। इस ब्लॉक का तकनीकी दायरा किसी अन्य सेंडर का उपयोग करने की अनुमति नहीं देता। ग्राहक की बताई गई प्राथमिकता को उन संदेशों और प्रोग्राम पर लागू करें जिन्हें उन्होंने रोकने के लिए कहा था। वर्कस्पेस में हर सेंडर को एक साथ रोकने के लिए, नीचे हर सेंडर से ऑप्ट-आउट करना देखें।

पुष्टि उस सप्रेशन से छूट प्राप्त है जो वह दर्ज करती है। Bird इनबाउंड संदेश का जवाब दे सकता है भले ही नया सप्रेशन बाद के आउटबाउंड संदेशों को रोक दे।

कवरेज देश के अनुसार है

Bird की कैटलॉग देशों के एक उपसमूह को कवर करती है। जहाँ कोई देश कवर किया गया है, वहाँ Bird डिफ़ॉल्ट रूप से ऑप्ट-आउट, ऑप्ट-इन, और help कीवर्ड संभालता है। जहाँ नहीं है, वहाँ 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 द्वारा जोड़े गए कीवर्ड भी इनहेरिट करता है। आप किसी ऑप्ट-आउट या ऑप्ट-इन कीवर्ड को असाइन किए गए ऑपरेशन को बदल नहीं सकते; Bird ऐसे नियम को अस्वीकार करता है जो STOP को किसी अन्य ऑपरेशन से जोड़ने की कोशिश करता है।

जहाँ 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: सब्सक्राइबर ने stop कीवर्ड टेक्स्ट किया।
carrier_opted_out: उनके कैरियर ने ऑप्ट-आउट की सूचना दी।
manual: API या डैशबोर्ड के माध्यम से जोड़ा गया।

समाप्त हो चुके सप्रेशन सूचीबद्ध नहीं होते, इसलिए रिस्पॉन्स उन प्राप्तकर्ताओं की पहचान करता है जिन्हें आप अभी संदेश नहीं भेज सकते।

ग्राहक ने फ़ोन पर दिया हुआ ऑप्ट-आउट सम्मानित करने के लिए आप स्वयं एक जोड़ सकते हैं:

कोड उदाहरण

bird sms suppressions add --destination +15550001234 --originator +15557654321

मैन्युअल सप्रेशन हर श्रेणी को ब्लॉक करता है, ट्रांज़ैक्शनल सहित, और जोड़ना आइडेम्पोटेंट है। हटाना जानबूझकर सीमित है: केवल manual सप्रेशन को ही इस तरह समाप्त किया जा सकता है। सब्सक्राइबर के अपने stop कीवर्ड और कैरियर के ऑप्ट-आउट को हटाना अस्वीकार कर दिया जाता है, क्योंकि उन्हें पलटने का अधिकार आपका नहीं है।

हर सेंडर से ऑप्ट-आउट करना

एक stop कीवर्ड, और ऊपर बताए गए मैन्युअल सप्रेशन, दोनों एक सेंडर को रोकते हैं। कुछ सब्सक्राइबर वर्कस्पेस के हर सेंडर से एक साथ बाहर होना चाहते हैं, उदाहरण के लिए कोई जो आपकी सपोर्ट टीम को हर नंबर पर अलग-अलग जवाब देने की बजाय सभी टेक्स्ट बंद करने को कहता है।

यह एक बताई गई प्राथमिकता है, सप्रेशन नहीं, इसलिए यह ऊपर की सूची में नहीं बल्कि SMS > Suppressions के Preferences टैब पर रहती है। टैब खोलें और Every sender in the workspace के साथ एक ऑप्ट-आउट दर्ज करें: वह नंबर वर्कस्पेस के हर सेंडर से SMS प्राप्त करना बंद कर देगा, बाद में जोड़े गए सेंडर सहित। इस टैब पर दर्ज किया गया ऑप्ट-आउट सभी संदेशों को कवर करता है, प्रमाणीकरण टेक्स्ट सहित; केवल मार्केटिंग रोकने वाला दर्ज करने के लिए, वर्कस्पेस-व्यापी Contacts > Preferences पेज का उपयोग करें, जिसका डायलॉग कवरेज का विकल्प देता है।

Bird पहले इस गाइड में बताए गए सप्रेशन की जाँच करता है, इसलिए साधारण कीवर्ड stop पहले की तरह E12077 के साथ अस्वीकार करता रहता है। वर्कस्पेस-व्यापी ऑप्ट-आउट दर्ज किसी नंबर पर भेजना E25000 PreferenceRevoked के साथ अस्वीकार किया जाता है। सब्सक्राइबर के अनुरोध पर दोबारा भेजना शुरू करने के लिए, Preferences टैब से एंट्री हटाएँ (आपने इसे दर्ज किया था, इसलिए आप इसे हटा सकते हैं), या वर्कस्पेस-व्यापी Contacts > Preferences पेज पर एक ऑप्ट-इन दर्ज करें।

अगले कदम

ऑडियंस सेंड से पहले कैंपेन सहमति और भेजने के नियंत्रण की समीक्षा करें, या अपने इंटीग्रेशन के लिए SMS ऑप्ट-आउट हैंडलिंग देखें।

SMS भेजना: श्रेणियों, सेंडर, और अस्वीकृति शर्तों की समीक्षा करें।
Events: भेजने और जवाबों के लिए sms.* इवेंट संभालें।
SMS लॉग: किसी संदेश का निरीक्षण करें, अस्वीकृत सेंड सहित।

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