Business-scoped user IDs

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

Bird इसे किसी संदेश के from और to पर bsuid के रूप में दिखाता है, इसे भेजने के to के रूप में स्वीकार करता है, और इसके आधार पर संदेश सूची को फ़िल्टर करता है। Meta का business-scoped user IDs संदर्भ रोलआउट और Meta की अन्य सेवाएँ इस पहचानकर्ता के साथ क्या करती हैं, इसका स्रोत है।

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

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

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

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

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

कोड उदाहरण

{
  "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 से आप तक पहुँचता है, और उनका नंबर पाने की प्रक्रिया तीन चरणों में चलती है:

संपर्क आपको संदेश भेजता है। इनबाउंड संदेश में from.bsuid होता है, और from.phone_number अनुपस्थित हो सकता है। यह संदेश कस्टमर सर्विस विंडो खोलता है, जिससे आप अगले 24 घंटे तक फ़्री-फ़ॉर्म जवाब दे सकते हैं।
आप नंबर माँगते हैं। एक संपर्क की जानकारी का अनुरोध भेजें, यह एक बटन है जो संपर्क को फ़ोन नंबर साझा करने देता है। यही अनुरोध एक टेम्पलेट के request_contact_info बटन के ज़रिए भी भेजा जा सकता है, जो उस संपर्क तक पहुँचता है जिसकी विंडो बंद हो चुकी है।
संपर्क बटन टैप करता है। साझा किया गया नंबर एक इनबाउंड संपर्क कार्ड के रूप में आता है, जिसमें origin का मान contact_request होता है और नंबर phone_numbers में होता है। साझा किया गया संपर्क कार्ड किसी अन्य व्यक्ति या नंबर का भी हो सकता है। इस जानकारी को भेजने वाले की WhatsApp पहचान से अलग संग्रहित करें; बाद के संदेशों पर वास्तव में दी गई पहचानों का उपयोग करें, न कि केवल कार्ड से ग्राहक रिकॉर्ड को अधिलेखित करें।

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

BSUID को भेजना

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

कोड उदाहरण

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

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

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

भेजने के बारे में बाकी सब कुछ अपरिवर्तित है: कस्टमर सर्विस विंडो अभी भी फ़्री-फ़ॉर्म सामग्री को नियंत्रित करती है, और 202 का अर्थ अभी भी स्वीकृत है, डिलीवर नहीं।

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

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

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

संदेश पर, from और to प्रत्येक में phone_number, bsuid, या दोनों होते हैं। इनबाउंड संदेश में संपर्क from पर होता है; आउटबाउंड में to पर।
Webhook पर, वही पते इवेंट पेलोड पर होते हैं। एनवेलप के लिए WhatsApp इवेंट देखें।
संदेश सूची पर, to और from प्रत्येक फ़ोन नंबर के साथ-साथ BSUID भी स्वीकार करते हैं, और प्रत्येक संदेश के एक सिरे से मिलान करता है। bsuid फ़िल्टर दोनों दिशाओं में संपर्क से मिलान करता है। पुराने phone_number फ़िल्टर का उपयोग करने की अब सलाह नहीं दी जाती: to और from इसकी जगह लेते हैं और दोनों प्रकार की पहचान से मिलान करते हैं।

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

अगले कदम

संपर्क कार्ड प्राप्त करना: साझा किया गया नंबर इसी सामग्री प्रकार में आता है
WhatsApp पर संपर्क की जानकारी के अनुरोध: वह बटन जो नंबर माँगता है
WhatsApp संदेश भेजना: रिक्वेस्ट एनवेलप, 202 मॉडल, और सुरक्षित फिर से प्रयास
Meta का business-scoped user IDs संदर्भ: रोलआउट, parent BSUIDs, और Meta की अन्य सेवाएँ