# प्राथमिकताएँ

प्राथमिकता एक कथन है जो बताता है कि कोई व्यक्ति क्या चाहता है, और यह एक चैनल पर उनके हैंडल के विरुद्ध दर्ज होती है। WhatsApp पर हैंडल E.164 फ़ॉर्मेट में एक फ़ोन नंबर होता है। यह [सप्रेशन](/docs/guides/whatsapp/opt-outs/suppressions) से अलग रिकॉर्ड है, और भेजने से पहले दोनों की जाँच की जाती है।

प्राथमिकताएँ आपके वर्कस्पेस तक तीन तरीकों से पहुँचती हैं: WhatsApp एक रिपोर्ट करता है, प्राप्तकर्ता कोई कीवर्ड टाइप करता है, या आप स्वयं एक दर्ज करते हैं। हर एक के बारे में आप क्या कर सकते हैं, यह इस पर निर्भर करता है कि उसे किसने कहा।

## प्राथमिकता में क्या होता है

कोई कथन या तो `revoked`, एक ऑप्ट-आउट, या `granted`, सहमति होता है।

इसमें एक कवरेज भी होता है, जो तय करता है कि यह कितने ट्रैफ़िक को रोकता है। `non_transactional` मार्केटिंग और अन्य गैर-आवश्यक संदेशों को कवर करता है जबकि लेन-देन संबंधी संदेश जैसे रसीदें और सत्यापन कोड चलते रहते हैं। `all` हर संदेश को कवर करता है। **Preferences** टैब इन्हें अपने **Covers** कॉलम में **Non-transactional** और **All messages** के रूप में दिखाता है।

कोई कथन `sender_scope` के साथ एक प्रेषक तक सीमित हो सकता है, जो WhatsApp पर बिज़नेस अकाउंट की पहचान करता है। इसके बिना, कथन आपके पूरे वर्कस्पेस में चैनल को कवर करता है, जिसमें बाद में जोड़े गए अकाउंट भी शामिल हैं।

एक व्यक्ति के पास एक चैनल पर कई पंक्तियाँ हो सकती हैं, जैसे चैनल-व्यापी ऑप्ट-आउट के साथ-साथ प्रेषक-स्कोप्ड ऑप्ट-आउट। सबसे प्रतिबंधात्मक कथन तय करता है कि संदेश भेजा जाएगा या नहीं।

## Bird आपके लिए जो प्राथमिकताएँ दर्ज करता है

जब Bird को कोई Meta इवेंट मिलता है जो बताता है कि प्राप्तकर्ता ने मार्केटिंग संदेश बंद कर दिए हैं, तो यह उस WhatsApp Business Account के लिए एक प्राप्तकर्ता-मूल प्राथमिकता दर्ज करता है। यह प्राथमिकता गैर-लेन-देन संदेशों को कवर करती है। यह सभी-संदेश सप्रेशन नहीं बनाती, और यह व्यक्ति को आपके वर्कस्पेस के हर अकाउंट से ऑप्ट-आउट नहीं करती।

प्राप्तकर्ता `STOP` का जवाब देकर भी यही बात कह सकता है। वह प्राथमिकता उस बिज़नेस अकाउंट तक सीमित होती है जिसे उन्होंने संदेश भेजा था, ठीक ऊपर वाली की तरह। यह सभी संदेशों को कवर करती है, क्योंकि टाइप किया गया `STOP` WhatsApp के मार्केटिंग ऑप्ट-आउट से व्यापक होता है। Bird क्या पहचानता है और जवाब कैसे बदलें, इसके लिए [कीवर्ड नियम](/docs/guides/whatsapp/opt-outs/keyword-rules) देखें।

बाद का रिज़्यूम इवेंट उस अकाउंट की प्राथमिकता को अपडेट करता है। सप्रेशन और अन्य लागू प्राथमिकताएँ फिर भी लागू रहती हैं, इसलिए अकेला रिज़्यूम इवेंट यह साबित नहीं करता कि भेजना योग्य है।

## आपके द्वारा दर्ज की गई प्राथमिकताएँ

[**Suppressions**](https://bird.com/dashboard/w/whatsapp/suppressions) पेज खोलें और **Preferences** टैब पर जाएँ। वहाँ **Every business account in the workspace** के साथ एक दर्ज करने पर वह पता आपके हर अकाउंट से WhatsApp संदेश प्राप्त करना बंद कर देता है, जिसमें बाद में जोड़े गए अकाउंट भी शामिल हैं।

![ऑप्ट-इन या ऑप्ट-आउट करने वाले सब्सक्राइबर्स की सूची, जिसमें प्रत्येक कथन की कवरेज दिखाई गई है](/images/docs/dashboard-whatsapp-preferences.png)

उस टैब पर **Record opt-out** डायलॉग सभी-संदेश कवरेज दर्ज करता है।

![ऑप्ट-आउट रिकॉर्ड करने का डायलॉग, जिसमें वर्कस्पेस-व्यापी स्कोप चुना गया है](/images/docs/dashboard-whatsapp-preference-new.png)

केवल मार्केटिंग रोकने वाली प्राथमिकता दर्ज करने के लिए, वर्कस्पेस-व्यापी **Contacts** > **Preferences** पेज का उपयोग करें, जिसका डायलॉग **All messages** के साथ-साथ **Marketing messages** भी प्रदान करता है।

## कोड से प्राथमिकताएँ पढ़ना

`GET /v1/preferences` वर्कस्पेस की दर्ज प्राथमिकताएँ लौटाता है, सबसे हाल में बनाई गई पहले। इस चैनल तक सीमित करने के लिए `channel=whatsapp` पास करें, और संदेश भेजने से पहले एक नंबर के सभी रिकॉर्ड देखने के लिए इसके साथ `handle` पास करें:

**TypeScript**

```typescript
for await (const preference of bird.preferences.list({
  channel: "whatsapp",
  handle: "+15550001234",
})) {
  console.log(preference.status, preference.coverage, preference.sender_scope);
}
```

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

`handle` को `channel` की आवश्यकता होती है, क्योंकि एक ही हैंडल एक से अधिक चैनल पर मौजूद हो सकता है।

## कोड से प्राथमिकता दर्ज करना

`POST /v1/preferences` एक कथन दर्ज करता है। लिखना चैनल, हैंडल और प्रेषक स्कोप पर आधारित एक अपसर्ट है, इसलिए नया कथन कुंजी के मौजूदा कथन को बदल देता है:

**TypeScript**

```typescript
const result = await bird.preferences.create({
  channel: "whatsapp",
  handle: "+15550001234",
  status: "revoked",
  coverage: "non_transactional",
});
console.log(result.applied, result.preference?.id);
```

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

कथन इस आधार पर क्रमबद्ध होते हैं कि वे कब किए गए, न कि कब पहुँचे। API कुंजी के मौजूदा कथन से पहले की तारीख वाले कथन को अस्वीकार करता है और बचे हुए कथन के साथ `applied: false` लौटाता है। अस्वीकृति कुंजी के इतिहास में बनी रहती है।

`201` का मतलब है कि कुंजी पर कोई रिकॉर्ड नहीं था और इस कथन ने एक बनाया। `200` कुंजी का बचा हुआ रिकॉर्ड लौटाता है, चाहे इस कथन ने उसे बदला हो, दोहराया हो, या अस्वीकृत किया गया हो।

## आप क्या पलट सकते हैं

जो आपने दर्ज की है, उसे प्राप्तकर्ता के भेजना फिर शुरू करने का अनुरोध करने पर आप **Preferences** टैब से या `DELETE /v1/preferences/{preference_id}` से हटा सकते हैं।

जो कथन व्यक्ति ने स्वयं किया है, उसे पलटना उनका अधिकार है। अनसब्सक्राइब या स्टॉप कीवर्ड तब समाप्त होता है जब वे वापस ऑप्ट-इन करते हैं, और डिलीट `422` लौटाता है। उनकी सहमति से संदेश फिर शुरू करने के लिए, `consented_at` के साथ एक `granted` कथन दर्ज करें, जो उनकी सहमति का क्षण होता है। अनुमति तब लागू होती है जब वह क्षण उस ऑप्ट-आउट से बाद का हो जिसे यह पलटता है, इसलिए यह मूल कथन मिटाने के बजाय विचार परिवर्तन दर्ज करता है।

डिलीट किसी भी अन्य कथन की तरह क्रमबद्ध होता है, प्राप्ति के समय के अनुसार। यदि रिकॉर्ड में उस क्षण के बाद का कोई कथन है, तो डिलीट अस्वीकृत कर दिया जाता है और बचे हुए रिकॉर्ड के साथ `applied: false` सहित लौटाया जाता है।

## जब डिलीवरी त्रुटि पहले आती है

प्रदाता डिलीवरी त्रुटि Bird द्वारा मिलान इवेंट दर्ज करने से पहले स्टॉप की रिपोर्ट कर सकती है। प्राप्तकर्ता की पसंद को सुरक्षित रखें और लापता स्थानीय रिकॉर्ड को भेजने की अनुमति मानने के बजाय प्राथमिकता और इवेंट इतिहास की जाँच करें।

## अगले कदम

- [सप्रेशन](/docs/guides/whatsapp/opt-outs/suppressions): वे पते जिन्हें आपका वर्कस्पेस सीधे ब्लॉक करता है।
- [कीवर्ड नियम](/docs/guides/whatsapp/opt-outs/keyword-rules): वे शब्द जो आपके नंबरों पर प्राथमिकता दर्ज करते हैं।
- [WhatsApp इवेंट](/docs/guides/whatsapp/events): ब्लॉक किए गए भेजने से उत्पन्न `whatsapp.rejected` पेलोड।

## 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)