WhatsApp वापरकर्तानावे आणि व्यवसाय-स्कोप्ड वापरकर्ता आयडी (BSUID): Cloud API वेबहुकमध्ये काय बदलते
WhatsApp वापरकर्तानावांमुळे वापरकर्ते फोन नंबरऐवजी नाव दाखवू शकतात, म्हणून एप्रिल 2026 पासून Cloud API मेसेज वेबहुकमध्ये user_id आणि from_user_id मध्ये व्यवसाय-स्कोप्ड वापरकर्ता आयडी (BSUID) येऊ लागला, उदाहरणार्थ US.13491208655302741918. ज्या वापरकर्त्याचे वापरकर्तानाव आहे, ज्याने 30 दिवसांत त्या नंबरसोबत मेसेज किंवा कॉल केला नाही आणि जो संपर्क यादीत नाही, त्याच्यासाठी wa_id आणि from वगळले जातात.
easyCoexistence WhatsApp Business ॲप नंबर Coexistence द्वारे Cloud API ला जोडते आणि त्याचे messages आणि smb_message_echoes वेबहुक Meta पाठवते त्या स्वरूपात, BSUID फील्डसह, तुमच्या endpoint कडे रूट करते; get_api_credentials तुमच्या कोडला recipient सह उत्तर देण्यासाठी लागणारे सर्व देते.
Cloud API वेबहुकमध्ये BSUID कधी येऊ लागले, ते वापरकर्तानावे WhatsApp वापरकर्त्यांपर्यंत पोहोचण्याआधी.
APIs ने BSUID ला पाठवलेले मेसेज कधीपासून स्वीकारण्यास सुरुवात केली, त्यासाठी to ऐवजी recipient सेट केला जातो.
प्रति व्यवसाय फोन नंबर लुकबॅक कालावधी, ज्यामध्ये वापरकर्त्याशी झालेला कोणताही मेसेज किंवा कॉल त्याचा नंबर वेबहुकमध्ये ठेवतो.
BSUID मधील दोन अक्षरी देश कोड आणि कालावधीनंतरचे बहुतांश अल्फान्यूमेरिक वर्ण.
Messages API त्रुटी: या मेसेजसाठी व्यवसाय-स्कोप्ड वापरकर्ता आयडी (BSUID) प्राप्तकर्ते समर्थित नाहीत.
फोन नंबराशिवाय कळवलेल्या 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?" }
}]
}
}]
}]
}status वेबहुक कसे बदलतात?
पाठवलेल्या, डिलिव्हर झालेल्या आणि वाचलेल्या status मध्ये contacts array येतो, ज्यात वापरकर्त्याचे नाव, user_id, नंबर शेअर करता येत असल्यास wa_id, आणि delivered व read वर username असते. statuses मध्ये recipient_user_id BSUID धरतो, आणि जेव्हा तुम्ही BSUID वर पाठवले आणि नंबर शेअर करता येत नाही, तेव्हा recipient_id वगळला जातो. अयशस्वी status ला contacts array नसतो, आणि मेसेज फोन नंबरवर गेला असेल तर recipient_user_id वगळला जातो, म्हणून अपयश मेसेज id शी जोडा.
वापरकर्त्यांना कसे साठवावे आणि जुळवावे?
प्रथम BSUID द्वारे, आणि फोन नंबर आल्यावर तो दुसरी की म्हणून वापरा. संपूर्ण BSUID string म्हणून साठवा, देश कोड आणि कालावधीसह, कारण कोणताही भाग बदलणाऱ्या विनंत्या Meta नाकारते, आणि तुमचे पोर्टफोलिओ नोंदणीकृत असतील तर पॅरेंट BSUID देखील साठवा. नंबर येत असताना विद्यमान रेकॉर्ड wa_id वर जोडा आणि BSUID त्यांच्यासोबत ठेवा, कारण नंतर वापरकर्तानाव स्वीकारणारा वापरकर्ता नंबराशिवाय परत येऊ शकतो. Meta च्या FAQ मध्ये CRM मध्ये आणि त्यांना पुरवणाऱ्या टूल्समध्ये हीच जोडणी मागितली आहे.
वापरकर्त्याने फोन नंबर बदलला तर काय होते?
त्यांचा BSUID पुन्हा तयार होतो, आणि बदल messages फील्डवर सिस्टम मेसेज म्हणून येतो, कारण Meta कडे सबस्क्राइब करण्यासाठी user_id_update फील्ड नाही. नवा नंबर तुमच्याशी शेअर करता येत असल्यास system.type user_changed_number असतो, आणि फक्त BSUID बदल कळवता येत असल्यास user_changed_user_id असतो; 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 authentication टेम्प्लेट वगळता कोणताही मेसेज प्रकार चालतो, कारण त्यांना फोन नंबर लागतो, आणि फक्त त्याच व्यवसाय पोर्टफोलिओमधील नंबर 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 मेसेज म्हणून पाठवले जाते. ज्या वापरकर्त्याने ते टॅप केले तो थ्रेडमध्ये आपला नंबर शेअर करतो, आणि contacts वेबहुक येतो, ज्यात origin contact_request असतो आणि नंबर phones[].wa_id मध्ये असतो; हाताने शेअर केलेला संपर्क origin other आणि vCard सह येतो. Meta ने हे बटण जुलै 2026 च्या सुरुवातीला उपलब्ध केले, आणि त्याचे लेबल बदलता येत नाही.
संपर्क यादी म्हणजे काय?
प्रत्येक व्यवसाय पोर्टफोलिओसाठी 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 array जोडला जातो, आणि 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 लिंक तुमच्या endpoint वर नमुना पाठवते. यात चार परिस्थितींसाठी येणारे मेसेज आणि status तपासले जातात:
- वापरकर्तानाव नसलेला वापरकर्ता: BSUID आणि फोन नंबर फील्ड, आणि username नाही.
- नंबर उपलब्ध नसलेला वापरकर्तानाव असलेला वापरकर्ता: username आणि BSUID, फोन नंबर फील्ड नाहीत.
- नंबर उपलब्ध असलेला वापरकर्तानाव असलेला वापरकर्ता: username, BSUID आणि फोन नंबर.
- पॅरेंट BSUID मध्ये नोंदणी झालेला पोर्टफोलिओ: पोर्टफोलिओच्या स्वतःच्या BSUID शेजारी पॅरेंट BSUID.
easyCoexistence BSUID कसे हाताळते?
ते Meta पाठवते त्याच स्वरूपात पुढे पाठवते. set_webhook_destination सह तुमच्या endpoint कडे रूट केलेला नंबर त्याचे messages आणि smb_message_echoes वेबहुक थेट Meta कडून मिळवतो, user_id, from_user_id, to_user_id आणि username सह; आणि ऑटोमेशन किंवा फॉरवर्डिंग चालू असताना easyCoexistence Meta ने पाठवलेले मूल्य बदल न करता फॉरवर्ड करते. BSUID ला उत्तर देण्यासाठी तुमचा कोड get_api_credentials वापरतो, जे नंबरचा फोन नंबर ID, त्याचा send endpoint आणि उपलब्ध असल्यास तुमचा स्वतःचा टोकन परत करते; 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 प्रत्येक status बदल कळवते.
BSUID व्यवसाय पोर्टफोलिओंमध्ये काम करतो का?
नाही. BSUID एका पोर्टफोलिओ आणि वापरकर्त्याचा असतो, आणि दुसऱ्या पोर्टफोलिओमधील नंबर त्याला मेसेज करू शकत नाही. Meta ज्या व्यवस्थापित व्यवसायांची नोंदणी करते त्यांना पॅरेंट BSUID मिळतात, देश कोडनंतर ENT सह, जे त्यांच्या नोंदणीकृत पोर्टफोलिओंमध्ये काम करतात.
WhatsApp नंबरसाठी easyCoexistence चा खर्च किती आहे?
प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, तुमच्याकडे किती कनेक्शन आहेत त्यावर अवलंबून, आणि पहिले 3 दिवस मोफत. Meta चे स्वतःचे मेसेज शुल्क तुमच्या WhatsApp Business Account च्या पेमेंट पद्धतीवरच राहते.
पुढे वाचा
सुरुवात करण्यासाठी तयार आहात?
WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.
मोफत ट्रायल सुरू करापडताळले: