Majina ya watumiaji wa WhatsApp na vitambulisho vya BSUID: kinachobadilika kwenye webhooks za Cloud API
Majina ya watumiaji wa WhatsApp huwaruhusu watumiaji kuonyesha jina badala ya nambari yao ya simu. Kwa hiyo, tangu mapema Aprili 2026, webhooks za Cloud API za messages pia hubeba kitambulisho cha BSUID cha biashara, kama US.13491208655302741918, katika user_id na from_user_id. Kwa mtumiaji mwenye jina la mtumiaji ambaye hajawasiliana na nambari hiyo kwa ujumbe au simu ndani ya siku 30 na hayumo kwenye kitabu cha anwani, wa_id na from huachwa.
easyCoexistence huunganisha nambari ya programu ya WhatsApp Business kwenye Cloud API kupitia Coexistence na kupeleka webhooks za messages na smb_message_echoes kwenye endpoint yako kama Meta inavyozituma, pamoja na sehemu za BSUID, huku get_api_credentials ikikupa msimbo wako kile kinachohitajika ili ujibu kwa recipient.
BSUID zilianza kuonekana kwenye webhooks za Cloud API kabla ya majina ya watumiaji kuwafikia watumiaji wa WhatsApp.
APIs zilipoanza kukubali ujumbe unaotumwa kwa BSUID, ukiwekwa katika recipient badala ya to.
Muda wa kurejelea, kwa kila nambari ya simu ya biashara, ambao ndani yake ujumbe au simu yoyote na mtumiaji huweka nambari yake kwenye webhooks.
Herufi na nambari nyingi baada ya msimbo wa nchi wa herufi mbili na nukta ya BSUID.
Hitilafu ya Messages API: "Business-scoped User ID (BSUID) recipients are not supported for this message."
Aina ya ujumbe wa mfumo kwa mabadiliko ya BSUID yanayoripotiwa bila nambari ya simu, na BSUID ya zamani katika previous_user_id.
Majina ya watumiaji wa WhatsApp na BSUID ni nini?
Jina la mtumiaji ni jina la hiari na la kipekee ambalo mtumiaji wa WhatsApp anaweza kuweka, linaloonyeshwa kwenye programu badala ya nambari yake ya simu. Meta inaanzisha majina ya watumiaji hatua kwa hatua mwaka wa 2026. BSUID ni kitambulisho cha nyuma ambacho Meta iliongeza ili biashara ziendelee kutofautisha watumiaji: huundwa kiotomatiki, ni cha kipekee kwa kila jozi ya Business Portfolio na mtumiaji, na huandikwa kama msimbo wa nchi wa herufi mbili wa ISO 3166, nukta, na herufi na nambari hadi 128. Meta inawataka washirika na biashara zilizounganishwa moja kwa moja kukiunga mkono, kwa sababu hakuna biashara inayodhibiti kama watumiaji wake wanachukua majina ya watumiaji.
Ni sehemu zipi zinazobeba vitambulisho vipya?
Sehemu mpya zipo karibu na zile zilizoshikilia nambari ya simu, katika webhooks za messages, status, system na user_preferences. Sehemu za mzazi zinaonekana tu kwa Business Portfolio ambazo Meta imewasajili kwenye parent BSUID, zinazofanya kazi katika Business Portfolio zilizosajiliwa:
Nambari ya simu inaachwa lini?
Mtumiaji akiwa na jina la mtumiaji na hakuna kati ya masharti matatu ya Meta yanayotimia. Nambari hubaki kwenye webhooks iwapo nambari ya simu ya biashara ilimtumia ujumbe au kumpigia simu nambari ya mtumiaji ndani ya siku 30 zilizopita, au ilipokea ujumbe au simu kutoka kwake katika muda huo, au mtumiaji yuko kwenye kitabu cha anwani cha Business Portfolio. Muda wa siku 30 unahesabiwa kwa kila nambari ya simu ya biashara, kwa hiyo nambari nyingine kwenye Business Portfolio hiyo inaweza kupokea BSUID pekee ya mtumiaji yuleyule. Watumiaji wasio na jina la mtumiaji huendelea kufika wakiwa na nambari yao ya simu na BSUID yao.
Ujumbe unaoingia unaonekanaje sasa?
Kama hapo awali, na BSUID karibu na nambari ya simu au mahali pake. Katika mfano wa Meta wa mtumiaji mwenye jina la mtumiaji ambaye nambari yake haiwezi kushirikiwa, contacts ina profile.name, profile.username na user_id, na ujumbe una from_user_id mahali ambapo from ilitumika zamani:
{
"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?" }
}]
}
}]
}]
}Webhooks za status zinabadilikaje?
Hali za kutumwa, kufikishwa na kusomwa zinapata safu ya contacts yenye jina la mtumiaji, user_id, wa_id nambari inapoweza kushirikiwa, na username kwenye delivered na read. Kwenye statuses, recipient_user_id hubeba BSUID, na recipient_id huachwa unapotuma kwa BSUID na nambari haiwezi kushirikiwa. Hali ya kushindwa haina safu ya contacts, na haitaji recipient_user_id ujumbe ulipotumwa kwa nambari ya simu, kwa hiyo unganisha kushindwa na message id.
Unapaswa kuhifadhi na kulinganisha watumiaji vipi?
Kwa BSUID kwanza, na nambari ya simu kama ufunguo wa pili kila inapofika. Hifadhi BSUID yote kama string, pamoja na msimbo wa nchi na nukta, kwa kuwa Meta hukataa maombi yanayobadilisha sehemu yoyote yake, na hifadhi pia parent BSUID ikiwa Business Portfolio zako zimesajiliwa. Unganisha rekodi zilizopo kwa wa_id wakati bado inafika, na weka BSUID pembeni yake, kwa sababu mtumiaji anayechukua jina la mtumiaji baadaye anaweza kurudi bila nambari. FAQ ya Meta inaomba miunganisho hiyo hiyo katika CRM na katika zana zinazopokea data hiyo.
Mtumiaji akibadilisha nambari yake ya simu, nini hutokea?
BSUID yake huundwa upya, na mabadiliko hufika kwenye uwanja wa messages kama ujumbe wa mfumo, kwa sababu Meta haina sehemu ya user_id_update ya kujiandikisha. system.type ni user_changed_number nambari mpya inapoweza kushirikiwa nawe, au user_changed_user_id mabadiliko ya BSUID pekee yanapoweza kuripotiwa; system.user_id hubeba BSUID mpya na system.previous_user_id ile ya zamani, hivyo ndivyo rekodi inavyohamia. Shughulikia aina zote mbili.
Unamjibu vipi mtumiaji anayejulikana kwa BSUID pekee?
Tuma kwa /<BUSINESS_PHONE_NUMBER_ID>/messages ukiweka recipient kuwa BSUID na to ikiachwa; zote mbili zikiwepo, to ndiyo inashinda na jibu linaenda kwa nambari ya simu. Ingizo la contacts la jibu basi lina input na user_id badala ya wa_id. Aina yoyote ya ujumbe inafanya kazi isipokuwa template za uthibitishaji za one-tap, zero-tap na copy code, zinazohitaji nambari ya simu, na nambari zilizo ndani ya Business Portfolio hiyo hiyo pekee ndizo zinaweza kufikia BSUID. Hitilafu 131062 inamaanisha aina ya ujumbe haikubali wapokeaji wa BSUID.
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"recipient": "US.13491208655302741918",
"type": "text",
"text": { "body": "Yes, it also comes in blue." }
}Unamwomba vipi mtumiaji nambari yake ya simu?
Kwa kitufe cha REQUEST_CONTACT_INFO, kilichoongezwa kwenye template ya huduma au masoko, au kutumwa kama ujumbe wa mwingiliano wa aina request_contact_info. Mtumiaji anayekibonyeza hushiriki nambari yake kwenye mazungumzo, na webhook ya contacts inafika ikiwa na origin iliyowekwa contact_request na nambari katika phones[].wa_id; anwani inayoshirikiwa kwa mkono inafika ikiwa na origin other na vCard. Meta ilifanya kitufe hiki kipatikane mapema Julai 2026, na lebo yake haiwezi kubadilishwa.
Kitabu cha anwani ni nini?
Hifadhi ambayo Meta inaiendesha kwa kila Business Portfolio, bila kazi yoyote ya kuunganisha: mara nambari ya simu ya biashara inapotuma ujumbe, kupiga simu au kupokea kutoka kwa nambari ya simu ya mtumiaji, nambari hiyo na BSUID huhifadhiwa na kutumika kujaza webhooks za baadaye kwa nambari ya simu, iwe mtumiaji ana jina la mtumiaji au la. Mwingiliano baada ya uzinduzi wake pekee ndio unahesabika. Unaweza kuizima katika Meta Business Suite, Mipangilio ya biashara, Taarifa za biashara, jambo linalofuta kilichomo, na GET au DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book yenye bsuid inakagua au kuondoa ingizo moja.
Mabadiliko gani yanapaswa kufanywa na muunganisho wa Coexistence?
Ushughulikiaji wake wa webhooks tatu ambazo nambari ya Coexistence pekee inazipata, nazo pia zinabadilika. Katika history, kila mazungumzo yanapata kitu cha context chenye wa_id, user_id na username, na ujumbe wake unapata from_user_id. Katika smb_message_echoes, safu ya contacts inaongezwa, na message_echoes[].to inaweza kuachwa huku to_user_id ikibeba BSUID; mabadiliko na ufutaji vinavyofanywa kwenye programu ya WhatsApp Business vinafika kwa njia hiyo hiyo. Katika smb_app_state_sync, phone_number ya mwasiliani inaweza kuachwa, na user_id na username zikiwa pembeni yake. Linganisha echoes na mazungumzo yaliyoingizwa kwa user_id pamoja na nambari.
Unaweza kujaribu vipi kabla watumiaji hawajachukua majina ya watumiaji?
Kwa zana ya majaribio ya Meta kwenye App Dashboard: chini ya Use cases, Connect with customers through WhatsApp, Customize, Configuration, kiungo cha Test kilicho karibu na webhook ya messages hutuma sampuli kwenye endpoint yako. Inashughulikia ujumbe unaoingia na status katika hali nne:
- Mtumiaji asiye na jina la mtumiaji: sehemu za BSUID na nambari ya simu, bila jina la mtumiaji.
- Mtumiaji mwenye jina la mtumiaji ambaye nambari yake haipatikani: jina la mtumiaji na BSUID, bila sehemu za nambari ya simu.
- Mtumiaji mwenye jina la mtumiaji ambaye nambari yake inapatikana: jina la mtumiaji, BSUID na nambari ya simu.
- Business Portfolio iliyosajiliwa kwenye parent BSUID: parent BSUID pembeni ya BSUID ya Business Portfolio yenyewe.
easyCoexistence inashughulikiaje BSUID?
Inazipitisha kama Meta inavyozituma. Nambari inayoelekezwa kwenye endpoint yako kwa set_webhook_destination inapata webhooks zake za messages na smb_message_echoes moja kwa moja kutoka Meta, ikiwa na user_id, from_user_id, to_user_id na username, na kukiwa na automations au usambazaji umewashwa, easyCoexistence husambaza thamani ambayo Meta ilituma bila kubadilishwa. Ili kujibu BSUID, msimbo wako hutumia get_api_credentials, ambayo hurudisha phone number ID ya nambari, endpoint yake ya kutuma na, ikiwezekana, token yako mwenyewe; zana za send_message na send_template zinapokea nambari ya simu katika tarakimu za kimataifa.
Makosa ya kawaida
- Kuweka wa_id pekee kama ufunguo wa wawasiliani. Mtumiaji mwenye jina la mtumiaji ambaye hajawasiliana na nambari hiyo kwa siku 30 hufika na user_id na from_user_id pekee, na kishughulikiaji kinachohitaji wa_id kinakosa ujumbe.
- Kukata kiambishi cha nchi cha BSUID. Meta inataka thamani yote, msimbo wa nchi na nukta vikiwemo, na ombi lenye sehemu yoyote iliyobadilishwa linashindwa.
- Kusubiri sehemu ya user_id_update. Meta haina sehemu hiyo: mabadiliko ya BSUID hufika kwenye messages kama ujumbe wa mfumo wa aina user_changed_number au user_changed_user_id.
- Kulinganisha echoes za Coexistence kwa to pekee. Kwenye smb_message_echoes sehemu ya to inaweza kuachwa, kwa hiyo jibu lililoandikwa kwenye programu halitaonekana isipokuwa to_user_id nayo ilinganishwe.
Kila muunganisho unafuatiliwa saa 24 kwa siku. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unapoongeza miunganisho, na siku 3 za kwanza ni bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, watumiaji wasio na jina la mtumiaji nao wanapata BSUID?
Ndiyo. Meta huweka user_id kwenye webhooks za messages iwe mtumiaji ana jina la mtumiaji au hana, kwa hiyo watumiaji wengi hufika wakiwa na nambari yao ya simu na BSUID yao.
Je, nambari ya Coexistence inaweza kuwa na jina la mtumiaji la biashara?
Ndiyo. Tangu Juni 29, 2026 biashara inaweza kulichukua au kulibadilisha katika Meta Business Suite, WhatsApp Manager, programu ya WhatsApp Business au Username API; halificha nambari ya biashara, na business_username_updates huripoti kila mabadiliko ya hali.
Je, BSUID hufanya kazi katika Business Portfolio zote?
Hapana. BSUID ni ya Business Portfolio moja na mtumiaji mmoja, na nambari iliyo kwenye Business Portfolio nyingine haiwezi kumtumia ujumbe. Biashara zinazosimamiwa ambazo Meta inazisajili hupata parent BSUID, yenye ENT baada ya msimbo wa nchi, zinazofanya kazi katika Business Portfolio zao zilizosajiliwa.
easyCoexistence inagharimu kiasi gani kwa nambari moja ya WhatsApp?
US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kulingana na idadi ya miunganisho yako, na siku 3 za kwanza ni bila malipo. Ada za ujumbe zake za Meta zinabaki kwenye njia ya malipo ya WhatsApp Business Account yako.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye