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 వెబ్హుక్లను, BSUID ఫీల్డ్లతో సహా, Meta పంపినట్లుగానే మీ ఎండ్పాయింట్కు రూట్ చేస్తుంది; get_api_credentials మీ కోడ్కు recipient తో ప్రత్యుత్తరం ఇవ్వడానికి అవసరమైనవి అందిస్తుంది.
BSUIDలు Cloud API వెబ్హుక్లలో కనిపించడం ఎప్పుడు మొదలైంది, యూజర్నేమ్లు WhatsApp వినియోగదారులకు చేరడానికి ముందే.
APIలు BSUIDకి పంపిన మెసేజ్లను ఎప్పుడు అంగీకరించడం మొదలుపెట్టాయి, to బదులు recipient లో సెట్ చేసి.
ప్రతి వ్యాపార ఫోన్ నంబర్కు లెక్కించే లుక్బ్యాక్ వ్యవధి; ఈ సమయంలో యూజర్తో ఏ మెసేజ్ లేదా కాల్ జరిగినా వెబ్హుక్లలో వారి నంబర్ ఉంటుంది.
BSUID యొక్క రెండు అక్షరాల దేశ కోడ్ మరియు పీరియడ్ తర్వాత చాలా వరకు ఆల్ఫాన్యూమరిక్ అక్షరాలు.
Messages API లోపం, ఈ సందేశంతో: "Business-scoped User ID (BSUID) recipients are not supported for this message."
ఫోన్ నంబర్ లేకుండా నివేదించబడిన BSUID మార్పు కోసం సిస్టమ్ మెసేజ్ రకం, పాత BSUID previous_user_id లో.
WhatsApp యూజర్నేమ్లు మరియు BSUIDలు అంటే ఏమిటి?
యూజర్నేమ్ అనేది WhatsApp వినియోగదారు సెట్ చేసుకోగల ఐచ్ఛిక, ప్రత్యేక పేరు; యాప్లో ఫోన్ నంబర్ బదులు ఇది కనిపిస్తుంది. Meta 2026లో యూజర్నేమ్లను క్రమంగా విడుదల చేస్తోంది. BSUID అనేది వ్యాపారాలు వినియోగదారులను ఇప్పటికీ వేరుగా గుర్తించడానికి Meta జోడించిన బ్యాక్ఎండ్ ఐడెంటిఫైయర్: ఇది స్వయంచాలకంగా తయారవుతుంది, ప్రతి Business Portfolio మరియు యూజర్ జతకు ప్రత్యేకం, మరియు ISO 3166 రెండు అక్షరాల దేశ కోడ్, పీరియడ్ మరియు గరిష్టంగా 128 ఆల్ఫాన్యూమరిక్ అక్షరాలుగా రాయబడుతుంది. ఏ వ్యాపారమూ తన వినియోగదారులు యూజర్నేమ్లు స్వీకరిస్తారో నియంత్రించలేరు కాబట్టి, Meta భాగస్వాములు మరియు నేరుగా ఇంటిగ్రేట్ అయిన వ్యాపారాలు దీనికి మద్దతు ఇవ్వాలని కోరుతుంది.
ఏ ఫీల్డ్లు కొత్త ఐడెంటిఫైయర్లను కలిగి ఉంటాయి?
messages, status, system మరియు user_preferences వెబ్హుక్లలో, ఫోన్ నంబర్ ఉన్న ఫీల్డ్ల పక్కన కొత్త ప్రాపర్టీలు. Meta parent BSUIDలలో నమోదు చేసిన Business Portfolio లకు మాత్రమే parent ఫీల్డ్లు కనిపిస్తాయి; అవి నమోదైన పోర్ట్ఫోలియోల మధ్య పనిచేస్తాయి:
ఫోన్ నంబర్ ఎప్పుడు వదిలివేయబడుతుంది?
యూజర్కు యూజర్నేమ్ ఉండి, Meta యొక్క మూడు షరతులలో ఏదీ వర్తించనప్పుడు. వ్యాపార ఫోన్ నంబర్ గత 30 రోజుల్లో ఆ యూజర్ నంబర్కు మెసేజ్ చేసినా లేదా కాల్ చేసినా, ఆ సమయంలో ఆ నంబర్ నుండి మెసేజ్ లేదా కాల్ అందుకున్నా, లేదా యూజర్ Business Portfolio యొక్క కాంటాక్ట్ బుక్లో ఉన్నా నంబర్ వెబ్హుక్లలోనే ఉంటుంది. 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 వెబ్హుక్లు ఎలా మారతాయి?
పంపిన, డెలివరీ అయిన మరియు చదివిన స్టేటస్లకు యూజర్ పేరు, 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 ఆధారంగా జతచేయండి, మరియు BSUIDని వాటి పక్కన ఉంచండి, ఎందుకంటే తర్వాత యూజర్నేమ్ తీసుకున్న యూజర్ నంబర్ లేకుండా తిరిగి రావచ్చు. CRMలు మరియు వాటికి డేటా అందించే సాధనాల్లో ఇవే జాయిన్లను Meta FAQ కోరుతుంది.
యూజర్ ఫోన్ నంబర్ మార్చినప్పుడు ఏమవుతుంది?
వారి BSUID మళ్లీ తయారవుతుంది, మరియు మార్పు messages ఫీల్డ్పై system మెసేజ్గా వస్తుంది, ఎందుకంటే సబ్స్క్రయిబ్ చేయడానికి 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 టెంప్లేట్లు తప్ప ఏ మెసేజ్ రకమైనా పనిచేస్తుంది, ఎందుకంటే వాటికి ఫోన్ నంబర్ అవసరం; అదే Business Portfolio లోని నంబర్లు మాత్రమే 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 బటన్తో, దానిని యుటిలిటీ లేదా మార్కెటింగ్ టెంప్లేట్కు జోడించి, లేదా request_contact_info రకం ఇంటరాక్టివ్ మెసేజ్గా పంపి. ఆ బటన్ను నొక్కిన యూజర్ తమ నంబర్ను థ్రెడ్లో పంచుకుంటారు, మరియు origin contact_request అయి నంబర్ phones[].wa_id లో ఉన్న contacts వెబ్హుక్ వస్తుంది; చేతితో పంచుకున్న కాంటాక్ట్ origin other మరియు vCard తో వస్తుంది. Meta ఈ బటన్ను 2026 జూలై ప్రారంభంలో అందుబాటులోకి తెచ్చింది, దాని లేబుల్ను అనుకూలీకరించలేరు.
కాంటాక్ట్ బుక్ అంటే ఏమిటి?
ప్రతి Business Portfolio కోసం Meta హోస్ట్ చేసే స్టోర్, ఇంటిగ్రేషన్ పని అవసరం లేకుండా: ఒక వ్యాపార ఫోన్ నంబర్ యూజర్ ఫోన్ నంబర్కు మెసేజ్ చేసినా, కాల్ చేసినా, లేదా దాని నుండి విన్నా, ఆ నంబర్ మరియు BSUID నమోదు అవుతాయి, మరియు యూజర్నేమ్ ఉన్నా లేకపోయినా తర్వాతి వెబ్హుక్లను ఫోన్ నంబర్తో నింపడానికి ఉపయోగించబడతాయి. దాని ప్రారంభం తర్వాత జరిగిన పరస్పర చర్యలు మాత్రమే లెక్కించబడతాయి. Meta Business Suite లో, వ్యాపార సెట్టింగ్లు, వ్యాపార సమాచారం కింద దీనిని ఆఫ్ చేయవచ్చు; ఇది దానిలోని డేటాను తొలగిస్తుంది. 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 ఉంటాయి. echoes మరియు దిగుమతి చేసిన చాట్లను నంబర్తో పాటు user_id ఆధారంగా కూడా సరిపోల్చండి.
యూజర్లు యూజర్నేమ్లు స్వీకరించే ముందు ఎలా పరీక్షించాలి?
యాప్ డాష్బోర్డ్ లోని Meta టెస్ట్ టూల్తో: Use cases కింద, Connect with customers through WhatsApp, Customize, Configuration, messages వెబ్హుక్ పక్కన ఉన్న Test లింక్ మీ ఎండ్పాయింట్కు నమూనా పంపుతుంది. ఇది నాలుగు సందర్భాలలో ఇన్కమింగ్ మెసేజ్లు మరియు స్టేటస్లను కవర్ చేస్తుంది:
- యూజర్నేమ్ లేని యూజర్: BSUID మరియు ఫోన్ నంబర్ ఫీల్డ్లు, యూజర్నేమ్ లేదు.
- నంబర్ అందుబాటులో లేని యూజర్నేమ్ ఉన్న యూజర్: username మరియు BSUID, ఫోన్ నంబర్ ఫీల్డ్లు లేవు.
- నంబర్ అందుబాటులో ఉన్న యూజర్నేమ్ ఉన్న యూజర్: username, BSUID మరియు ఫోన్ నంబర్.
- parent BSUIDs లో నమోదైన Business Portfolio: దాని సొంత BSUID పక్కన ఒక parent BSUID.
easyCoexistence BSUIDలను ఎలా నిర్వహిస్తుంది?
Meta పంపినట్లుగానే వాటిని పంపుతుంది. set_webhook_destination తో మీ ఎండ్పాయింట్కు రూట్ చేసిన నంబర్ messages మరియు smb_message_echoes వెబ్హుక్లను నేరుగా Meta నుండి పొందుతుంది, వాటిలో user_id, from_user_id, to_user_id మరియు username కూడా ఉంటాయి; ఆటోమేషన్లు లేదా ఫార్వార్డింగ్ ఆన్ చేసి ఉంటే, easyCoexistence Meta పంపిన విలువను మార్పు లేకుండా ఫార్వార్డ్ చేస్తుంది. BSUIDకి ప్రత్యుత్తరం ఇవ్వడానికి మీ కోడ్ get_api_credentials ను ఉపయోగిస్తుంది, ఇది నంబర్ యొక్క phone number ID, దాని send ఎండ్పాయింట్ మరియు అందుబాటులో ఉంటే మీ స్వంత టోకెన్ను ఇస్తుంది; send_message మరియు send_template టూల్స్ అంతర్జాతీయ డిజిట్లలో ఫోన్ నంబర్ తీసుకుంటాయి.
సాధారణ పొరపాట్లు
- wa_id మాత్రమే ఆధారంగా కాంటాక్ట్లను కీ చేయడం. గత 30 రోజులుగా నంబర్తో ఎలాంటి సంబంధం లేని యూజర్నేమ్ ఉన్న యూజర్ కేవలం user_id మరియు from_user_id తో వస్తారు, మరియు wa_id ను కోరే హ్యాండ్లర్ ఆ మెసేజ్ను కోల్పోతుంది.
- BSUID యొక్క దేశ ప్రిఫిక్స్ను కత్తిరించడం. Meta మొత్తం విలువను కోరుతుంది, దేశ కోడ్ మరియు పీరియడ్తో సహా, మరియు దానిలో ఏ భాగాన్ని మార్చినా అభ్యర్థన విఫలమవుతుంది.
- user_id_update ఫీల్డ్ కోసం వేచి ఉండటం. Metaకి అది లేదు: BSUID మార్పులు user_changed_number లేదా user_changed_user_id రకాల system మెసేజ్లుగా messages పై వస్తాయి.
- to మీద మాత్రమే Coexistence echoes ను సరిపోల్చడం. 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 నమోదు చేసే నిర్వహిత వ్యాపారాలకు parent BSUIDలు లభిస్తాయి, దేశ కోడ్ తర్వాత ENT తో, ఇవి వారి నమోదైన పోర్ట్ఫోలియోలలో పనిచేస్తాయి.
WhatsApp నంబర్కు easyCoexistence ఎంత ఖర్చు అవుతుంది?
కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీకు ఎన్ని కనెక్షన్లు ఉన్నాయో బట్టి, మరియు మొదటి 3 రోజులు ఉచితం. Meta యొక్క సొంత మెసేజ్ ఛార్జీలు మీ WhatsApp Business ఖాతా యొక్క చెల్లింపు పద్ధతిలోనే ఉంటాయి.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ