WhatsApp user_preferences वेबहुक: कब ग्राहक मार्केटिंग मैसेज रोकते या फिर से शुरू करते हैं
user_preferences वेबहुक बताता है कि कोई WhatsApp यूज़र “Offers and announcements” सेटिंग के ज़रिए मार्केटिंग मैसेज रोक चुका है या फिर से शुरू कर चुका है। हर इवेंट में कैटेगरी marketing_messages, वैल्यू stop या resume, एक detail वाक्य, यूज़र का wa_id और BSUID, और एक Unix timestamp होता है। इसी सेटिंग में Interested और Not interested वाला फ़ीडबैक इसे ट्रिगर नहीं करता।
easyCoexistence आपके WhatsApp Business ऐप वाले नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है, ताकि आपकी AI और ऑटोमेशन उसी नंबर पर चलें जो आप ऐप में रखते हैं।
प्रेफ़रेंस की वैल्यू: stop और resume, दोनों marketing_messages कैटेगरी में।
उस यूज़र को मार्केटिंग टेम्पलेट भेजने पर मिलने वाला विफल स्टेटस कोड, जिसने आपके मार्केटिंग मैसेज रोक रखे हैं।
Meta user_preferences कहाँ भेजता है: यह वह फ़ील्ड नहीं है जिसे कोई WhatsApp Business Account या नंबर ओवरराइड कर सके।
messages और calls के अलावा अन्य webhooks के लिए ऐप को जो परमिशन चाहिए, उसमें user_preferences भी शामिल है।
कौन सा इवेंट user_preferences वेबहुक ट्रिगर करता है?
जब कोई ग्राहक WhatsApp में “Offers and announcements” खोलकर आपके कारोबार के मार्केटिंग मैसेज रोकने का चुनाव करता है, या बाद में उन्हें फिर से शुरू करता है। सिर्फ़ ये दो कार्रवाइयाँ ट्रिगर हैं। इसी सेटिंग में ग्राहक Interested या Not interested भी चिह्नित कर सकता है, और वह फ़ीडबैक कोई वेबहुक नहीं भेजता। हालाँकि Not interested उस ग्राहक और आपके बीच प्रति-यूज़र मार्केटिंग लिमिट घटा सकता है और एक दूसरी स्क्रीन खोलता है जो सभी मार्केटिंग मैसेज पूरी तरह रोकने की पेशकश करती है। user_preferences तभी फ़ायर होता है जब वह उसके बाद रोकने पर टैप करे।
पेलोड में क्या होता है?
user_preferences नाम के फ़ील्ड में एक user_preferences ऐरे होता है, जिसके साथ contacts ऐरे भी आता है। यहाँ timestamp एक integer है, जबकि status वेबहुक उसे string में भेजते हैं। जब ग्राहक username इस्तेमाल करता है और उसका फ़ोन नंबर साझा नहीं किया जा सकता, तो wa_id छूट जाता है। जब आपके कारोबार के लिए business-scoped user IDs चालू नहीं होते, तो user_id छूट जाता है, और parent BSUIDs चालू न होने पर parent_user_id छूट जाता है। यह Meta का resume वाला उदाहरण है:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824"
}
],
"user_preferences": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824",
"detail": "User requested to resume marketing messages",
"category": "marketing_messages",
"value": "resume",
"timestamp": 1731705721
}
]
},
"field": "user_preferences"
}
]
}
]
}stop मिलने पर आपके सिस्टम को क्या करना चाहिए?
उसे ग्राहक के खाते में दर्ज करें और जब तक resume न आए, हर मार्केटिंग भेजने से बाहर रखें। detail फ़ील्ड में या तो “User requested to stop marketing messages” लिखा होता है या “User requested to resume marketing messages”, लेकिन कोड को value पढ़नी चाहिए।
- प्राथमिकता को BSUID और फ़ोन नंबर दोनों से सहेजें, क्योंकि किसी भी इवेंट में इनमें से कोई एक गायब हो सकता है।
- ग्राहक को मार्केटिंग टेम्पलेट भेजने से बाहर रखें; Meta उन्हें वैसे भी 131050 के साथ रोक देगा।
- प्राथमिकता केवल प्रति ग्राहक लागू करें: Meta कभी भी parent BSUID स्तर पर प्राथमिकता लागू नहीं करता।
- resume मिलने पर बहिष्कार हटा दें, और अपना opt-in रिकॉर्ड रखें जैसा Meta की opt-in नीति माँगती है।
अगर user_preferences कभी आपके सर्वर तक न पहुँचे तो?
Meta फिर भी stop लागू करता है, इसलिए वेबहुक न मिलने पर आपको केवल एक विफल सेंड का नुकसान होता है, नीति का उल्लंघन नहीं। जब आप ऐसे व्यक्ति को मार्केटिंग टेम्पलेट भेजते हैं जिसने रोक रखा है, तो API अनुरोध स्वीकार करता है, मैसेज नहीं भेजता, और status failed, code 131050 तथा शीर्षक “Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business” वाला status वेबहुक भेजता है। इस विफलता को ठीक वैसे ही लें जैसे stop इवेंट लिया जाता है: उसे दर्ज करें और उस ग्राहक को आगे के मार्केटिंग मैसेज भेजना बंद करें।
यह easyCoexistence के ज़रिए जुड़े नंबर पर कैसे काम करता है?
user_preferences उन फ़ील्ड्स में नहीं है जिनके लिए Meta डेस्टिनेशन ओवरराइड की अनुमति देता है, इसलिए Meta इसे केवल उस ऐप के डिफ़ॉल्ट callback पर भेजता है जिसने खाते की सदस्यता ली है। easyCoexistence से जुड़े नंबर के लिए वह ऐप easyCoexistence का है, और वह आज user_preferences सब्सक्राइब नहीं करता। इसलिए इवेंट न सीधे डेस्टिनेशन तक पहुँचता है, न Forward URL तक। 131050 विफल स्टेटस पहुँचता है, क्योंकि वह messages फ़ील्ड पर चलता है।
अगर आपकी AI send_template से मार्केटिंग टेम्पलेट भेजती है, तो stop सूची अपने सिस्टम में रखें और पहले उसे जाँचें: easyCoexistence ऐसी सूची नहीं रखता।
आम गड़बड़ियाँ
- Not interested को stop मानना। यह कोई वेबहुक नहीं भेजता और डिलीवरी नहीं रोकता, हालाँकि उस ग्राहक की प्रति-यूज़र मार्केटिंग लिमिट घटा सकता है।
- सिर्फ़ wa_id से प्राथमिकताएँ तय करना। यह उन ग्राहकों के लिए छूट जाता है जिनका username है और जिनका नंबर साझा नहीं किया जा सकता; BSUID भी सहेजें।
- parent BSUID के तहत सभी पर stop लागू करना। Meta प्राथमिकताएँ प्रति यूज़र लागू करता है, कभी parent स्तर पर नहीं।
- 131050 के बाद दोबारा कोशिश करना, उसे stop के रूप में दर्ज करने की बजाय। हर बार की कोशिश उसी तरह विफल होगी।
इसके ज़रिए भेजे गए मार्केटिंग टेम्पलेट आपके अपने WhatsApp Business Account से जाते हैं, और ग्राहक के रोकने की सूचना देने वाले विफल स्टेटस सीधे आपके सर्वर तक या साइन किए हुए फ़ॉरवर्ड के रूप में पहुँचते हैं। US$ 9 से US$ 0.75 तक प्रति नंबर प्रति माह, जैसे-जैसे आप नंबर जोड़ते हैं कीमत घटती है, और पहले 3 दिन मुफ़्त हैं।
अक्सर पूछे जाने वाले सवाल
क्या stop ग्राहक के अपने मैसेज के जवाबों को भी रोकता है?
Meta के दस्तावेज़ बताते हैं कि stop मार्केटिंग मैसेज पर लागू होता है, और लौटाई गई गड़बड़ी भी मार्केटिंग मैसेज का नाम लेती है। जिस ग्राहक ने आपको लिखा है, उसके मैसेज के जवाब सर्विस मैसेज हैं, जो एक अलग कैटेगरी है।
क्या बिज़नेस को ब्लॉक करने से user_preferences ट्रिगर होता है?
नहीं। वेबहुक केवल “Offers and announcements” सेटिंग में stop और resume पर ट्रिगर होता है। ब्लॉक करना एक अलग कार्रवाई है और इस फ़ील्ड पर उसकी रिपोर्ट नहीं होती।
क्या resume को opt-in माना जाता है?
इसका मतलब है कि ग्राहक ने आपके मार्केटिंग मैसेज दोबारा पाने का चुनाव किया। Meta की नीति के तहत आपकी अपनी opt-in ज़िम्मेदारियाँ फिर भी लागू होती हैं, इसलिए रिकॉर्ड रखें कि उस ग्राहक ने कैसे और कब आपसे सुनने की सहमति दी थी।
मुझे कौन सा वेबहुक फ़ील्ड सब्सक्राइब करना है?
user_preferences, App Dashboard में WhatsApp > Configuration के अंतर्गत, उस ऐप पर जो WhatsApp Business Account पर सब्सक्राइब है। यह messages से अलग फ़ील्ड है और इसे whatsapp_business_management चाहिए।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित