# WhatsApp यूजरनेम और BSUID: OTP, CRM और webhook के लिए क्या बदलाव हुए हैं

> WhatsApp यूजरनेम का मतलब है कि हो सकता है कि कोई बिजनेस अब ग्राहक का फोन नंबर न देख पाए। Meta का समाधान बिजनेस-स्कोप वाला यूजर ID (BSUID) है। यहाँ बताया गया है कि यह क्या है, किन चीज़ों के लिए अभी भी फोन नंबर की आवश्यकता है, और webhook, CRM और OTP फ्लो को कैसे माइग्रेट करें।

- कैनोनिकल URL: https://www.broadnet.me/hi/blog/whatsapp-usernames-bsuid-developer-guide
- भाषा: hi
- अंतिम अपडेट: 2026-10-10
- प्रकाशक: BroadNet (https://www.broadnet.me)

- प्रकाशित: 2026-09-26
- लेखक: BroadNet Engineering

बिजनेस-स्कोप वाला यूजर ID (BSUID) वह पहचानकर्ता है जिसे Meta अब हर WhatsApp webhook में डालता है ताकि कोई बिजनेस ग्राहक का फोन नंबर जाने बिना उन्हें मैसेज भेज सके। यह इसलिए लाया गया है क्योंकि WhatsApp यूजरनेम पेश कर रहा है: एक बार जब कोई यूजर इसे चालू कर देता है, तो वह बिजनेस जिससे हाल ही में संपर्क नहीं हुआ है, उसे अब नंबर नहीं मिल पाएगा। BroadNet इंजीनियरिंग टीम की यह गाइड इसके फॉर्मेट, समयसीमा, किन चीज़ों के लिए अभी भी फोन नंबर की आवश्यकता है, और webhook, CRM रिकॉर्ड और OTP फ्लो को कैसे माइग्रेट करें, इसके बारे में विस्तार से बताती है।

## मुख्य बातें

- अप्रैल 2026 की शुरुआत से ही WhatsApp webhooks में हर यूजर के लिए BSUID दिखाई देने लगे हैं, चाहे वे यूजरनेम का उपयोग करें या न करें।
- एक BSUID US.13491208655302741918 जैसा दिखता है: एक ISO 3166 अल्फा-2 कंट्री कोड, एक बिंदु (period), और फिर 128 तक अल्फ़ान्यूमेरिक कैरेक्टर।
- यह प्रत्येक बिजनेस पोर्टफोलियो और यूजर की जोड़ी के लिए यूनिक है, और यदि यूजर अपना फोन नंबर बदलता है तो इसे फिर से जनरेट किया जाता है।
- जुलाई 2026 से आप BSUID पर मैसेज भेज सकते हैं, सिवाय वन-टैप, ज़ीरो-टैप और कॉपी-कोड ऑथेंटिकेशन टेम्पलेट्स के, जिन्हें अभी भी फोन नंबर की आवश्यकता है।
- Meta कहता है कि पार्टनर्स और सीधे तौर पर इंटीग्रेटेड बिजनेस को यूजरनेम यूजर्स से मैसेज प्रोसेस करने की क्षमता खोने से बचने के लिए BSUID का समर्थन करना होगा।
- OTP, SMS फ़ालबैक और धोखाधड़ी की जांच के लिए वेरिफ़ाइड E.164 फोन नंबर को पहचान एंकर के रूप में रखें। BSUID को WhatsApp-चैनल की (key) के रूप में मानें।

## बिजनेस-स्कोप वाला यूजर ID क्या है?

Meta एक BSUID को "एक अद्वितीय यूजर आइडेंटिफ़ायर के रूप में परिभाषित करता है जिसका उपयोग आप तब किसी WhatsApp यूजर को मैसेज करने के लिए कर सकते हैं जब आप उनका फोन नंबर नहीं जानते" ([Meta, बिजनेस-स्कोप वाले यूजर ID](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/))। इसका फॉर्मेट यूजर के देश का ISO 3166 अल्फा-2 कोड, एक बिंदु (period), और अधिकतम 128 अल्फ़ान्यूमेरिक कैरेक्टर है, उदाहरण के लिए US.13491208655302741918।

सिस्टम डिज़ाइन के लिए तीन गुण महत्वपूर्ण हैं:

- स्कोप (Scope)। एक BSUID एक बिजनेस पोर्टफोलियो और एक यूजर के लिए अद्वितीय होता है। एक ही व्यक्ति के पास हर उस बिजनेस पोर्टफोलियो के लिए एक अलग BSUID होता है जिससे वह बात करता है, इसलिए आप इसका उपयोग असंबंधित पोर्टफोलियो में ग्राहकों का मिलान करने के लिए नहीं कर सकते।
- स्थिरता (Stability)। जब यूजर अपना फोन नंबर बदलता है, तो इसे फिर से जनरेट किया जाता है। ऐसा होने पर Meta user_changed_user_id प्रकार का एक सिस्टम मैसेज webhook और एक अलग user_id_update webhook भेजता है।
- पैरेंट BSUID। कई पोर्टफोलियो वाले मैनेज्ड बिजनेस अपने Meta पॉइंट ऑफ कॉन्टैक्ट से पैरेंट BSUID में नामांकन करने के लिए कह सकते हैं, जिसमें ENT (उदाहरण के लिए US.ENT.11815799212886844830) शामिल हैं और जो सभी नामांकित पोर्टफोलियो में काम करते हैं।

## WhatsApp यूज़रनेम क्यों ला रहा है?

प्राइवेसी के लिए। Meta ने 29 जून 2026 को घोषणा की कि लोग "इस साल के अंत तक" उपयोग करने के लिए एक यूजरनेम सुरक्षित कर सकते हैं, और जब कोई यूजर इसे इनेबल कर देता है, तो जिस व्यक्ति या व्यवसाय को वे पहली बार मैसेज करते हैं, उन्हें उनका फोन नंबर दिखाई नहीं देगा ([Meta के बारे में](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/))। Meta के डेवलपर डॉक्यूमेंटेशन के अनुसार, यूजरनेम 2026 में धीरे-धीरे रोल आउट किए जाएंगे।

व्यवसाय भी यूज़रनेम रख सकते हैं। 29 जून 2026 से, एक व्यवसाय WhatsApp मैनेजर, Meta बिजनेस सुइट या यूज़रनेम API के माध्यम से WhatsApp द्वारा अपने लिए सुरक्षित किए गए यूज़रनेम का दावा कर सकता है, और फीचर लॉन्च होने पर अप्रूव्ड यूज़रनेम एक्टिव हो जाएंगे। बिजनेस यूज़रनेम बिजनेस फ़ोन नंबर को नहीं छुपाता है।

## टाइमलाइन क्या है?

| तारीख | क्या हुआ या क्या होता है | डेवलपर्स को क्या करना चाहिए |
|---|---|---|
| अप्रैल 2026 की शुरुआत | मैसेज webhook (user_id) में BSUID दिखने शुरू होते हैं | प्रत्येक इनबाउंड इवेंट पर फोन नंबर के साथ BSUID को स्टोर करें |
| 29 जून 2026 | यूज़र्स और बिज़नेस के लिए यूजरनेम रिजर्वेशन शुरू | अपना बिज़नेस यूजरनेम रिजर्व करें; बिना नंबर वाले यूज़र्स के लिए योजना बनाएं |
| जुलाई 2026 | API में BSUID को मैसेज भेजना समर्थित है | अपने send path में recipient पैरामीटर जोड़ें |
| 2026 के दौरान (धीरे-धीरे) | यूज़रनेम यूज़र्स के लिए रोल आउट किए जा रहे हैं | BSUID के साथ और बिना फ़ोन नंबर वाले इनबाउंड webhooks की अपेक्षा करें |

## क्या आप ग्राहक का फ़ोन नंबर खो देंगे?

कभी-कभी। BSUID सभी मैसेज webhooks में दिखाई देता है। फ़ोन नंबर (wa_id, और इनबाउंड मैसेज में 'from') केवल तभी शामिल किया जाता है जब Meta के अनुसार इनमें से कम से कम एक बात सही हो:

- webhook ट्रिगर होने से पहले 30 दिनों के भीतर आपने यूज़र के फ़ोन नंबर पर मैसेज किया या कॉल किया हो;
- उन 30 दिनों के भीतर आपको यूज़र के फ़ोन नंबर से कोई मैसेज या कॉल प्राप्त हुआ हो; या
- यूज़र आपकी कॉन्टैक्ट बुक में है।

30-दिन का लुकबैक प्रत्येक बिजनेस फ़ोन नंबर के आधार पर आंका जाता है, इसलिए आपकी सेल्स लाइन के लिए ज्ञात ग्राहक आपकी सपोर्ट लाइन के लिए अज्ञात हो सकता है। कॉन्टैक्ट बुक एक Meta-होस्टेड फीचर है जो पहली बातचीत के बाद फ़ोन नंबर और BSUIDs को स्टोर करता है, ताकि बाद में webhooks नंबर को तब भी ले जा सकें जब उपयोगकर्ता यूजरनेम अपना लेता है। यह डिफ़ॉल्ट रूप से चालू रहता है और इसे Business settings के अंतर्गत Meta Business Suite में Business info में जाकर बंद किया जा सकता है। जब तक आपके पास इसे बंद करने का कोई कारण न हो, इसे चालू ही रखें।

## अभी भी किस चीज़ के लिए फ़ोन नंबर की आवश्यकता है?

Meta स्पष्ट है: BSUIDs "one-tap, zero-tap, और copy code authentication टेम्पलेट्स को छोड़कर किसी भी प्रकार का मैसेज भेजने के लिए उपयोग किए जा सकते हैं, जिनके लिए उपयोगकर्ता के फ़ोन नंबर की आवश्यकता होती है"। WhatsApp के अलावा, मोबाइल नेटवर्क पर चलने वाली किसी भी चीज़ को नंबर की आवश्यकता होती है।

| कार्य | क्या यह केवल BSUID के साथ काम करता है? | आपको क्या चाहिए |
|---|---|---|
| फ्री-फॉर्म रिप्लाई, मीडिया, इंटरैक्टिव मैसेज | हाँ | रिसीपिएंट पैरामीटर में BSUID |
| मार्केटिंग और यूटिलिटी टेम्पलेट्स | हाँ | रिसीपिएंट पैरामीटर में BSUID |
| वन-टैप, ज़ीरो-टैप और कॉपी-कोड ऑथेंटिकेशन टेम्पलेट्स (OTP) | नहीं | यूज़र का फ़ोन नंबर |
| जब WhatsApp विफल हो जाए तो SMS या RCS फ़ालबैक | नहीं | E.164 फ़ोन नंबर |
| HLR लुकअप, SIM स्वैप चेक, नंबर वेरिफ़िकेशन | नहीं | E.164 फ़ोन नंबर |
| ग्राहक का मिलान दूसरे बिज़नेस पोर्टफोलियो में उसी व्यक्ति से करना | नहीं | आपकी अपनी कस्टमर ID या फ़ोन नंबर |

## webhook पहले और बाद में कैसा दिखता है?

BSUID से पहले, messages webhook में contacts ब्लॉक wa_id में फ़ोन नंबर रखता था, और अधिकांश integrations इसे कस्टमर की (customer key) के रूप में उपयोग करते थे। Meta का नए contacts object का उदाहरण username, BSUID और, जहाँ सक्षम हो, parent BSUID को जोड़ता है; wa_id केवल तभी मौजूद होता है जब नंबर साझा किया जा सकता हो:

```
"contacts": [
  {
    "profile": {
      "name": "<USER_DISPLAY_NAME>",
      "username": "<USERNAME>"
    },
    "wa_id": "<USER_PHONE_NUMBER>",
    "user_id": "<BSUID>",
    "parent_user_id": "<PARENT_BSUID>"
  }
]
```

Inbound messages में from_user_id (और यदि सक्षम हो तो from_parent_user_id) भी होता है, और status webhooks में recipient_user_id होता है, जिसे Meta के अनुसार हमेशा उपयोगकर्ता के BSUID पर सेट किया जाता है। भेजने के लिए, नए recipient parameter में BSUID डालें। आप to parameter (फ़ोन नंबर), recipient parameter (BSUID), या दोनों सेट कर सकते हैं; जब दोनों मौजूद हों, तो फ़ोन नंबर को प्राथमिकता दी जाती है:

```
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "<BSUID>",
  "type": "text",
  "text": {
    "body": "<BODY_TEXT>"
  }
}
```

इसके बाद send response के contacts array में user_id शामिल होता है, और wa_id वैकल्पिक हो जाता है। यदि आपका parser यह मानता है कि wa_id हमेशा मौजूद रहता है, तो यह पहले username उपयोगकर्ता पर विफल हो जाएगा। आप यह जाँचने के लिए कि आपका integration वास्तव में कौन से फ़ील्ड प्राप्त करता है, हमारे [webhook payload inspector](https://www.broadnet.me/tools/webhook-payload-inspector) में वास्तविक payloads पेस्ट कर सकते हैं।

## OTP के लिए क्या काम करना बंद कर देता है?

one-tap, zero-tap या copy-code बटन वाले Authentication templates को BSUID पर नहीं भेजा जा सकता है। यदि कोई username उपयोगकर्ता WhatsApp के माध्यम से आप तक पहुँचता है और आपके पास उनके लिए कोई फ़ोन नंबर नहीं है, तो आप उन्हें उस प्रकार का WhatsApp OTP नहीं भेज सकते। वेरिफिकेशन फ़्लो के लिए इसके दो परिणाम हैं:

- साइन अप करते समय फ़ोन नंबर को E.164 फॉर्मेट में एकत्र और सत्यापित करें, और इसे अकाउंट के वेरिफिकेशन एड्रेस के रूप में स्टोर करें। इसे बाद में आपको देने के लिए WhatsApp webhook पर भरोसा न करें। देखें [E.164 क्या है](https://www.broadnet.me/answers/what-is-e164)।
- एक ऐसा चैनल बनाए रखें जो स्वयं नंबर पर काम करता हो। SMS OTP, वॉइस OTP और साइलेंट नेटवर्क चेक सभी फ़ोन नंबर पर चलते हैं, यही कारण है कि ऑटोमैटिक फॉलबैक वाला मल्टीचैनल डिज़ाइन इस बदलाव के बाद भी बिना किसी बदलाव के बना रहता है। हमारी [multichannel OTP गाइड](https://www.broadnet.me/blog/multichannel-otp-verification-api-2026) और [BroadNet OTP प्रोडक्ट](https://www.broadnet.me/products/otp) इस पैटर्न को कवर करते हैं।

## CRM और कस्टमर डिडुप्लीकेशन (deduplication) में क्या समस्या आती है?

अधिकांश CRM WhatsApp कॉन्टैक्ट को फोन नंबर के आधार पर लिंक करते हैं क्योंकि SMS, वॉइस और WhatsApp सभी इसका उपयोग करते थे। यूजरनेम के बाद, एक नया इनबाउंड कॉन्टैक्ट केवल BSUID के साथ आ सकता है। यदि आप इसके लिए एक नया CRM रिकॉर्ड बनाते हैं, तो धीरे-धीरे कस्टमर्स का डुप्लीकेशन होने लगेगा। डेटा को साफ रखने के लिए चार नियम यहाँ दिए गए हैं:

1. BSUID को चैनल आइडेंटिटी के रूप में मॉडल करें, न कि कस्टमर ID के रूप में। एक कस्टमर के पास कई BSUID हो सकते हैं (प्रत्येक बिजनेस पोर्टफोलियो के लिए एक) और नंबर बदलने के बाद एक नया BSUID हो सकता है।
2. BSUID, पोर्टफोलियो, फोन नंबर (यदि ज्ञात हो), पहली बार देखा गया (first seen) और आखिरी बार देखा गया (last seen) का एक मैपिंग टेबल रखें, और user_id_update सहित हर webhook पर इसे अपडेट करें।
3. अनुमान के बजाय प्रमाण के आधार पर मर्ज करें: एक वेरिफ़ाइड फोन नंबर, एक लॉगिन, या वह ऑर्डर रेफरेंस जो कस्टमर चैट में देता है।
4. wa_id की अनुपस्थिति को कभी भी नए कस्टमर के रूप में न मानें। इसका मतलब केवल यह है कि उस इवेंट पर नंबर साझा नहीं किया जा सकता है।

## आप माइग्रेट कैसे करते हैं? स्टेप-बाय-स्टेप चेकलिस्ट

1. webhook पार्सर्स को user_id, from_user_id, recipient_user_id और यूजरनेम पढ़ने के लिए, और wa_id तथा 'from' को वैकल्पिक (optional) मानने के लिए अपडेट करें।
2. जहाँ भी आप WhatsApp कॉन्टैक्ट्स स्टोर करते हैं, वहाँ एक BSUID कॉलम (और यदि आप एक मैनेज्ड बिज़नेस हैं तो पैरेंट BSUID) जोड़ें।
3. बैकफ़िल: अप्रैल 2026 की शुरुआत से प्रत्येक इनबाउंड इवेंट के लिए, BSUID को उस फ़ोन नंबर से लिंक करें जो आपके पास पहले से है।
4. नए BSUID को ग्राहक से फिर से लिंक करके user_changed_user_id सिस्टम मैसेज और user_id_update webhook को हैंडल करें।
5. अपने सेंड पाथ में रेसिपिएंट पैरामीटर जोड़ें, और जब आपके पास फ़ोन नंबर न हो तो इसका उपयोग करें।
6. OTP को फ़ोन नंबर पर रूट करें, कभी भी BSUID पर नहीं, और SMS या वॉइस को फ़ालबैक चैनल के रूप में रखें।
7. WhatsApp Manager, Meta Business Suite या Username API के माध्यम से अपना बिज़नेस यूज़रनेम सुरक्षित करें।
8. यूज़रनेम आपके ग्राहकों तक पहुँचने से पहले यूज़रनेम-इनेबल्ड अकाउंट के साथ टेस्ट करें।

यदि BroadNet आपका WhatsApp प्रोवाइडर है, तो प्रोडक्शन कोड बदलने से पहले टेस्ट एक्सेस का अनुरोध करें और पुष्टि करें कि आपके अकाउंट के लिए webhooks में BSUID फ़ील्ड्स कैसे दिखाई देते हैं। हमारे [डेवलपर हब](https://www.broadnet.me/developers) और [WhatsApp Business API पेज](https://www.broadnet.me/products/whatsapp-business-api) में विस्तृत जानकारी है, और [ओम्नीचैनल रूटिंग](https://www.broadnet.me/products/omnichannel) उस SMS फ़ालबैक को हैंडल करती है जिस पर अब ऑथेंटिकेशन फ़्लो निर्भर करते हैं।

## अक्सर पूछे जाने वाले प्रश्न

### WhatsApp BSUID क्या है?

एक बिज़नेस-स्कोप वाला यूज़र ID: एक पहचानकर्ता जिसे Meta प्रत्येक बिज़नेस पोर्टफोलियो के लिए प्रत्येक WhatsApp यूज़र को असाइन करता है, ताकि बिज़नेस यूज़र का फ़ोन नंबर जाने बिना उन्हें मैसेज भेज सके। यह webhooks में user_id के रूप में दिखाई देता है।

### BSUID कैसा दिखता है?

एक ISO 3166 अल्फा-2 कंट्री कोड, एक बिंदु, और फिर 128 तक अल्फ़ान्यूमेरिक कैरेक्टर, उदाहरण के लिए US.13491208655302741918। मैनेज्ड बिज़नेस के लिए पैरेंट BSUIDs में ENT शामिल है, उदाहरण के लिए US.ENT.11815799212886844830।

### जब ग्राहक यूज़रनेम अपनाते हैं, तो क्या मैं उनका फ़ोन नंबर खो दूँगा?

केवल कुछ webhooks में। यदि आपने पिछले 30 दिनों में उस नंबर के साथ कोई मैसेज या कॉल किया है, या यदि यूज़र आपकी कॉन्टैक्ट बुक में है, तो नंबर अभी भी शामिल होता है। अन्यथा wa_id को हटा दिया जाता है और आपको केवल BSUID प्राप्त होता है।

### क्या मैं BSUID को मैसेज भेज सकता हूँ?

हाँ, जुलाई 2026 से, send API के recipient पैरामीटर का उपयोग करके। वन-टैप, ज़ीरो-टैप और कॉपी-कोड ऑथेंटिकेशन टेम्पलेट्स को छोड़कर हर प्रकार का मैसेज काम करता है, क्योंकि इन टेम्पलेट्स के लिए उपयोगकर्ता के फ़ोन नंबर की आवश्यकता होती है।

### क्या मैं BSUID को ऑथेंटिकेशन (OTP) टेम्पलेट्स भेज सकता हूँ?

नहीं। वन-टैप, ज़ीरो-टैप और कॉपी-कोड ऑथेंटिकेशन टेम्पलेट्स के लिए फ़ोन नंबर की आवश्यकता होती है। प्रत्येक अकाउंट के लिए एक वेरिफ़ाइड फ़ोन नंबर रखें और फ़ालबैक के रूप में SMS या वॉइस OTP का उपयोग करें।

### क्या BSUIDs विभिन्न बिजनेस पोर्टफोलियो में काम करते हैं?

नहीं। एक BSUID एक बिजनेस पोर्टफोलियो और यूजर पेयर के लिए यूनिक होता है। मैनेज्ड बिजनेस पैरेंट BSUIDs के बारे में Meta से पूछ सकते हैं, जो एक साथ एनरोल किए गए पोर्टफोलियो में काम करते हैं।

### क्या BSUID कभी बदलता है?

हाँ। जब उपयोगकर्ता अपना फ़ोन नंबर बदलता है, तो इसे फिर से जेनरेट किया जाता है, और Meta एक user_changed_user_id सिस्टम मैसेज और एक user_id_update webhook के साथ इसका संकेत देता है।

### मैं अपना बिजनेस यूजरनेम कैसे रिज़र्व करूँ?

29 जून 2026 से, WhatsApp Manager, Meta Business Suite या Username API के माध्यम से। एक स्वीकृत यूजरनेम तब सक्रिय हो जाता है जब यूजरनेम फीचर लॉन्च होता है, और यह आपके बिजनेस फोन नंबर को नहीं छुपाता है।

## स्रोत

- डेवलपर्स के लिए Meta, [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (फॉर्मेट, टाइमलाइन, webhook फ़ील्ड्स, कॉन्टैक्ट बुक, सेंड पैरामीटर, ऑथेंटिकेशन-टेम्पलेट अपवाद), 26 सितंबर 2026 को एक्सेस किया गया।
- Meta के बारे में, [अपना WhatsApp यूजरनेम आरक्षित करने का समय आ गया है](https://about.fb.com/news/2026/06/its-time-to-reserve-your-whatsapp-username/), 29 जून 2026, 26 सितंबर 2026 को एक्सेस किया गया।