WhatsApp यूज़रनेम और कारोबार-सीमित यूज़र ID (BSUID): Cloud API वेबहुक में क्या बदलता है
WhatsApp यूज़रनेम उपयोगकर्ताओं को फ़ोन नंबर की जगह एक नाम दिखाने देते हैं, इसलिए अप्रैल 2026 की शुरुआत से Cloud API के messages वेबहुक में user_id और from_user_id में कारोबार-सीमित यूज़र ID (BSUID) भी आती है, जैसे US.13491208655302741918। जिस उपयोगकर्ता का यूज़रनेम है, जिसका 30 दिनों में इस नंबर से कोई मैसेज या कॉल नहीं हुआ और जो कॉन्टैक्ट बुक में नहीं है, उसके लिए wa_id और from छोड़ दिए जाते हैं।
easyCoexistence, Coexistence के ज़रिए WhatsApp Business ऐप नंबर को Cloud API से जोड़ता है और उसके messages व smb_message_echoes वेबहुक, BSUID फ़ील्ड समेत, Meta जैसे भेजता है वैसे ही आपके एंडपॉइंट पर रूट करता है, जबकि get_api_credentials आपके कोड को वह देता है जो recipient के साथ जवाब देने के लिए चाहिए।
BSUID पहली बार Cloud API वेबहुक में कब आने लगे, यूज़रनेम के WhatsApp उपयोगकर्ताओं तक पहुँचने से पहले।
एपीआई ने BSUID पर भेजे गए मैसेज स्वीकार करना कब शुरू किया, जिन्हें to के बजाय recipient में रखा जाता है।
प्रति कारोबारी फ़ोन नंबर लुकबैक अवधि, जिसमें उपयोगकर्ता के साथ कोई भी मैसेज या कॉल उसका नंबर वेबहुक में बनाए रखता है।
BSUID के दो-अक्षरीय देश कोड और पीरियड के बाद सबसे ज़्यादा अल्फ़ान्यूमेरिक अक्षर।
Messages API गड़बड़ी: Business-scoped User ID (BSUID) recipients are not supported for this message.
BSUID बदलाव का सिस्टम मैसेज टाइप, जो फ़ोन नंबर के बिना रिपोर्ट होता है, पुराना BSUID previous_user_id में।
WhatsApp यूज़रनेम और BSUID क्या हैं?
यूज़रनेम एक वैकल्पिक, अनोखा नाम है जो WhatsApp उपयोगकर्ता सेट कर सकता है, और ऐप में फ़ोन नंबर की जगह दिखता है; Meta 2026 में यूज़रनेम धीरे-धीरे लागू कर रहा है। BSUID वह बैकएंड पहचानकर्ता है जो Meta ने जोड़ा ताकि कारोबार फिर भी उपयोगकर्ताओं को अलग-अलग पहचान सकें: यह अपने आप बनता है, हर कारोबार पोर्टफ़ोलियो और उपयोगकर्ता की जोड़ी के लिए अनोखा होता है, और ISO 3166 के दो-अक्षरीय देश कोड, एक पीरियड और अधिकतम 128 अल्फ़ान्यूमेरिक अक्षरों के रूप में लिखा जाता है। Meta पार्टनर और सीधे इंटीग्रेट किए गए कारोबारों से इसे सपोर्ट करने की माँग करता है, क्योंकि कोई भी कारोबार यह नियंत्रित नहीं करता कि उसके उपयोगकर्ता यूज़रनेम अपनाते हैं या नहीं।
कौन-से फ़ील्ड नई पहचान रखते हैं?
नई प्रॉपर्टी उन फ़ील्ड के साथ आती हैं जिनमें फ़ोन नंबर था, messages, status, system और user_preferences वेबहुक में। पैरेंट फ़ील्ड केवल उन कारोबार पोर्टफ़ोलियो में दिखते हैं जिन्हें Meta ने पैरेंट BSUID में नामांकित किया है, जो नामांकित पोर्टफ़ोलियो के पार काम करते हैं:
फ़ोन नंबर कब छोड़ा जाता है?
जब उपयोगकर्ता का यूज़रनेम हो और Meta की तीन में से कोई भी शर्त पूरी न हो। नंबर वेबहुक में तब बना रहता है जब कारोबारी फ़ोन नंबर ने पिछले 30 दिनों में उस उपयोगकर्ता के नंबर को मैसेज किया या कॉल किया, उस दौरान उससे मैसेज या कॉल मिला, या उपयोगकर्ता पोर्टफ़ोलियो की कॉन्टैक्ट बुक में है। 30 दिनों की लुकबैक प्रति कारोबारी फ़ोन नंबर गिनी जाती है, इसलिए उसी पोर्टफ़ोलियो का दूसरा नंबर उसी उपयोगकर्ता के लिए केवल BSUID पा सकता है। बिना यूज़रनेम वाले उपयोगकर्ता अपने फ़ोन नंबर और BSUID दोनों के साथ आते रहते हैं।
आने वाला मैसेज अब कैसा दिखता है?
पहले जैसा, BSUID फ़ोन नंबर के साथ या उसकी जगह। Meta के उदाहरण में, जिस उपयोगकर्ता का यूज़रनेम है और नंबर साझा नहीं किया जा सकता, उसके लिए contacts में profile.name, profile.username और user_id होते हैं, और मैसेज में जहाँ पहले from था वहाँ from_user_id होता है:
{
"object": "whatsapp_business_account",
"entry": [{
"id": "102290129340398",
"changes": [{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" },
"contacts": [{
"profile": { "name": "Sheena Nelson", "username": "realsheenanelson" },
"user_id": "US.13491208655302741918"
}],
"messages": [{
"from_user_id": "US.13491208655302741918",
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=",
"timestamp": "1749416383",
"type": "text",
"text": { "body": "Does it come in another color?" }
}]
}
}]
}]
}स्टेटस वेबहुक कैसे बदलते हैं?
भेजे गए, डिलीवर हुए और पढ़े गए स्टेटस में contacts ऐरे जुड़ता है, जिसमें उपयोगकर्ता का नाम, user_id, और नंबर साझा किया जा सके तो wa_id होता है; delivered और read पर username भी। statuses में recipient_user_id BSUID रखता है, और जब आपने BSUID पर भेजा और नंबर साझा नहीं किया जा सकता, तो recipient_id छोड़ दिया जाता है। विफल स्टेटस में contacts ऐरे नहीं होता, और जब मैसेज फ़ोन नंबर पर गया था तो recipient_user_id भी नहीं होता, इसलिए विफलताओं को मैसेज ID से जोड़ें।
उपयोगकर्ताओं को कैसे स्टोर और मैच करें?
पहले BSUID से, और फ़ोन नंबर दूसरी की के रूप में जब भी वह आए। पूरा BSUID एक स्ट्रिंग के रूप में स्टोर करें, देश कोड और पीरियड समेत, क्योंकि Meta ऐसे अनुरोध अस्वीकार करता है जिनमें इसका कोई भी हिस्सा बदला गया हो; और अगर आपके पोर्टफ़ोलियो नामांकित हैं तो पैरेंट BSUID भी स्टोर करें। मौजूदा रिकॉर्ड को wa_id पर जोड़ें, जब तक वह आता है, और BSUID उनके साथ रखें, क्योंकि जो उपयोगकर्ता बाद में यूज़रनेम अपनाता है वह बिना नंबर के लौट सकता है। Meta का FAQ CRM और उन टूल में यही मिलान माँगता है जिन्हें CRM डेटा भेजते हैं।
जब उपयोगकर्ता फ़ोन नंबर बदलता है तो क्या होता है?
उसका BSUID फिर से बनता है, और बदलाव messages फ़ील्ड पर सिस्टम मैसेज के रूप में आता है, क्योंकि Meta के पास सब्सक्राइब करने के लिए कोई user_id_update फ़ील्ड नहीं है। system.type user_changed_number होता है जब नया नंबर आपके साथ साझा किया जा सके, या user_changed_user_id जब केवल BSUID बदलाव रिपोर्ट किया जा सके; system.user_id नया BSUID रखता है और system.previous_user_id पुराना, जिससे रिकॉर्ड नए BSUID पर आगे बढ़ता है। दोनों टाइप संभालें।
केवल BSUID से जाने जाने वाले उपयोगकर्ता को कैसे जवाब दें?
/<BUSINESS_PHONE_NUMBER_ID>/messages पर भेजें, recipient को BSUID पर सेट करके और to को छोड़कर; दोनों हों तो to को प्राथमिकता मिलती है और जवाब फ़ोन नंबर पर जाता है। तब जवाब की contacts प्रविष्टि में wa_id की जगह input और user_id होते हैं। वन-टैप, ज़ीरो-टैप और कॉपी कोड ऑथेंटिकेशन टेम्पलेट को छोड़कर कोई भी मैसेज टाइप काम करता है, क्योंकि उन्हें फ़ोन नंबर चाहिए, और BSUID तक केवल उसी कारोबार पोर्टफ़ोलियो के नंबर पहुँच सकते हैं। गड़बड़ी कोड 131062 का मतलब है कि वह मैसेज टाइप BSUID को recipient के रूप में स्वीकार नहीं करता।
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"recipient": "US.13491208655302741918",
"type": "text",
"text": { "body": "Yes, it also comes in blue." }
}उपयोगकर्ता से फ़ोन नंबर कैसे माँगें?
REQUEST_CONTACT_INFO बटन के साथ, जो utility या marketing टेम्पलेट में जोड़ा जाता है या type request_contact_info वाले इंटरैक्टिव मैसेज के रूप में भेजा जाता है। जो उपयोगकर्ता उसे टैप करता है वह थ्रेड में अपना नंबर साझा करता है, और contacts वेबहुक आता है जिसमें origin contact_request पर सेट होता है और नंबर phones[].wa_id में होता है; हाथ से साझा किया गया कॉन्टैक्ट origin other और vCard के साथ आता है। Meta ने यह बटन जुलाई 2026 की शुरुआत में उपलब्ध कराया, और इसका लेबल बदला नहीं जा सकता।
कॉन्टैक्ट बुक क्या है?
हर कारोबार पोर्टफ़ोलियो के लिए Meta द्वारा होस्ट किया गया एक स्टोर, जिसमें इंटीग्रेशन का कोई काम नहीं करना पड़ता: जैसे ही कारोबारी फ़ोन नंबर किसी उपयोगकर्ता के फ़ोन नंबर को मैसेज करता है, कॉल करता है या उससे मैसेज या कॉल पाता है, वह नंबर और BSUID दर्ज हो जाते हैं, और बाद के वेबहुक में फ़ोन नंबर भरने के लिए इस्तेमाल होते हैं, यूज़रनेम हो या न हो। केवल इसके लॉन्च के बाद की बातचीत गिनी जाती है। इसे Meta Business Suite में Business सेटिंग, फिर Business info से बंद किया जा सकता है, जिससे इसमें रखा डेटा मिट जाता है; और bsuid के साथ GET या DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book किसी एक प्रविष्टि को जाँचता या हटाता है।
Coexistence इंटीग्रेशन में क्या बदलना चाहिए?
उन तीन वेबहुक को संभालने का तरीका जो केवल Coexistence नंबर को मिलते हैं, और वे भी बदलते हैं। history में हर थ्रेड को wa_id, user_id और username वाला context ऑब्जेक्ट मिलता है, और उसके मैसेज को from_user_id मिलता है। smb_message_echoes में contacts ऐरे जुड़ता है, और message_echoes[].to छोड़ा जा सकता है जबकि to_user_id BSUID रखता है; WhatsApp Business ऐप में किए गए एडिट और रिवोक इसी तरह आते हैं। smb_app_state_sync में किसी कॉन्टैक्ट का phone_number छोड़ा जा सकता है, उसके साथ user_id और username होते हैं। echoes और इम्पोर्ट की गई चैट को नंबर के साथ user_id पर भी मैच करें।
उपयोगकर्ता यूज़रनेम अपनाने से पहले कैसे टेस्ट करें?
Meta के टेस्ट टूल से App Dashboard में: Use cases, Connect with customers through WhatsApp, Customize, Configuration के अंतर्गत, messages वेबहुक के बगल का Test लिंक आपके एंडपॉइंट पर सैंपल भेजता है। यह चार स्थितियों में आने वाले मैसेज और स्टेटस को कवर करता है:
- यूज़रनेम के बिना उपयोगकर्ता: BSUID और फ़ोन नंबर फ़ील्ड, और कोई यूज़रनेम नहीं।
- यूज़रनेम वाला उपयोगकर्ता जिसका नंबर उपलब्ध नहीं: यूज़रनेम और BSUID, फ़ोन नंबर फ़ील्ड नहीं।
- यूज़रनेम वाला उपयोगकर्ता जिसका नंबर उपलब्ध है: यूज़रनेम, BSUID और फ़ोन नंबर।
- पैरेंट BSUID में नामांकित पोर्टफ़ोलियो: पोर्टफ़ोलियो के अपने BSUID के साथ एक पैरेंट BSUID।
easyCoexistence BSUID कैसे संभालता है?
यह उन्हें वैसे ही आगे भेजता है जैसे Meta भेजता है। set_webhook_destination से आपके एंडपॉइंट पर रूट किया गया नंबर अपने messages और smb_message_echoes वेबहुक सीधे Meta से पाता है, जिनमें user_id, from_user_id, to_user_id और username शामिल हैं; और ऑटोमेशन या फ़ॉरवर्डिंग चालू होने पर easyCoexistence Meta से आई वैल्यू को बिना बदले आगे भेजता है। BSUID पर जवाब देने के लिए आपका कोड get_api_credentials इस्तेमाल करता है, जो नंबर की फ़ोन नंबर ID, उसका send एंडपॉइंट और उपलब्ध होने पर आपका अपना टोकन लौटाता है; send_message और send_template टूल अंतरराष्ट्रीय अंकों में फ़ोन नंबर लेते हैं।
आम गड़बड़ियाँ
- कॉन्टैक्ट को केवल wa_id से पहचानना। यूज़रनेम वाला उपयोगकर्ता जिसका 30 दिनों में उस नंबर से कोई संपर्क नहीं हुआ, केवल user_id और from_user_id के साथ आता है, और जो हैंडलर wa_id माँगता है वह मैसेज चूक जाता है।
- BSUID का देश प्रीफ़िक्स काटना। Meta पूरी वैल्यू चाहता है, देश कोड और पीरियड समेत, और जिस अनुरोध में कोई भी हिस्सा बदला गया हो वह विफल होता है।
- user_id_update फ़ील्ड का इंतज़ार करना। Meta के पास ऐसा कोई फ़ील्ड नहीं है: BSUID बदलाव messages पर user_changed_number या user_changed_user_id टाइप के सिस्टम मैसेज के रूप में आते हैं।
- Coexistence echoes को केवल to पर मैच करना। smb_message_echoes में to फ़ील्ड छूट सकता है, इसलिए ऐप में टाइप किया गया जवाब नज़र नहीं आता जब तक to_user_id भी मैच न किया जाए।
हर कनेक्शन की 24/7 निगरानी होती है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75, कनेक्शन बढ़ने के साथ घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
बिना यूज़रनेम वाले उपयोगकर्ताओं को भी BSUID मिलता है?
हाँ। Meta messages वेबहुक में user_id सेट करता है, चाहे उपयोगकर्ता का यूज़रनेम हो या न हो, इसलिए ज़्यादातर उपयोगकर्ता अपने फ़ोन नंबर और BSUID दोनों के साथ आते हैं।
क्या Coexistence नंबर का कारोबारी यूज़रनेम हो सकता है?
हाँ। 29 जून 2026 से कोई कारोबार Meta Business Suite, WhatsApp Manager, WhatsApp Business ऐप या Username API में इसे अपना सकता है या बदल सकता है; इससे कारोबारी नंबर छिपता नहीं, और business_username_updates हर स्टेटस बदलाव की रिपोर्ट देता है।
क्या BSUID कारोबार पोर्टफ़ोलियो के पार काम करता है?
नहीं। BSUID एक पोर्टफ़ोलियो और उपयोगकर्ता का होता है, और किसी दूसरे पोर्टफ़ोलियो का नंबर उसे मैसेज नहीं कर सकता। Meta द्वारा नामांकित प्रबंधित कारोबारों को पैरेंट BSUID मिलते हैं, जिनमें देश कोड के बाद ENT होता है, और वे नामांकित पोर्टफ़ोलियो के पार काम करते हैं।
एक WhatsApp नंबर के लिए easyCoexistence की कीमत कितनी है?
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75, आपके कनेक्शनों की संख्या पर निर्भर, और पहले 3 दिन मुफ़्त हैं। Meta के अपने मैसेज शुल्क आपके WhatsApp Business Account के भुगतान तरीके पर ही लगते हैं।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित