प्राथमिकताएँ
प्राथमिकता एक कथन है जो बताता है कि कोई व्यक्ति क्या चाहता है, और यह एक चैनल पर उनके हैंडल के विरुद्ध दर्ज होती है। WhatsApp पर हैंडल E.164 फ़ॉर्मेट में एक फ़ोन नंबर होता है। यह सप्रेशन से अलग रिकॉर्ड है, और भेजने से पहले दोनों की जाँच की जाती है।
प्राथमिकताएँ आपके वर्कस्पेस तक तीन तरीकों से पहुँचती हैं: 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 क्या पहचानता है और जवाब कैसे बदलें, इसके लिए कीवर्ड नियम देखें।
बाद का रिज़्यूम इवेंट उस अकाउंट की प्राथमिकता को अपडेट करता है। सप्रेशन और अन्य लागू प्राथमिकताएँ फिर भी लागू रहती हैं, इसलिए अकेला रिज़्यूम इवेंट यह साबित नहीं करता कि भेजना योग्य है।
आपके द्वारा दर्ज की गई प्राथमिकताएँ
Suppressions पेज खोलें और Preferences टैब पर जाएँ। वहाँ Every business account in the workspace के साथ एक दर्ज करने पर वह पता आपके हर अकाउंट से WhatsApp संदेश प्राप्त करना बंद कर देता है, जिसमें बाद में जोड़े गए अकाउंट भी शामिल हैं।

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

केवल मार्केटिंग रोकने वाली प्राथमिकता दर्ज करने के लिए, वर्कस्पेस-व्यापी Contacts > Preferences पेज का उपयोग करें, जिसका डायलॉग All messages के साथ-साथ Marketing messages भी प्रदान करता है।
कोड से प्राथमिकताएँ पढ़ना
GET /v1/preferences वर्कस्पेस की दर्ज प्राथमिकताएँ लौटाता है, सबसे हाल में बनाई गई पहले। इस चैनल तक सीमित करने के लिए channel=whatsapp पास करें, और संदेश भेजने से पहले एक नंबर के सभी रिकॉर्ड देखने के लिए इसके साथ handle पास करें:
for await (const preference of bird.preferences.list({
channel: "whatsapp",
handle: "+15550001234",
})) {
console.log(preference.status, preference.coverage, preference.sender_scope);
}for preference in client.preferences.list(channel="whatsapp", handle="+15550001234"):
print(preference.status, preference.coverage, preference.sender_scope)for pref, err := range client.Preferences.List(context.Background(), bird.PreferencesListParams{
Channel: bird.PreferenceChannelWhatsapp,
Handle: "+15550001234",
}) {
if err != nil {
log.Fatal(err)
}
fmt.Println(*pref.Status, *pref.Coverage)
}foreach ($bird->preferences->list(['channel' => 'whatsapp', 'handle' => '+15550001234']) as $preference) {
echo $preference->getStatus(), ' ', $preference->getCoverage(), PHP_EOL;
}bird preferences list --channel whatsapp --handle +15550001234curl "https://us1.platform.bird.com/v1/preferences?channel=whatsapp&handle=%2B15550001234" \
-H "Authorization: Bearer $BIRD_API_KEY"handle को channel की आवश्यकता होती है, क्योंकि एक ही हैंडल एक से अधिक चैनल पर मौजूद हो सकता है।
कोड से प्राथमिकता दर्ज करना
POST /v1/preferences एक कथन दर्ज करता है। लिखना चैनल, हैंडल और प्रेषक स्कोप पर आधारित एक अपसर्ट है, इसलिए नया कथन कुंजी के मौजूदा कथन को बदल देता है:
const result = await bird.preferences.create({
channel: "whatsapp",
handle: "+15550001234",
status: "revoked",
coverage: "non_transactional",
});
console.log(result.applied, result.preference?.id);result = client.preferences.create(
channel="whatsapp",
handle="+15550001234",
status="revoked",
coverage="non_transactional",
)
print(result.applied, result.preference.id)result, err := client.Preferences.Create(context.Background(), bird.PreferencesCreateParams{
Channel: bird.PreferenceChannelWhatsapp,
Handle: "+15550001234",
Status: bird.PreferenceStatusRevoked,
Coverage: bird.PreferenceCoverageNonTransactional,
})
if err != nil {
log.Fatal(err)
}
// A newer statement already on file answers Applied false instead of an
// error, with the surviving statement in Preference.
if result.Applied != nil && *result.Applied {
fmt.Println("opt-out recorded")
}$result = $bird->preferences->create(
channel: 'whatsapp',
handle: '+15550001234',
status: 'revoked',
coverage: 'non_transactional',
);
echo var_export($result->getApplied(), true);bird preferences create \
--channel whatsapp \
--handle +15550001234 \
--status revoked \
--coverage non_transactionalcurl -X POST https://us1.platform.bird.com/v1/preferences \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"channel":"whatsapp","handle":"+15550001234","status":"revoked","coverage":"non_transactional"}'कथन इस आधार पर क्रमबद्ध होते हैं कि वे कब किए गए, न कि कब पहुँचे। API कुंजी के मौजूदा कथन से पहले की तारीख वाले कथन को अस्वीकार करता है और बचे हुए कथन के साथ applied: false लौटाता है। अस्वीकृति कुंजी के इतिहास में बनी रहती है।
201 का मतलब है कि कुंजी पर कोई रिकॉर्ड नहीं था और इस कथन ने एक बनाया। 200 कुंजी का बचा हुआ रिकॉर्ड लौटाता है, चाहे इस कथन ने उसे बदला हो, दोहराया हो, या अस्वीकृत किया गया हो।
आप क्या पलट सकते हैं
जो आपने दर्ज की है, उसे प्राप्तकर्ता के भेजना फिर शुरू करने का अनुरोध करने पर आप Preferences टैब से या DELETE /v1/preferences/{preference_id} से हटा सकते हैं।
जो कथन व्यक्ति ने स्वयं किया है, उसे पलटना उनका अधिकार है। अनसब्सक्राइब या स्टॉप कीवर्ड तब समाप्त होता है जब वे वापस ऑप्ट-इन करते हैं, और डिलीट 422 लौटाता है। उनकी सहमति से संदेश फिर शुरू करने के लिए, consented_at के साथ एक granted कथन दर्ज करें, जो उनकी सहमति का क्षण होता है। अनुमति तब लागू होती है जब वह क्षण उस ऑप्ट-आउट से बाद का हो जिसे यह पलटता है, इसलिए यह मूल कथन मिटाने के बजाय विचार परिवर्तन दर्ज करता है।
डिलीट किसी भी अन्य कथन की तरह क्रमबद्ध होता है, प्राप्ति के समय के अनुसार। यदि रिकॉर्ड में उस क्षण के बाद का कोई कथन है, तो डिलीट अस्वीकृत कर दिया जाता है और बचे हुए रिकॉर्ड के साथ applied: false सहित लौटाया जाता है।
जब डिलीवरी त्रुटि पहले आती है
प्रदाता डिलीवरी त्रुटि Bird द्वारा मिलान इवेंट दर्ज करने से पहले स्टॉप की रिपोर्ट कर सकती है। प्राप्तकर्ता की पसंद को सुरक्षित रखें और लापता स्थानीय रिकॉर्ड को भेजने की अनुमति मानने के बजाय प्राथमिकता और इवेंट इतिहास की जाँच करें।
अगले कदम
- सप्रेशन: वे पते जिन्हें आपका वर्कस्पेस सीधे ब्लॉक करता है।
- कीवर्ड नियम: वे शब्द जो आपके नंबरों पर प्राथमिकता दर्ज करते हैं।
- WhatsApp इवेंट: ब्लॉक किए गए भेजने से उत्पन्न whatsapp.rejected पेलोड।
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंConnecting WhatsApp to Bird: from buying a number to a live channelकॉन्सेप्ट समझेंWhat is the 24-hour customer service window on WhatsApp?टूल का उपयोग करेंWhatsApp message builderक्षमता जानेंWhatsApp
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ