# Business-scoped user IDs

**Business-scoped user ID** (BSUID) किसी WhatsApp उपयोगकर्ता के लिए Meta का पहचानकर्ता है, जो एक बिज़नेस पोर्टफ़ोलियो तक सीमित होता है। यह इनबाउंड संदेशों पर आता है, चाहे संपर्क WhatsApp यूज़रनेम का उपयोग करता हो या न करता हो, और यह उस संपर्क को संबोधित करता है जिसका फ़ोन नंबर आपके पास नहीं है।

Bird इसे किसी संदेश के `from` और `to` पर `bsuid` के रूप में दिखाता है, इसे भेजने के `to` के रूप में स्वीकार करता है, और इसके आधार पर संदेश सूची को फ़िल्टर करता है। Meta का [business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids) संदर्भ रोलआउट और Meta की अन्य सेवाएँ इस पहचानकर्ता के साथ क्या करती हैं, इसका स्रोत है।

## कोई संपर्क बिना फ़ोन नंबर के क्यों आता है

WhatsApp यूज़रनेम रोल आउट कर रहा है। जो उपयोगकर्ता इसे अपनाता है, वह ऐप में अपने फ़ोन नंबर की बजाय अपना यूज़रनेम दिखाता है, और Meta तब बिज़नेस को मिलने वाले पेलोड से नंबर छिपा देता है। BSUID वह पहचान है जो हमेशा मौजूद रहती है, इसलिए एक इनबाउंड संदेश में BSUID हो सकता है और `phone_number` बिलकुल न हो।

जब आपका संपर्क से पहले से संबंध हो तो Meta फ़ोन नंबर शामिल करता है: जब उस विशिष्ट बिज़नेस फ़ोन नंबर ने पिछले 30 दिनों में उन्हें संदेश या कॉल किया हो, या उनसे संदेश या कॉल प्राप्त किया हो, या जब वे आपकी Meta संपर्क पुस्तिका में हों। 30-दिन की शर्त प्रत्येक बिज़नेस फ़ोन नंबर के लिए अलग-अलग जाँची जाती है, इसलिए जिस संपर्क ने आपके एक नंबर पर लिखा हो वह दूसरे नंबर पर बिना फ़ोन नंबर के आ सकता है।

WhatsApp उपयोगकर्ता के संदेश में वह प्रोफ़ाइल भी होती है जो वे प्रकाशित करते हैं, `from` पर `username` और `display_name` में। दोनों अनुपस्थित होते हैं जब संपर्क ने यूज़रनेम नहीं अपनाया हो या संदेश में कोई प्रोफ़ाइल न हो, और दोनों में से किसी का उपयोग संदेश भेजने के लिए नहीं किया जा सकता।

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

```json
{
  "from": {
    "bsuid": "US.13491208655302741918",
    "username": "alexr",
    "display_name": "Alex Rivera"
  }
}
```

एक ISO 3166 alpha-2 देश कोड, एक बिंदु, फिर 128 तक अल्फ़ान्यूमेरिक अक्षर। एक **parent BSUID**, जिसमें एक प्रबंधित बिज़नेस को नामांकित किया जा सकता है ताकि एक पहचानकर्ता पोर्टफ़ोलियो के समूह में काम करे, देश के बाद `ENT` जोड़ता है: `US.ENT.11815799212886844830`। Bird दोनों रूपों को प्राप्तकर्ता के रूप में स्वीकार करता है।

तीन गुण तय करते हैं कि आप इसे कैसे स्टोर और उपयोग करें:

- **पूरा मान जैसा है वैसा ही पास करें।** Meta संशोधित BSUID को अस्वीकार कर देता है, इसलिए इसका कोई भी हिस्सा वैकल्पिक नहीं है: देश कोड, बिंदु, और पहचानकर्ता का हर अक्षर एक साथ जाता है। Bird भेजने का अनुरोध स्वीकार करने से पहले प्रारूप की जाँच करता है, और देश कोड अपरकेस तथा वास्तविक ISO 3166 alpha-2 कोड होना चाहिए; लोअरकेस या अज्ञात प्रीफ़िक्स को सुधारने की बजाय अस्वीकार किया जाता है। 128-अक्षर की सीमा देश कोड के बाद वाले पहचानकर्ता पर लागू होती है, और parent BSUID पर `ENT.` खंड के बाद।
- **यह एक बिज़नेस पोर्टफ़ोलियो तक सीमित है।** उसी पोर्टफ़ोलियो का कोई भी बिज़नेस फ़ोन नंबर उस BSUID को संदेश भेज सकता है; किसी अलग पोर्टफ़ोलियो का नंबर नहीं भेज सकता, और भेजना विफल हो जाता है।
- **यह स्थायी नहीं है।** Meta का दस्तावेज़ कहता है कि जब संपर्क अपना फ़ोन नंबर बदलता है तो उसका BSUID दोबारा बनाया जाता है, इसलिए यह एक वार्तालाप साथी की पहचान करता है, न कि आपकी अपनी टिकाऊ ग्राहक कुंजी के रूप में काम करता है।

## बातचीत आमतौर पर कैसे होती है

कोई संपर्क जिससे आपने पहले बात नहीं की है, BSUID से आप तक पहुँचता है, और उनका नंबर पाने की प्रक्रिया तीन चरणों में चलती है:

1. **संपर्क आपको संदेश भेजता है।** इनबाउंड संदेश में `from.bsuid` होता है, और `from.phone_number` अनुपस्थित हो सकता है। यह संदेश [कस्टमर सर्विस विंडो](/docs/knowledge-base/whatsapp/customer-service-window) खोलता है, जिससे आप अगले 24 घंटे तक फ़्री-फ़ॉर्म जवाब दे सकते हैं।
2. **आप नंबर माँगते हैं।** एक [संपर्क की जानकारी का अनुरोध](/docs/guides/whatsapp/message-types/interactive/contact-info-requests) भेजें, यह एक बटन है जो संपर्क को फ़ोन नंबर साझा करने देता है। यही अनुरोध एक टेम्पलेट के `request_contact_info` बटन के ज़रिए भी भेजा जा सकता है, जो उस संपर्क तक पहुँचता है जिसकी विंडो बंद हो चुकी है।
3. **संपर्क बटन टैप करता है।** साझा किया गया नंबर एक इनबाउंड [संपर्क कार्ड](/docs/guides/whatsapp/receiving-whatsapp/contact-cards) के रूप में आता है, जिसमें `origin` का मान `contact_request` होता है और नंबर `phone_numbers` में होता है। साझा किया गया संपर्क कार्ड किसी अन्य व्यक्ति या नंबर का भी हो सकता है। इस जानकारी को भेजने वाले की WhatsApp पहचान से अलग संग्रहित करें; बाद के संदेशों पर वास्तव में दी गई पहचानों का उपयोग करें, न कि केवल कार्ड से ग्राहक रिकॉर्ड को अधिलेखित करें।

संपर्क मना कर सकता है। शेयर शीट को खारिज करने पर कोई संदेश और कोई webhook नहीं आता, इसलिए जिस फ़्लो को नंबर चाहिए उसे मना आने का इंतज़ार करने की बजाय खुद टाइम आउट करना होगा, और उसे उस संपर्क के लिए भी काम करते रहना होगा जो नंबर कभी शेयर न करे।

## BSUID को भेजना

`to` जहाँ भी फ़ोन नंबर लेता है वहाँ BSUID लेता है:

```json
{
  "to": "US.13491208655302741918",
  "from": "+13124495648",
  "text": { "body": "Your order shipped." }
}
```

फ़ोन नंबर से संबोधित भेजने से चार चीज़ें भिन्न हैं:

- **`from` उसी पोर्टफ़ोलियो में होना चाहिए जिसके लिए BSUID स्कोप किया गया है।** यह वही पोर्टफ़ोलियो आवश्यकता है जो Meta लागू करता है, और बेमेल होने पर अनुरोध स्वीकार करते समय नहीं, बल्कि बाद में WhatsApp पर भेजना विफल होता है।
- **वन-टाइम-पासकोड टेम्प्लेट के लिए फ़ोन नंबर ज़रूरी है।** `authentication` कैटेगरी में Bird-प्रबंधित टेम्प्लेट, या वन-टाइम-पासकोड बटन वाला टेम्प्लेट, अनुरोध स्वीकार करते समय `422` [`E15014`](/docs/api/errors/E15014) `WhatsAppRecipientNotSupportedForTemplate` के साथ अस्वीकार किया जाता है। आपके वर्कस्पेस द्वारा बनाया गया टेम्प्लेट अनुरोध स्वीकार करते समय जाँचा नहीं जाता: Meta को one-tap, zero-tap, और copy-code ऑथेंटिकेशन टेम्प्लेट के लिए फ़ोन नंबर चाहिए, इसलिए ऐसा भेजना स्वीकार किया जाता है और फिर विफल हो जाता है।
- **जो मान न फ़ोन नंबर है और न ही सही प्रारूप का BSUID, उसे अनुरोध स्वीकार करते समय अस्वीकार किया जाता है**, `422` [`E15001`](/docs/api/errors/E15001) `WhatsAppInvalidRecipient` के साथ।
- **कीमत BSUID के देश प्रीफ़िक्स पर आधारित होती है।** फ़ोन नंबर वह देश प्रदान करता है जिसके आधार पर संदेश की कीमत लगाई जाती है, और BSUID भेजने में दो-अक्षर का प्रीफ़िक्स इसकी जगह लेता है।

भेजने के बारे में बाकी सब कुछ अपरिवर्तित है: [कस्टमर सर्विस विंडो](/docs/guides/whatsapp/message-types#the-customer-service-window) अभी भी फ़्री-फ़ॉर्म सामग्री को नियंत्रित करती है, और `202` का अर्थ अभी भी स्वीकृत है, डिलीवर नहीं।

**संपर्क को उसी पहचान पर संदेश भेजें जिसका उपयोग करके उन्होंने आपको लिखा था।** Bird इनबाउंड संदेश में मौजूद प्रत्येक पहचान के तहत एक खुली विंडो दर्ज करता है, और संदेश भेजते समय उसकी गंतव्य पहचान के तहत विंडो खोजी जाती है। जो संपर्क केवल BSUID से आप तक पहुँचा है वह फ़ोन-आधारित कोई विंडो नहीं छोड़ता, इसलिए कहीं और से आपके पास मौजूद फ़ोन नंबर पर फ़्री-फ़ॉर्म भेजना `422` [`E15044`](/docs/api/errors/E15044) `WhatsAppServiceWindowClosed` के साथ अस्वीकार हो सकता है जबकि Meta अभी भी बातचीत को खुला मानता है। उनके संदेश के `from` पर जवाब देने से यह बेमेल नहीं होता।

## BSUID से पढ़ना और फ़िल्टर करना

हर रीड में संदेश में मौजूद सभी पहचानें होती हैं:

- **संदेश पर**, `from` और `to` प्रत्येक में `phone_number`, `bsuid`, या दोनों होते हैं। इनबाउंड संदेश में संपर्क `from` पर होता है; आउटबाउंड में `to` पर।
- **Webhook पर**, वही पते इवेंट पेलोड पर होते हैं। एनवेलप के लिए [WhatsApp इवेंट](/docs/guides/whatsapp/events#the-event-envelope) देखें।
- **संदेश सूची पर**, `to` और `from` प्रत्येक फ़ोन नंबर के साथ-साथ BSUID भी स्वीकार करते हैं, और प्रत्येक संदेश के एक सिरे से मिलान करता है। `bsuid` फ़िल्टर दोनों दिशाओं में संपर्क से मिलान करता है। पुराने `phone_number` फ़िल्टर का उपयोग करने की अब सलाह नहीं दी जाती: `to` और `from` इसकी जगह लेते हैं और दोनों प्रकार की पहचान से मिलान करते हैं।

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

## अगले कदम

- [संपर्क कार्ड प्राप्त करना](/docs/guides/whatsapp/receiving-whatsapp/contact-cards): साझा किया गया नंबर इसी सामग्री प्रकार में आता है
- [WhatsApp पर संपर्क की जानकारी के अनुरोध](/docs/guides/whatsapp/message-types/interactive/contact-info-requests): वह बटन जो नंबर माँगता है
- [WhatsApp संदेश भेजना](/docs/guides/whatsapp/sending-whatsapp): रिक्वेस्ट एनवेलप, `202` मॉडल, और सुरक्षित फिर से प्रयास
- [Meta का business-scoped user IDs संदर्भ](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids): रोलआउट, parent BSUIDs, और Meta की अन्य सेवाएँ

## 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](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)