# कीवर्ड नियम

Bird कीवर्ड कैटलॉग के साथ आता है, इसलिए जो प्राप्तकर्ता आपके इनबाउंड-सक्षम नंबरों में से किसी पर `STOP` का जवाब देता है, वह बिना किसी सेटअप के ऑप्ट आउट हो जाता है। `START` इसे उलट देता है। आपका अपना नियम उस दायरे के लिए Bird के डिफ़ॉल्ट को ओवरराइड करता है।

यह पेज बताता है कि Bird क्या पहचानता है, इनबाउंड संदेश का मिलान कैसे होता है, और शब्द कैसे बदलें या कीवर्ड कैसे जोड़ें। [**Keywords**](https://bird.com/dashboard/w/whatsapp/keyword-rules) पेज इसका डैशबोर्ड समकक्ष है।

![कीवर्ड नियमों की सूची, जिसमें वर्कस्पेस नियम उन डिफ़ॉल्ट नियमों के ऊपर दिखाए गए हैं जिन्हें वे ओवरराइड करते हैं](/images/docs/dashboard-whatsapp-keyword-rules.png)

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

नौ शब्द ऑप्ट-आउट दर्ज करते हैं:

`stop`, `stop all`, `stopall`, `unsubscribe`, `cancel`, `end`, `quit`, `revoke`, `optout`

दो इसे उलटते हैं: `start` और `unstop`।

मिलान पूरे संदेश पर होता है, सबस्ट्रिंग पर नहीं। चूँकि `cancel` और `end` कीवर्ड हैं, यह अंतर मायने रखता है: "cancel my 3pm delivery" एक सामान्य संदेश है, सहमति वापसी नहीं। अक्षर केस, एक्सेंट, दोहराए गए स्पेस और अंत का विराम चिह्न नज़रअंदाज़ किए जाते हैं, इसलिए `Stop!` और `STOP` दोनों मिलान करते हैं। शब्द से पहले या अंदर का विराम चिह्न नज़रअंदाज़ नहीं किया जाता, इसलिए `#stop` मिलान नहीं करता।

## जहाँ कीवर्ड का मिलान नहीं होता

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

## प्राथमिकता कब दर्ज होती है

वर्गीकरण `whatsapp.received` इवेंट के साथ चलता है, उससे पहले नहीं। इसलिए उस इवेंट को देखने वाला इंटीग्रेशन `STOP` को उसकी दर्ज प्राथमिकता बनने से पहले आते देख सकता है। अगर आपका हैंडलर इनबाउंड संदेश पर कुछ भेजकर प्रतिक्रिया करता है, तो इवेंट क्रम मानने के बजाय प्राप्तकर्ता के रिकॉर्ड दोबारा पढ़ें।

## क्या लागू होता है, यह देखना

`GET /v1/whatsapp/keyword-rules` बताता है कि आपके नंबरों पर जवाबों को कैसे संभाला जाता है। बिना फ़िल्टर के, यह Bird का कैटलॉग आपके बनाए नियमों के साथ लौटाता है। `country`, `waba`, `operation`, या `scope` से इसे सीमित करें:

- `scope=system` Bird का कैटलॉग लौटाता है, जिसमें वह डिफ़ॉल्ट भी शामिल है जिसे आपका नियम ओवरराइड करता है।
- `scope=workspace` आपके अपने नियम लौटाता है।

**TypeScript**

```typescript
const rules = await bird.whatsapp.keywordRules.list({ operation: "opt_out" });
for (const rule of rules.data ?? []) {
  console.log(rule.scope, rule.effective_keywords);
}
```

Examples: [TypeScript](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.ts.md) · [Python](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.py.md) · [Go](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.go.md) · [PHP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.php.md) · [CLI](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.cli.md) · [MCP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.mcp.md) · [cURL](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.curl.md)

नियम सबसे विशिष्ट पहले लौटते हैं, और यही वह क्रम है जिसमें इनबाउंड संदेश का उनसे मिलान होता है। हर नियम में `effective_keywords` होता है: उस ऑपरेशन और देश के लिए Bird का सेट, और जो कुछ आपने जोड़ा है।

बिना `country` वाले आपके नियम के लिए, `effective_keywords` Bird का विश्वव्यापी सेट दिखाता है, क्योंकि नियम में कोई देश नहीं है और संदेश आने तक भेजने वाले का देश अज्ञात रहता है। वह नियम भेजने वाले के देश के लिए Bird के सेट से मिलान करता है, जो बड़ा सेट हो सकता है। ठीक-ठीक देखने के लिए कि वे भेजने वाले किससे मिलान करते हैं, अपने नियम पर `country` सेट करें।

`country` भेजने वाले का देश है, जो उनके अपने फ़ोन नंबर से निकाला जाता है, न कि जिस नंबर पर उन्होंने संदेश भेजा। यही वह देश सिग्नल है जो WhatsApp भेजता है। बिज़नेस-स्कोप्ड यूज़र ID से पहचाने गए भेजने वाले के पास कोई देश नहीं होता, इसलिए उनका संदेश देश-स्कोप्ड नियमों को छोड़कर विश्वव्यापी नियम से मिलान करता है।

## जवाब बदलना

Bird के डिफ़ॉल्ट जवाब सही हैं लेकिन सामान्य हैं। अपने नाम से जवाब देने के लिए एक नियम बनाएँ:

**TypeScript**

```typescript
const rule = await bird.whatsapp.keywordRules.create({
  operation: "opt_out",
  country: "US", // the SENDER's country, from their own number
  reply: "You're off the list. ACME Courier won't message you again.",
});
// effective_keywords is Bird's set plus any of your own.
console.log(rule.id, rule.effective_keywords);
```

Examples: [TypeScript](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.ts.md) · [Python](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.py.md) · [Go](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.go.md) · [PHP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.php.md) · [CLI](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.cli.md) · [MCP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.mcp.md) · [cURL](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.curl.md)

आपका नियम उस दायरे के लिए Bird के जवाब को बदल देता है और Bird के कीवर्ड रखता है। आपके `keywords` प्रतिस्थापन नहीं बल्कि अतिरिक्त हैं, इसलिए बाद में Bird जो कीवर्ड जोड़ता है वह आपकी ओर से बिना किसी बदलाव के मिलान करना शुरू कर देता है।

ऑप्ट-आउट दर्ज करते हुए कुछ न भेजने के लिए, नियम बनाते समय `reply` छोड़ दें। किसी मौजूदा नियम को शांत करने के लिए, नीचे दिए गए अपडेट पर JSON बॉडी में `reply` को `null` सेट करें; CLI फ़्लैग `null` नहीं ले सकता।

![कीवर्ड नियम जोड़ने का डायलॉग, जिसमें अतिरिक्त कीवर्ड और जवाब के लिए फ़ील्ड हैं](/images/docs/dashboard-whatsapp-keyword-rule-dialog.png)

## अपने कीवर्ड जोड़ना

**TypeScript**

```typescript
// Omitting keywords leaves the set alone; an empty array clears your additions
// back to Bird's. reply: null switches the auto-reply off and still records
// the opt-out.
const rule = await bird.whatsapp.keywordRules.update("wkr_01m2kj8x4te9p0rr7e5w2n1abc", {
  keywords: ["no more texts", "remove me"],
});
console.log(rule.effective_keywords);
```

Examples: [TypeScript](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.ts.md) · [Python](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.py.md) · [Go](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.go.md) · [PHP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.php.md) · [CLI](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.cli.md) · [MCP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.mcp.md) · [cURL](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.curl.md)

`keywords` छोड़ने पर आपके अतिरिक्त कीवर्ड वैसे ही रहते हैं। खाली array भेजने पर वे Bird के सेट पर वापस आ जाते हैं।

## नियम का दायरा और डुप्लिकेट

एक नियम `waba` के साथ एक WhatsApp Business Account तक, `country` के साथ एक भेजने वाले के देश तक, दोनों तक, या किसी तक भी सीमित नहीं हो सकता। ऑपरेशन, देश और अकाउंट के हर संयोजन के लिए आपके पास एक नियम होता है। उसी संयोजन के लिए दूसरा लिखने पर डुप्लिकेट त्रुटि आती है।

Bird ऐसे नियम को अस्वीकार करता है जो `stop` को `opt_in` से जोड़ता है, चाहे वह शब्द Bird के कैटलॉग से आया हो या आपके किसी अन्य नियम से, ताकि कोई ऑप्ट-आउट शब्द सहमति देने के लिए नहीं बनाया जा सके।

## नियम हटाना

आपका नियम हटाने पर वह दायरा मिलान क्रम में अगले नियम को मिलता है, जो हमेशा आपका नहीं होता। क्रम इस प्रकार है:

1. अकाउंट और देश के लिए आपका नियम।
2. अकाउंट के लिए आपका नियम।
3. देश के लिए आपका नियम।
4. भेजने वाले के देश के लिए Bird का नियम।
5. आपका विश्वव्यापी नियम।
6. Bird का विश्वव्यापी नियम।

किसी देश के लिए आपका नियम हटाने पर वह दायरा आपके विश्वव्यापी नियम से पहले उस देश के लिए Bird के नियम को मिलता है:

**TypeScript**

```typescript
// The next rule in the ladder answers the scope, which is another rule of yours if you hold a less specific one; STOP never stops working.
await bird.whatsapp.keywordRules.delete("wkr_01m2kj8x4te9p0rr7e5w2n1abc");
```

Examples: [TypeScript](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.ts.md) · [Python](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.py.md) · [Go](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.go.md) · [PHP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.php.md) · [CLI](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.cli.md) · [MCP](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.mcp.md) · [cURL](/hi-in/dastavez/guides/whatsapp/opt-outs/keyword-rules.curl.md)

नियम हटाने से `STOP` काम करना बंद नहीं करता। यह शब्दों और कीवर्ड सेट को उस क्रम में अगले नियम पर लौटा देता है।

## अगले कदम

- [प्राथमिकताएँ](/docs/guides/whatsapp/opt-outs/preferences): कीवर्ड से बनने वाले रिकॉर्ड, और उनमें से किन्हें आप उलट सकते हैं।
- [दमन](/docs/guides/whatsapp/opt-outs/suppressions): वे पते जिन्हें आपका वर्कस्पेस सीधे ब्लॉक करता है।
- [SMS के लिए ऑप्ट-आउट और कीवर्ड](/docs/guides/sms/opt-outs-and-keywords): दूसरे चैनल पर वही तंत्र, जिसमें help और campaign कीवर्ड भी शामिल हैं।

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

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