WhatsApp usernames සහ ව්යාපාර-සීමිත පරිශීලක ID (BSUID): Cloud API webhooks හි වෙනස්කම්
WhatsApp usernames මගින් පරිශීලකයන්ට ඔවුන්ගේ දුරකථන අංකය වෙනුවට නමක් පෙන්විය හැක. ඒ නිසා 2026 අප්රේල් මාසයේ මුල් භාගයේ සිට Cloud API messages webhooks හි user_id සහ from_user_id තුළ ව්යාපාර-සීමිත පරිශීලක ID (BSUID) එකක්ද ලැබේ, උදා: US.13491208655302741918. username ඇති, දින 30ක් තුළ ව්යාපාර අංකය සමග පණිවිඩයක් හෝ ඇමතුමක් නොවූ, contact book හි නොමැති පරිශීලකයෙකු සඳහා wa_id සහ from ඉවත් කරනු ලැබේ.
easyCoexistence, WhatsApp Business යෙදුමේ අංකය Coexistence හරහා Cloud API වෙත සම්බන්ධ කර, එහි messages සහ smb_message_echoes webhooks Meta යවන ආකාරයටම ඔබේ endpoint වෙත යොමු කරයි, BSUID ක්ෂේත්ර ඇතුළුව.
WhatsApp usernames පරිශීලකයන් වෙත ළඟා වීමට පෙර, BSUID Cloud API webhooks හි දිස්වීමට පටන් ගත් කාලය.
API මගින් BSUID වෙත යවන පණිවිඩ පිළිගැනීමට පටන් ගත් කාලය, to වෙනුවට recipient හි සකසනු ලැබේ.
ව්යාපාර දුරකථන අංකය අනුව කාල සීමාව (lookback), ඒ තුළ පරිශීලකයා සමග පණිවිඩයක් හෝ ඇමතුමක් webhooks හි ඔවුන්ගේ අංකය තබා ගනී.
BSUID හි දෙඅකුරු රට කේතයට සහ තිතට පසු උපරිම අක්ෂර-අංක 128ක්.
Messages API error: Business-scoped User ID (BSUID) recipients are not supported for this message.
දුරකථන අංකයක් නොමැතිව වාර්තා වන BSUID වෙනසක් සඳහා system පණිවිඩ වර්ගය, පැරණි BSUID previous_user_id තුළ.
WhatsApp usernames සහ BSUID යනු කුමක්ද?
username යනු WhatsApp පරිශීලකයෙකුට සකසා ගත හැකි, අද්විතීය, විකල්ප නමකි. එය දුරකථන අංකය වෙනුවට යෙදුම තුළ පෙන්වයි. Meta විසින් 2026 තුළ usernames ක්රමයෙන් හඳුන්වා දෙමින් සිටී. BSUID යනු ව්යාපාරවලට පරිශීලකයන් තවමත් වෙන්කර හඳුනා ගැනීමට Meta විසින් එක් කළ backend හඳුනාගැනීමකි: එය ස්වයංක්රීයව ජනනය වන අතර, එක් එක් Business Portfolio සහ පරිශීලක යුගලයට අද්විතීය වේ, ISO 3166 දෙඅකුරු රට කේතය, තිත සහ උපරිම අක්ෂර-අංක 128ක් ලෙස ලියැවේ. Meta සහකරුවන් සහ සෘජුව ඒකාබද්ධ වූ ව්යාපාරවලින් එය සහාය දැක්වීම ඉල්ලයි, මන්ද කිසිදු ව්යාපාරයක් පරිශීලකයන් usernames භාවිතා කිරීම පාලනය නොකරයි.
නව හඳුනාගැනීම් ක්ෂේත්ර මොනවාද?
දුරකථන අංකය තබා ගත් ක්ෂේත්රවලට අමතරව නව ගුණාංග, messages, status, system සහ user_preferences webhooks හරහා දිස්වේ. parent ක්ෂේත්ර දිස්වන්නේ Meta විසින් parent BSUIDs සඳහා ලියාපදිංචි කර ඇති Business Portfolio සඳහා පමණි, ඒවා ලියාපදිංචි Portfolio අතර ක්රියා කරයි:
දුරකථන අංකය ඉවත් වන්නේ කවදාද?
පරිශීලකයාට username එකක් ඇති විට, සහ Meta හි කොන්දේසි තුනෙන් කිසිවක් සත්ය නොවන විට. අංකය webhooks හි පවතින්නේ ව්යාපාර දුරකථන අංකය පසුගිය දින 30 තුළ පරිශීලකයාගේ අංකයට පණිවිඩයක් යැවූ හෝ ඇමතුමක් කළ විට, එම කාලය තුළ එම අංකයෙන් පණිවිඩයක් හෝ ඇමතුමක් ලැබුණු විට, හෝ පරිශීලකයා Business Portfolio හි contact book හි සිටින විට ය. 30 දින කාල සීමාව ගණනය වන්නේ ව්යාපාර දුරකථන අංකය අනුව ය, එබැවින් එකම Portfolio හි දෙවන අංකයකට එම පරිශීලකයාගේ BSUID පමණක් ලැබිය හැක. username නැති පරිශීලකයන් තවමත් ඔවුන්ගේ දුරකථන අංකය සහ BSUID දෙකම සමග පැමිණේ.
ඇතුළත් වන පණිවිඩයක් දැන් කෙසේ පෙනේද?
පෙර ලෙසමය, BSUID දුරකථන අංකය අසල හෝ එහි ස්ථානයේ. Meta හි උදාහරණයේ, අංකය බෙදාගත නොහැකි username ඇති පරිශීලකයෙකු සඳහා, 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 webhooks වෙනස් වන්නේ කෙසේද?
යවන ලද, බෙදා හරින ලද සහ කියවන ලද statuses වලට පරිශීලකයාගේ නම, user_id, අංකය බෙදාගත හැකි විට wa_id, සහ delivered හා read හි username සහිත contacts array එකක් ලැබේ. statuses හි recipient_user_id BSUID රඳවා ගන්නා අතර, BSUID වෙත යවා අංකය බෙදාගත නොහැකි විට recipient_id ඉවත් වේ. අසාර්ථක status එකකට contacts array එකක් නැති අතර, පණිවිඩය දුරකථන අංකයට ගියේ නම් recipient_user_id ඉවත් වේ, එබැවින් අසාර්ථකත්වය පණිවිඩ id සමග සම්බන්ධ කරන්න.
පරිශීලකයන් ගබඩා කර ගෙන ගළපන්නේ කෙසේද?
පළමුව BSUID මගින්, පැමිණෙන සෑම විටම දුරකථන අංකය දෙවන යතුර ලෙස. BSUID සම්පූර්ණ string එකක් ලෙස, රට කේතය සහ තිත ඇතුළුව ගබඩා කරන්න, මන්ද Meta එහි කිසිදු කොටසක් වෙනස් කරන ඉල්ලීම් ප්රතික්ෂේප කරයි. ඔබේ Portfolio ලියාපදිංචි වී ඇත්නම් parent BSUID ද ගබඩා කරන්න. wa_id තවමත් පැමිණෙන තාක්, ඒ මත පවතින වාර්තා සම්බන්ධ කර, BSUID ඒ අසල තබා ගන්න, මන්ද පසුව username ගන්නා පරිශීලකයෙක් අංකයක් නොමැතිව ආපසු පැමිණිය හැක. Meta හි FAQ ඉල්ලා සිටින්නේ CRM වලටත්, ඒවාට දත්ත පෝෂණය කරන මෙවලම්වලටත් එම සම්බන්ධ කිරීම් ම බවයි.
පරිශීලකයෙක් ඔවුන්ගේ දුරකථන අංකය වෙනස් කළ විට කුමක් වේද?
ඔවුන්ගේ BSUID යළි ජනනය වන අතර, වෙනස messages field එකට system පණිවිඩයක් ලෙස ළඟා වේ, මන්ද Meta හි subscribe කළ හැකි user_id_update field එකක් නැත. system.type අගය user_changed_number වන්නේ නව අංකය ඔබ සමග බෙදාගත හැකි විට, user_changed_user_id වන්නේ BSUID වෙනස පමණක් වාර්තා කළ හැකි විට ය. system.user_id හි නව BSUID ද, system.previous_user_id හි පැරණි BSUID ද ඇති අතර, වාර්තාව ඒ ආකාරයෙන් ගෙන යයි. දෙවර්ගයම හසුරුවන්න.
BSUID පමණක් දන්නා පරිශීලකයෙකුට කෙසේ පිළිතුරු දෙන්නේද?
/<BUSINESS_PHONE_NUMBER_ID>/messages වෙත යවන්න, recipient BSUID ලෙසත් to නොමැතිව ලෙසත් සකසා. දෙකම තිබෙන විට to ජයග්රහණය කර, පිළිතුර දුරකථන අංකය වෙත යයි. ප්රතිචාරයේ contacts ඇතුළත් කිරීමේ input සහ user_id ඇතුළත් වන අතර wa_id නොවේ. one-tap, zero-tap සහ කේතය පිටපත් කිරීමේ authentication templates හැර ඕනෑම පණිවිඩ වර්ගයක් ක්රියා කරයි, මන්ද ඒවාට දුරකථන අංකයක් අවශ්යයි, සහ එකම 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 බොත්තම මගින්, utility හෝ marketing template එකකට එක් කර හෝ request_contact_info වර්ගයේ interactive පණිවිඩයක් ලෙස යවයි. එය තට්ටු කරන පරිශීලකයා සංවාදය තුළ තම අංකය බෙදා ගන්නා අතර, origin contact_request ලෙසත් අංකය phones[].wa_id තුළත් ඇති contacts webhook එකක් පැමිණේ. අතින් බෙදාගත් contact එකක් origin other සහ vCard සමග පැමිණේ. Meta මෙම බොත්තම 2026 ජූලි මුලදී ලබා දුන් අතර, එහි ලේබලය වෙනස් කළ නොහැක.
contact book යනු කුමක්ද?
Meta විසින් සෑම Business Portfolio එකක් සඳහාම සත්කාරකත්වය දරන ගබඩාවක් ය, ඒකාබද්ධ කිරීමේ වැඩක් නොමැතිව: ව්යාපාර දුරකථන අංකය පරිශීලකයාගේ දුරකථන අංකයට පණිවිඩ යවන, ඇමතුම් කරන හෝ ඉන් ඇමතුමක් ලබන විට, එම අංකය සහ BSUID වාර්තා වී, username ඇතත් නැතත් පසුව webhooks දුරකථන අංකයෙන් පුරවන්න භාවිතා වේ. එහි දියත් කිරීමෙන් පසු සිදු වූ අන්තර්ක්රියා පමණක් ගණනට ගැනේ. එය Meta Business Suite හි, ව්යාපාර සැකසුම්, ව්යාපාර තොරතුරු යටතේ අක්රිය කළ හැකි අතර, එය දරන දේ මකා දමයි. GET හෝ DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book මගින්, bsuid සමග, එක් ඇතුළත් කිරීමක් පරීක්ෂා කිරීම හෝ ඉවත් කිරීම කළ හැක.
Coexistence ඒකාබද්ධ කිරීම වෙනස් කළ යුත්තේ කුමක්ද?
Coexistence අංකයට පමණක් ලැබෙන webhooks තුන හසුරුවීම වෙනස් විය යුතු අතර, ඒවාද වෙනස් වේ. history හි, සෑම සංවාදයකටම wa_id, user_id සහ username ඇති context object එකක් එකතු වන අතර, එහි පණිවිඩවලට from_user_id එකතු වේ. smb_message_echoes හි contacts array එකක් එකතු වන අතර, message_echoes[].to ඉවත් වී to_user_id BSUID රඳවයි; WhatsApp Business යෙදුමෙන් කරන සංස්කරණ සහ අවලංගු කිරීම් ද එලෙසම පැමිණේ. smb_app_state_sync හි, contact එකක phone_number ඉවත් විය හැක, එහි පැති වලින් user_id සහ username ඇත. echoes සහ ආනයනය කළ සංවාද user_id අනුව ද අංකය අනුව ද ගළපන්න.
පරිශීලකයන් username භාවිතා කිරීමට පෙර කෙසේ පරීක්ෂා කළ හැකිද?
Meta හි පරීක්ෂණ මෙවලම මගින් Meta යෙදුම් dashboard එකේ: Use cases, Connect with customers through WhatsApp, Customize, Configuration යටතේ messages webhook අසල ඇති Test සබැඳිය, ඔබේ endpoint වෙත නියැදියක් යවයි. එය සිව් අවස්ථාවක් යටතේ ලැබෙන පණිවිඩ සහ status ආවරණය කරයි:
- username නැති පරිශීලකයා: BSUID සහ දුරකථන අංක ක්ෂේත්ර, username නැත.
- අංකය ලබා ගත නොහැකි username ඇති පරිශීලකයා: username සහ BSUID, දුරකථන අංක ක්ෂේත්ර නැත.
- අංකය ලබා ගත හැකි username ඇති පරිශීලකයා: username, BSUID සහ දුරකථන අංකය.
- parent BSUIDs වෙත ලියාපදිංචි Business Portfolio: Portfolio එකේම BSUID අසල parent BSUID එකක්.
easyCoexistence BSUIDs හසුරුවන්නේ කෙසේද?
Meta යවන ආකාරයටම ඒවා ඉදිරියට යවයි. set_webhook_destination සමග ඔබේ endpoint වෙත යොමු කළ අංකයක් Meta වෙතින් messages සහ smb_message_echoes webhooks සෘජුවම ලබන අතර, user_id, from_user_id, to_user_id සහ username ඇතුළත් වේ. automations හෝ forwarding ක්රියාත්මක විට, easyCoexistence Meta යැවූ අගය වෙනස් නොකර ඉදිරියට යවයි. BSUID වෙත පිළිතුරු දීමට, ඔබේ කේතය get_api_credentials භාවිතා කරයි, එය අංකයේ phone_number_id, එහි send endpoint එක සහ ලබා ගත හැකි නම් ඔබේම token එක ලබා දෙයි. send_message සහ send_template මෙවලම් ජාත්යන්තර ඉලක්කම් ආකාරයෙන් දුරකථන අංකයක් ගනී.
සාමාන්ය වැරදි
- wa_id පමණක් මත contacts යතුරු කිරීම. 30 දින තුළ අංකය සමග සම්බන්ධතාවයක් නොවූ username ඇති පරිශීලකයෙක් user_id සහ from_user_id පමණක් සමග ළඟා වන අතර, wa_id අවශ්ය handler එකක් පණිවිඩය මග හරී.
- BSUID හි රට උපසර්ගය කපා දැමීම. Meta සම්පූර්ණ අගය, රට කේතය සහ තිත ඇතුළුව ඉල්ලයි, කිසිදු කොටසක් වෙනස් වූ ඉල්ලීමක් අසාර්ථක වේ.
- user_id_update field එකක් බලාපොරොත්තු වීම. Meta එවැනි එකක් නැත: BSUID වෙනස්කම් messages මත user_changed_number හෝ user_changed_user_id වර්ගයේ system පණිවිඩ ලෙස ළඟා වේ.
- Coexistence echoes to පමණක් ගැලපීම. smb_message_echoes හි to ක්ෂේත්රය ඉවත් විය හැකි බැවින්, යෙදුම තුළ ටයිප් කළ පිළිතුර to_user_id ද ගැලපුවේ නැත්නම් නොපෙනී යයි.
get_api_credentials මගින් ඔබේ කේතයට recipient සමග පිළිතුරු දීමට අවශ්ය දේ ලබා දේ. සෑම සම්බන්ධතාවයක්ම 24/7 නිරීක්ෂණය කෙරේ. සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා ගණන වැඩි වන විට අඩු වෙයි, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
username නැති පරිශීලකයන්ටත් BSUID ලැබේද?
ඔව්. පරිශීලකයාට username එකක් ඇතත් නැතත්, Meta messages webhooks වල user_id සකසයි, එබැවින් බොහෝ පරිශීලකයන් ඔවුන්ගේ දුරකථන අංකය සහ BSUID දෙකම සමග පැමිණේ.
Coexistence අංකයකට ව්යාපාර username එකක් තිබිය හැකිද?
ඔව්. 2026 ජූනි 29 සිට ව්යාපාරයකට Meta Business Suite, WhatsApp Manager, WhatsApp Business යෙදුම හෝ Username API හරහා එකක් ගත හැක හෝ වෙනස් කළ හැක. එය ව්යාපාර අංකය සඟවන්නේ නැති අතර, business_username_updates එක් එක් status වෙනසක් වාර්තා කරයි.
BSUID එක Business Portfolio අතර ක්රියා කරයිද?
නැත. BSUID එකක් එක් Portfolio එකක සහ පරිශීලකයෙකුට අයත් වන අතර, වෙනත් Portfolio එකක අංකයකට එය වෙත පණිවිඩ යැවිය නොහැක. Meta ලියාපදිංචි කරන managed ව්යාපාරවලට රට කේතයට පසු ENT සහිත parent BSUIDs ලැබෙන අතර, ඒවා ලියාපදිංචි Portfolio අතර ක්රියා කරයි.
WhatsApp අංකයක් සඳහා easyCoexistence කොපමණ වියදම් වේද?
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, ඔබට ඇති සම්බන්ධතා ගණන අනුව, පළමු දින 3 නොමිලේ. Meta හි තමන්ගේම පණිවිඩ ගාස්තු ඔබේ WhatsApp Business ගිණුමේ ගෙවීම් ක්රමය මත පවතී.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ