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

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

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

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

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

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

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

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

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

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

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

किसी देश पर निर्भर होने से पहले जाँचें कि वहाँ क्या उपलब्ध है:

```bash
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 के डिफ़ॉल्ट जवाब सही हैं लेकिन सामान्य हैं। अपने नाम से जवाब देने के लिए, उस देश और ऑपरेशन के लिए एक नियम बनाएँ:

```bash
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 एक ही भाषा में रखता है, वहाँ अस्वीकार कर दिया जाता है।

```bash
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 या डैशबोर्ड के माध्यम से जोड़ा गया।

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

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

```bash
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`](/docs/api/errors/E25000) के साथ अस्वीकार किया जाता है। सब्सक्राइबर के अनुरोध पर दोबारा भेजना शुरू करने के लिए, Preferences टैब से एंट्री हटाएँ (आपने इसे दर्ज किया था, इसलिए आप इसे हटा सकते हैं), या वर्कस्पेस-व्यापी **Contacts** > **Preferences** पेज पर एक ऑप्ट-इन दर्ज करें।

## अगले कदम

ऑडियंस सेंड से पहले [कैंपेन सहमति और भेजने के नियंत्रण](/products/sms/marketing/compliance) की समीक्षा करें, या अपने इंटीग्रेशन के लिए [SMS ऑप्ट-आउट हैंडलिंग](/products/sms/compliance/opt-out) देखें।

- [SMS भेजना](/docs/guides/sms/sending-sms): श्रेणियों, सेंडर, और अस्वीकृति शर्तों की समीक्षा करें।
- [Events](/docs/guides/sms/events): भेजने और जवाबों के लिए `sms.*` इवेंट संभालें।
- [SMS लॉग](/docs/guides/sms/sms-log): किसी संदेश का निरीक्षण करें, अस्वीकृत सेंड सहित।

## Related resources

- [How do I collect SMS opt-ins?](/explained/sms/how-do-i-collect-sms-opt-ins) (answer)
- [Preview message segments](/tools/sms-segment-calculator) (tool)
- [SMS compliance](/sms-api/features/compliance) (product)
- [Operate messaging reliably](/learn/paths/reliability) (course)

[Get an implementation brief](/learn/workspace?topic=consent)