WhatsApp korisnička imena i BSUID: što se mijenja u Cloud API webhookovima
WhatsApp korisnička imena omogućuju korisnicima da umjesto broja telefona prikažu ime, pa od početka travnja 2026. poruke u Cloud API webhookovima sadrže i BSUID (identifikator ograničen na poduzeće), primjerice US.13491208655302741918, u poljima user_id i from_user_id. Za korisnika s korisničkim imenom koji u posljednjih 30 dana nije imao poruku ili poziv s brojem i nije u imeniku kontakata, polja wa_id i from ne šalju se.
easyCoexistence povezuje broj aplikacije WhatsApp Business s Cloud API-jem putem značajke Coexistence i prosljeđuje webhookove messages i smb_message_echoes na vaš endpoint onako kako ih Meta šalje, uključujući polja BSUID-a, dok get_api_credentials daje vašem kodu što treba za odgovor s recipient.
Kada su BSUID-ovi počeli dolaziti u Cloud API webhookove, prije nego što korisnička imena dospiju do korisnika.
Kada API-ji počinju prihvaćati poruke poslane na BSUID, postavljene u recipient umjesto u to.
Razdoblje zadržavanja po broju poslovnog telefona u kojem svaka poruka ili poziv s korisnikom čuva njegov broj u webhookovima.
Većina alfanumeričkih znakova nakon dvoslovne oznake države i točke u BSUID-u.
Pogreška Messages API-ja: Business-scoped User ID (BSUID) recipients are not supported for this message.
Vrsta sistemske poruke za promjenu BSUID-a prijavljenu bez broja telefona, sa starim BSUID-om u previous_user_id.
Što su WhatsApp korisnička imena i BSUID-ovi?
Korisničko ime je neobavezan, jedinstven naziv koji korisnik aplikacije WhatsApp može postaviti i koji se u aplikaciji prikazuje umjesto broja telefona; Meta ga postupno uvodi tijekom 2026. BSUID je pozadinski identifikator koji je Meta dodala kako bi poduzeća i dalje mogla razlikovati korisnike: generira se automatski, jedinstven je za svaki par poslovnog portfelja i korisnika, a zapisuje se kao dvoslovna oznaka države prema ISO 3166, točka i do 128 alfanumeričkih znakova. Meta od partnera i izravno integriranih poduzeća traži da ga podrže, jer nijedno poduzeće ne kontrolira hoće li njegovi korisnici prihvatiti korisnička imena.
Koja polja nose nove identifikatore?
Nova svojstva uz postojeća polja s brojem telefona, u webhookovima messages, status, system i user_preferences. Matična polja pojavljuju se samo za poslovne portfelje koje je Meta uključila u matične BSUID-ove, koji vrijede za sve uključene portfelje:
Kada se broj telefona izostavlja?
Kada korisnik ima korisničko ime i nijedan od Metinih triju uvjeta ne vrijedi. Broj ostaje u webhookovima ako je broj poslovnog telefona u posljednjih 30 dana poslao poruku korisniku ili ga nazvao, primio poruku ili poziv od njega ili je korisnik u imeniku kontakata portfelja. Razdoblje od 30 dana broji se po broju poslovnog telefona, pa drugi broj u istom portfelju može za istog korisnika primati samo BSUID. Korisnici bez korisničkog imena i dalje dolaze s brojem telefona i BSUID-om.
Kako sada izgleda dolazna poruka?
Kao i prije, uz BSUID pored broja telefona ili umjesto njega. U Metinom primjeru korisnika s korisničkim imenom čiji se broj ne može podijeliti, contacts sadrži profile.name, profile.username i user_id, a poruka sadrži from_user_id tamo gdje je ranije bio from:
{
"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?" }
}]
}
}]
}]
}Kako se mijenjaju webhookovi statusa?
Statusi: poslano, isporučeno i pročitano dobivaju niz contacts s imenom korisnika, user_id, wa_id kada se broj može podijeliti te username kod isporučenog i pročitanog. U statusima recipient_user_id nosi BSUID, a recipient_id se izostavlja kada ste slali na BSUID i broj se ne može podijeliti. Neuspjeli status nema niz contacts i izostavlja recipient_user_id kada je poruka poslana na broj telefona, pa neuspjehe povežite s ID-em poruke.
Kako pohranjivati i povezivati korisnike?
Najprije po BSUID-u, a broj telefona kao drugi ključ kada stigne. Cijeli BSUID spremite kao niz znakova, s oznakom države i točkom, jer Meta odbija zahtjeve koji mijenjaju bilo koji dio, a matični BSUID spremite ako su vaši portfelji uključeni. Postojeće zapise povežite preko wa_id dok on još stiže i uz njih čuvajte BSUID, jer se korisnik koji kasnije uvede korisničko ime može vratiti bez broja. Metin FAQ traži iste veze u CRM-ovima i alatima koje ih napajaju.
Što se događa kada korisnik promijeni broj telefona?
Njegov BSUID se ponovno generira, a promjena dolazi u polju messages kao sistemska poruka, jer Meta nema polje user_id_update na koje biste se pretplatili. system.type je user_changed_number kada se novi broj može podijeliti s vama, ili user_changed_user_id kada se može prijaviti samo promjena BSUID-a; system.user_id sadrži novi BSUID, a system.previous_user_id stari, što omogućuje da zapis prijeđe na novi. Obradite oba tipa.
Kako odgovoriti korisniku poznatom samo po BSUID-u?
Šaljite na /<BUSINESS_PHONE_NUMBER_ID>/messages s recipient postavljenim na BSUID i bez to; kada su oba prisutna, prevladava to i odgovor ide na broj telefona. Unos contacts u odgovoru tada nosi input i user_id umjesto wa_id. Svaki tip poruke radi osim predložaka za autentifikaciju jednim dodirom, bez dodira i s kopiranjem koda, koji zahtijevaju broj telefona, a na BSUID mogu dosegnuti samo brojevi unutar istog poslovnog portfelja. Pogreška 131062 znači da tip poruke ne prihvaća primatelje BSUID.
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"recipient": "US.13491208655302741918",
"type": "text",
"text": { "body": "Yes, it also comes in blue." }
}Kako tražiti od korisnika broj telefona?
Gumbom REQUEST_CONTACT_INFO, dodanim predlošku uslužne ili marketinške vrste ili poslanom kao interaktivna poruka tipa request_contact_info. Korisnik koji ga dodirne dijeli broj u razgovoru, a webhook contacts stiže s origin postavljenim na contact_request i brojem u phones[].wa_id; kontakt koji korisnik ručno pošalje stiže s origin vrijednošću other i vCard-om. Meta je gumb učinila dostupnim početkom srpnja 2026., a natpis se ne može prilagoditi.
Što je imenik kontakata?
Pohrana koju Meta vodi za svaki poslovni portfelj bez ikakvog rada na integraciji: čim broj poslovnog telefona pošalje poruku, nazove ili primi poziv s brojem telefona korisnika, taj broj i BSUID se bilježe i kasnije se koriste za popunjavanje webhookova brojem telefona, s korisničkim imenom ili bez njega. Računaju se samo interakcije nakon njegova pokretanja. Može se isključiti u Meta Business Suiteu, Postavke poslovanja, Podaci o poslovanju, što briše sadržaj, a GET ili DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book s bsuid provjerava ili uklanja jedan unos.
Što bi integracija za Coexistence trebala promijeniti?
Način na koji obrađujete tri webhooka koja dobivaju samo Coexistence brojevi, i ona se mijenjaju. U history svaka nit dobiva objekt context s wa_id, user_id i username, a njezine poruke dobivaju from_user_id. U smb_message_echoes dodaje se niz contacts, a message_echoes[].to može se izostaviti dok to_user_id nosi BSUID; izmjene i brisanja napravljena u aplikaciji WhatsApp Business dolaze na isti način. U smb_app_state_sync broj telefona kontakta (phone_number) može se izostaviti, a uz njega stoje user_id i username. Usklađujte eho poruka i uvezene razgovore po user_id uz broj.
Kako testirati prije nego što korisnici prihvate korisnička imena?
Metovim alatom za testiranje na nadzornoj ploči aplikacije: pod Use cases, Connect with customers through WhatsApp, Customize, Configuration, poveznica Test pored webhooka messages šalje primjer na vaš endpoint. Obuhvaća dolazne poruke i statuse u četiri scenarija:
- Korisnik bez korisničkog imena: polja BSUID i broj telefona, bez korisničkog imena.
- Korisnik s korisničkim imenom čiji broj nije dostupan: korisničko ime i BSUID, bez polja broja telefona.
- Korisnik s korisničkim imenom čiji je broj dostupan: korisničko ime, BSUID i broj telefona.
- Portfelj uključen u matične BSUID-ove: matični BSUID uz vlastiti BSUID portfelja.
Kako easyCoexistence obrađuje BSUID-ove?
Prosljeđuje ih onako kako ih Meta šalje. Broj usmjeren na vaš endpoint pomoću set_webhook_destination dobiva webhookove messages i smb_message_echoes izravno od Mete, uključujući user_id, from_user_id, to_user_id i username, a uz uključene automatizacije ili proslijeđivanje easyCoexistence prosljeđuje vrijednost koju je Meta poslala nepromijenjenu. Za odgovor na BSUID vaš kod koristi get_api_credentials, koji vraća ID broja telefona, endpoint za slanje i, ako je dostupan, vlastiti token; alati send_message i send_template uzimaju broj telefona u međunarodnom formatu znamenki.
Uobičajene pogreške
- Pohrana kontakata samo po wa_id. Korisnik s korisničkim imenom koji 30 dana nije imao kontakt s brojem stiže samo s user_id i from_user_id, pa obrađivač koji zahtijeva wa_id propušta poruku.
- Skraćivanje prefiksa države u BSUID-u. Meta traži cijelu vrijednost, s oznakom države i točkom, a zahtjev s bilo kojim promijenjenim dijelom ne uspijeva.
- Čekanje polja user_id_update. Meta ga nema: promjene BSUID-a stižu u messages kao sistemske poruke tipa user_changed_number ili user_changed_user_id.
- Usklađivanje eho poruka samo po to. U smb_message_echoes polje to može se izostaviti, pa odgovor upisan u aplikaciji ostaje neprimijećen osim ako se ne usklađuje i to_user_id.
Svaka veza nadzire se 24/7. US$ 9 do US$ 0,75 po vezi mjesečno, s padom kako dodajete veze, a prvih 3 dana besplatno.
Često postavljana pitanja
Dobivaju li korisnici bez korisničkog imena i BSUID?
Da. Meta postavlja user_id u webhookovima poruka bez obzira na to ima li korisnik korisničko ime, pa većina korisnika dolazi i s brojem telefona i s BSUID-om.
Može li broj koji koristi Coexistence imati korisničko ime poduzeća?
Da. Od 29. lipnja 2026. poduzeće ga može preuzeti ili promijeniti u Meta Business Suiteu, WhatsApp Manageru, aplikaciji WhatsApp Business ili putem Username API-ja; ne skriva poslovni broj, a business_username_updates javlja svaku promjenu statusa.
Vrijedi li BSUID za više poslovnih portfelja?
Ne. BSUID pripada jednom portfelju i jednom korisniku, a broj iz drugog portfelja ne može mu slati poruke. Poduzeća koja Meta uključi kao upravljana dobivaju matične BSUID-ove, s ENT iza oznake države, koji vrijede za sve njihove uključene portfelje.
Koliko košta easyCoexistence za broj WhatsApp?
US$ 9 do US$ 0,75 po vezi mjesečno, ovisno o broju veza, a prvih 3 dana besplatno. Metine naknade za poruke i dalje se naplaćuju na način plaćanja vašeg računa WhatsApp Business.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na