WhatsApp युजरनेम र व्यवसाय-सीमित प्रयोगकर्ता ID (BSUID): Cloud API वेबहुकमा के बदलिन्छ
WhatsApp युजरनेमले प्रयोगकर्तालाई फोन नम्बरको सट्टा नाम देखाउन दिन्छ, त्यसैले अप्रिल 2026 को शुरुदेखि Cloud API का म्यासेज वेबहुकहरूमा user_id र from_user_id मा व्यवसाय-सीमित प्रयोगकर्ता ID (BSUID) पनि आउँछ, जस्तै US.13491208655302741918। 30 दिनभित्र यस नम्बरबाट म्यासेज वा कल नगरेको र सम्पर्क पुस्तिकामा नभएको युजरनेम भएको प्रयोगकर्ताका लागि wa_id र from छोडिन्छन्।
easyCoexistence ले WhatsApp Business एप नम्बरलाई Coexistence मार्फत Cloud API सँग जोड्छ, र यसका messages र smb_message_echoes वेबहुकहरू Meta ले पठाएजस्तै तपाईंको एन्डपोइन्टमा रुट गर्छ, BSUID फिल्डहरू सहित, जबकि get_api_credentials ले तपाईंको कोडलाई recipient सहित जवाफ दिन आवश्यक सबै दिन्छ।
BSUID हरू Cloud API वेबहुकमा देखिन थाले, WhatsApp प्रयोगकर्ताहरूसम्म युजरनेम पुग्नु अघि नै।
एपीआईहरूले BSUID मा पठाइएका म्यासेजहरू स्वीकार गर्न थाले, जुन to को सट्टा recipient मा सेट गरिन्छ।
प्रत्येक व्यवसाय फोन नम्बर 30 दिनको लुकब्याक अवधि, जसभित्र प्रयोगकर्तासँगको कुनै पनि म्यासेज वा कलले उनीहरूको नम्बर वेबहुकमा कायम राख्छ।
BSUID को दुई अक्षरे देश कोड र बिन्दु (.) पछिका अधिकांश वर्ण अल्फान्युमेरिक हुन्छन्।
Messages API ले यो त्रुटि फर्काउँछ: Business-scoped User ID (BSUID) recipients are not supported for this message, जसको अर्थ यो म्यासेजले BSUID प्राप्तकर्तालाई स्वीकार गर्दैन।
फोन नम्बर बिना रिपोर्ट गरिएको BSUID परिवर्तनको सिस्टम म्यासेज प्रकार, जसमा पुरानो BSUID previous_user_id मा हुन्छ।
WhatsApp युजरनेम र BSUID भनेको के हुन्?
युजरनेम भनेको WhatsApp प्रयोगकर्ताले सेट गर्न सक्ने वैकल्पिक, अद्वितीय नाम हो, जुन एपमा फोन नम्बरको सट्टा देखिन्छ; Meta ले 2026 मा युजरनेमहरू क्रमशः लागू गर्दैछ। BSUID भनेको Meta ले थपेको ब्याकएन्ड पहिचानकर्ता हो, ताकि व्यवसायहरूले प्रयोगकर्तालाई अझै छुट्याउन सकून्: यो स्वचालित रूपमा बनिन्छ, प्रत्येक Business Portfolio र प्रयोगकर्ता जोडीका लागि अद्वितीय हुन्छ, र प्रयोगकर्ताको ISO 3166 दुई अक्षरे देश कोड, बिन्दु र अधिकतम 128 अल्फान्युमेरिक वर्णमा लेखिन्छ। कुनै व्यवसायले प्रयोगकर्ताहरूले युजरनेम अपनाउने कि नअपनाउने नियन्त्रण गर्न सक्दैन, त्यसैले Meta ले पार्टनर र प्रत्यक्ष एकीकृत व्यवसायहरूलाई यसलाई समर्थन गर्न आवश्यक बनाएको छ।
कुन फिल्डहरूले नयाँ पहिचानकर्ताहरू बोक्छन्?
फोन नम्बर बोक्ने फिल्डहरूको छेउमै नयाँ गुणहरू आउँछन्, messages, status, system र user_preferences वेबहुकहरूमा। parent BSUID को फिल्डहरू केवल त्यस्ता Business Portfolio का लागि देखिन्छन् जसलाई Meta ले parent 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?" }
}]
}
}]
}]
}स्ट्याटस वेबहुकहरू कसरी बदलिन्छन्?
पठाइएको, डेलिभर भएको र पढिएको स्ट्याटसहरूमा प्रयोगकर्ताको नाम, user_id, नम्बर साझा गर्न सकिने अवस्थामा wa_id, र delivered र read मा username भएको contacts एरे थपिन्छ। statuses मा recipient_user_id ले BSUID बोक्छ, र BSUID मा पठाउँदा नम्बर साझा गर्न नसकिने भएमा recipient_id छोडिन्छ। असफल स्ट्याटसमा contacts एरे हुँदैन, र फोन नम्बरमा पठाइएको म्यासेज भएमा recipient_user_id छोडिन्छ, त्यसैले असफलताहरूलाई म्यासेज id सँग जोड्नुहोस्।
प्रयोगकर्ताहरूलाई कसरी भण्डारण र मिलान गर्ने?
पहिले BSUID द्वारा, र नम्बर आउँदा दोस्रो कुञ्जीको रूपमा फोन नम्बर। सम्पूर्ण BSUID लाई स्ट्रिङको रूपमा भण्डारण गर्नुहोस्, देश कोड र बिन्दु सहित, किनभने Meta ले यसको कुनै पनि भाग परिवर्तन गर्ने अनुरोधहरू अस्वीकार गर्छ; तपाईंको पोर्टफोलियो दर्ता भएको छ भने parent BSUID पनि भण्डारण गर्नुहोस्। wa_id अझै आउँदै गर्दा अवस्थित रेकर्डहरू wa_id मा जोड्नुहोस्, र BSUID लाई छेउमै राख्नुहोस्, किनभने पछि युजरनेम अपनाउने प्रयोगकर्ता नम्बरविना फर्कन सक्छ। Meta को FAQ ले 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 मात्र भएको प्रयोगकर्तालाई कसरी जवाफ दिने?
/<BUSINESS_PHONE_NUMBER_ID>/messages मा पठाउनुहोस्, recipient मा BSUID सेट गरेर र to छोडेर; दुवै भए to ले प्राथमिकता पाउँछ र जवाफ फोन नम्बरमा जान्छ। प्रतिक्रियाको contacts प्रविष्टिमा wa_id को सट्टा input र user_id हुन्छ। one-tap, zero-tap र copy code प्रमाणीकरण टेम्प्लेटबाहेक जुनसुकै म्यासेज प्रकार काम गर्छ, जसलाई फोन नम्बर चाहिन्छ, र केवल एउटै व्यवसाय पोर्टफोलियोका नम्बरहरूले BSUID मा पुग्न सक्छन्। त्रुटि 131062 को अर्थ म्यासेज प्रकारले BSUID प्राप्तकर्ता स्वीकार गर्दैन।
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"recipient": "US.13491208655302741918",
"type": "text",
"text": { "body": "Yes, it also comes in blue." }
}प्रयोगकर्तालाई उनीहरूको फोन नम्बर कसरी सोध्ने?
REQUEST_CONTACT_INFO बटनसँग, जुन utility वा marketing टेम्प्लेटमा थपिन्छ, वा request_contact_info प्रकारको interactive म्यासेजको रूपमा पठाइन्छ। जसले ट्याप गर्छ, उसको नम्बर थ्रेडमा साझा हुन्छ, र origin contact_request मा सेट भएको र नम्बर phones[].wa_id मा भएको contacts वेबहुक आउँछ; हातले साझा गरिएको सम्पर्क origin other र vCard सहित आउँछ। Meta ले यो बटन 2026 को जुलाईको शुरुमा उपलब्ध गरायो, र यसको लेबल अनुकूलन गर्न सकिँदैन।
सम्पर्क पुस्तिका भनेको के हो?
प्रत्येक Business Portfolio का लागि Meta ले होस्ट गर्ने भण्डार, कुनै एकीकरण काम विना: एकपटक व्यवसायको फोन नम्बरले प्रयोगकर्ताको नम्बरमा म्यासेज वा कल गर्यो, वा त्यस नम्बरबाट म्यासेज वा कल प्राप्त गर्यो, भने त्यो नम्बर र BSUID रेकर्ड हुन्छन् र पछिका वेबहुकहरू फोन नम्बर, युजरनेम भए पनि नभए पनि, भर्न प्रयोग हुन्छन्। यसको सुरुवातपछिका अन्तरक्रियाहरू मात्र गणना हुन्छन्। Meta Business Suite, Business settings, Business info मा यसलाई बन्द गर्न सकिन्छ, जसले यसमा भएको सबै कुरा मेटाउँछ, र GET वा DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book मा bsuid सहित एउटा प्रविष्टि जाँच्न वा हटाउन सकिन्छ।
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 सँगै। इकोहरू र आयात गरिएका च्याटहरू नम्बरका साथै user_id मा पनि मिलाउनुहोस्।
प्रयोगकर्ताहरूले युजरनेम अपनाउनु अघि कसरी परीक्षण गर्ने?
एपको ड्यासबोर्डमा Meta को परीक्षण उपकरणसँग: Use cases अन्तर्गत, Connect with customers through WhatsApp, Customize, Configuration, messages वेबहुकको छेउको Test लिङ्कले तपाईंको एन्डपोइन्टमा नमुना पठाउँछ। यसले चार परिदृश्यमा आगमन म्यासेज र स्ट्याटसहरू समेट्छ:
- युजरनेम नभएको प्रयोगकर्ता: BSUID र फोन नम्बरका फिल्डहरू छन्, तर username छैन।
- युजरनेम भएको र नम्बर उपलब्ध नभएको प्रयोगकर्ता: username र BSUID छन्, तर फोन नम्बर फिल्डहरू छैनन्।
- युजरनेम भएको र नम्बर उपलब्ध भएको प्रयोगकर्ता: username, BSUID र फोन नम्बर छन्।
- parent BSUID मा दर्ता भएको पोर्टफोलियो: पोर्टफोलियोको आफ्नै BSUID सँगै parent BSUID को मान।
easyCoexistence ले BSUID कसरी सम्हाल्छ?
यसले तिनलाई Meta ले पठाएजस्तै अगाडि पठाउँछ। set_webhook_destination सँग तपाईंको एन्डपोइन्टमा रुट गरिएको नम्बरले messages र smb_message_echoes वेबहुकहरू सिधै Meta बाट पाउँछ, user_id, from_user_id, to_user_id र username सहित, र automations वा फर्वार्डिङ सक्रिय भएमा easyCoexistence ले Meta ले पठाएको मान परिवर्तन नगरी अगाडि पठाउँछ। BSUID मा जवाफ दिन, तपाईंको कोडले get_api_credentials प्रयोग गर्छ, जसले फोन नम्बर ID, यसको पठाउने एन्डपोइन्ट, र उपलब्ध भएमा तपाईंकै आफ्नै टोकन फर्काउँछ; 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 प्रकारका सिस्टम म्यासेजको रूपमा आउँछन्।
- 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 ले Business Portfolio हरूभरि काम गर्छ?
गर्दैन। BSUID एउटा पोर्टफोलियो र प्रयोगकर्तासँग मात्र जोडिएको हुन्छ, र अर्को पोर्टफोलियोको नम्बरले त्यसलाई म्यासेज गर्न सक्दैन। Meta ले दर्ता गरेका व्यवस्थित व्यवसायहरूले देश कोडपछि ENT सहित parent BSUID पाउँछन्, जुन दर्ता भएका पोर्टफोलियोहरूभरि काम गर्छन्।
easyCoexistence ले WhatsApp नम्बरको कति लाग्छ?
प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, तपाईंसँग कति कनेक्सन छन् त्यसमा निर्भर गर्दै, र पहिलो 3 दिन निःशुल्क। Meta को आफ्नै म्यासेज शुल्क तपाईंको WhatsApp Business Account को भुक्तानी विधिमै रहन्छ।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको