WhatsApp korisnička imena i ID-jevi korisnika u okviru firme (BSUID): šta se menja u Cloud API webhookovima
WhatsApp korisnička imena omogućavaju korisnicima da umesto broja telefona prikažu ime, pa od početka aprila 2026. Cloud API poruke u webhookovima sadrže i ID korisnika u okviru firme (BSUID), na primer US.13491208655302741918, u poljima user_id i from_user_id. Za korisnika sa korisničkim imenom koji u poslednjih 30 dana nije imao poruku ili poziv sa brojem i nije u imeniku kontakata, polja wa_id i from se izostavljaju.
easyCoexistence povezuje broj iz WhatsApp Business aplikacije sa Cloud API-jem preko Coexistence i prosleđuje webhookove messages i smb_message_echoes na vaš endpoint onako kako ih Meta šalje, uključujući BSUID polja, dok get_api_credentials daje vašem kodu sve što je potrebno da odgovori sa recipient.
Kada su BSUID-ovi počeli da se pojavljuju u Cloud API webhookovima, pre nego što korisnička imena stignu do korisnika WhatsAppa.
Kada su API-ji počeli da prihvataju poruke poslate na BSUID, zadate u polju recipient umesto to.
Period zadržavanja po broju poslovnog telefona, u kome svaka poruka ili poziv sa korisnikom čuva njegov broj u webhookovima.
Većina alfanumeričkih znakova posle dvoslovnog koda države i tačke u BSUID-u.
Greška Messages API-ja: Business-scoped User ID (BSUID) recipients are not supported for this message.
Tip sistemske poruke za promenu BSUID-a prijavljen bez broja telefona, sa starim BSUID-om u previous_user_id.
Šta su WhatsApp korisnička imena i BSUID-ovi?
Korisničko ime je opcionalno, jedinstveno ime koje korisnik WhatsAppa može da postavi, a aplikacija ga prikazuje umesto broja telefona. Meta ga uvodi postepeno tokom 2026. godine. BSUID je pozadinski identifikator koji je Meta dodala da firme i dalje mogu da razlikuju korisnike: generiše se automatski, jedinstven je za svaki par Business Portfolio i korisnika, a piše se kao dvoslovni kod države prema ISO 3166, tačka i do 128 alfanumeričkih znakova. Meta traži da partneri i direktno integrisane firme podrže BSUID, jer nijedna firma ne kontroliše da li će njeni korisnici prihvatiti korisnička imena.
Koja polja nose nove identifikatore?
Nova svojstva pored onih koja su držala broj telefona, u webhookovima messages, status, system i user_preferences. Matična polja se pojavljuju samo za Business Portfolio koje je Meta uključila u matične BSUID-ove, a oni važe za sve uključene portfolije:
Kada se broj telefona izostavlja?
Kada korisnik ima korisničko ime i nijedan od Metina tri uslova nije ispunjen. Broj ostaje u webhookovima ako je poslovni broj telefona u poslednjih 30 dana slao poruku ili zvao broj tog korisnika, primio poruku ili poziv od njega u tom periodu, ili je korisnik u imeniku kontakata portfolija. Period od 30 dana računa se po poslovnom broju telefona, pa drugi broj u istom portfoliju može da primi samo BSUID za istog korisnika. Korisnici bez korisničkog imena i dalje stižu sa brojem telefona i BSUID-om.
Kako sada izgleda dolazna poruka?
Slično kao ranije, sa BSUID-om pored broja telefona ili umesto njega. U Metinom primeru korisnika sa korisničkim imenom čiji broj ne može da se podeli, contacts sadrži profile.name, profile.username i user_id, a poruka sadrži from_user_id na mestu gde je ranije bilo 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 menjaju webhookovi statusa?
Statusi „poslato“, „isporučeno“ i „pročitano“ dobijaju niz contacts sa imenom korisnika, user_id, wa_id kada broj može da se podeli, i username kod isporučeno i pročitano. U statusima recipient_user_id nosi BSUID, a recipient_id se izostavlja kada ste slali na BSUID i broj ne može da se podeli. Neuspeli status nema niz contacts i izostavlja recipient_user_id kada je poruka poslata na broj telefona, pa neuspehe povežite sa ID-jem poruke.
Kako čuvati i uparivati korisnike?
Prvo po BSUID-u, a broj telefona kao drugi ključ kad god stigne. Čuvajte ceo BSUID kao string, sa kodom države i tačkom, jer Meta odbija zahteve koji menjaju bilo koji njegov deo, i sačuvajte i matični BSUID ako su vaši portfoliji uključeni. Postojeće zapise uparujte preko wa_id dok on još stiže, i uz njih čuvajte BSUID, jer korisnik koji kasnije usvoji korisničko ime može da se vrati bez broja. Metin FAQ traži ista uparivanja u CRM-ovima i alatima koje oni napajaju.
Šta se dešava kada korisnik promeni broj telefona?
Njegov BSUID se regeneriše, a promena stiže na polju messages kao sistemska poruka, jer Meta nema polje user_id_update za pretplatu. system.type je user_changed_number kada novi broj može da se podeli sa vama, ili user_changed_user_id kada se može prijaviti samo promena BSUID-a. system.user_id sadrži novi BSUID, a system.previous_user_id stari, i tako zapis prelazi na novi identitet. Obradite oba tipa.
Kako odgovoriti korisniku poznatom samo po BSUID-u?
Šaljite na /<BUSINESS_PHONE_NUMBER_ID>/messages sa recipient postavljenim na BSUID i bez to; ako su oba prisutna, to ima prednost i odgovor ide na broj telefona. Unos u contacts odgovora tada sadrži input i user_id umesto wa_id. Svaki tip poruke radi, osim šablona za autentifikaciju (one-tap, zero-tap i copy code), koji zahtevaju broj telefona, a na BSUID mogu da stignu samo brojevi u istom portfoliju. Greška 131062 znači da tip poruke ne prihvata primaoce po BSUID-u.
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"recipient": "US.13491208655302741918",
"type": "text",
"text": { "body": "Yes, it also comes in blue." }
}Kako tražiti broj telefona od korisnika?
Pomoću dugmeta REQUEST_CONTACT_INFO koje se dodaje šablonu tipa utility ili marketing, ili se šalje kao interaktivna poruka tipa request_contact_info. Korisnik koji ga dodirne deli broj u niti, a stiže webhook contacts sa origin postavljenim na contact_request i brojem u phones[].wa_id. Kontakt koji korisnik ručno podeli stiže sa origin other i vCard-om. Meta je dugme učinila dostupnim početkom jula 2026, a natpis se ne može prilagoditi.
Šta je imenik kontakata?
Skladište koje Meta čuva za svaki portfolio, bez posla na integraciji: čim poslovni broj telefona pošalje poruku, pozove ili primi poziv od broja korisnika, taj broj i BSUID se beleže i koriste da kasniji webhookovi sadrže broj telefona, bez obzira na korisničko ime. Računaju se samo interakcije posle pokretanja. Može se isključiti u Meta Business Suite, u podešavanjima firme pod Informacije o firmi, što briše sadržaj, a GET ili DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book sa bsuid proverava ili uklanja jedan unos.
Šta treba da promeni Coexistence integracija?
Način obrade tri webhooka koje dobija samo Coexistence broj, a i oni se menjaju. U history, svaka nit dobija objekat context sa wa_id, user_id i username, a njene poruke dobijaju from_user_id. U smb_message_echoes dodaje se niz contacts, a message_echoes[].to može da se izostavi dok to_user_id nosi BSUID. Izmene i brisanja napravljena u aplikaciji WhatsApp Business stižu na isti način. U smb_app_state_sync polje phone_number kontakta može da se izostavi, a pored njega stoje user_id i username. Uparujte eho poruke i uvezene razgovore i po user_id, a ne samo po broju.
Kako testirati pre nego što korisnici usvoje korisnička imena?
Metinim alatom za test u App Dashboard: pod Use cases, Connect with customers through WhatsApp, Customize, Configuration, link Test pored messages webhooka šalje uzorak na vaš endpoint. Pokriva dolazne poruke i statuse u četiri scenarija:
- Korisnik bez korisničkog imena: polja BSUID i broj telefona, bez username.
- Korisnik sa korisničkim imenom čiji broj nije dostupan: username i BSUID, bez polja broja telefona.
- Korisnik sa korisničkim imenom čiji je broj dostupan: username, BSUID i broj telefona.
- Portfolio uključen u matične BSUID-ove: matični BSUID pored sopstvenog BSUID-a portfolija.
Kako easyCoexistence obrađuje BSUID-ove?
Prosleđuje ih onako kako ih Meta šalje. Broj usmeren na vaš endpoint preko set_webhook_destination dobija webhookove messages i smb_message_echoes direktno od Mete, uključujući user_id, from_user_id, to_user_id i username, a kad su automatizacije ili prosleđivanje uključeni, easyCoexistence prosleđuje vrednost koju je Meta poslala nepromenjenu. Da biste odgovorili na BSUID, vaš kod koristi get_api_credentials, koji vraća ID broja telefona, njegov endpoint za slanje i, kada je dostupan, vaš sopstveni token. Alati send_message i send_template uzimaju broj telefona u međunarodnom formatu cifara.
Česte greške
- Identifikovanje kontakata samo po wa_id-u. Korisnik sa korisničkim imenom koji u poslednjih 30 dana nije bio u kontaktu sa brojem stiže samo sa user_id i from_user_id, pa handler koji zahteva wa_id propušta poruku.
- Skraćivanje prefiksa države u BSUID-u. Meta traži celu vrednost, sa kodom države i tačkom, a zahtev sa bilo kojim promenjenim delom ne uspeva.
- Čekanje polja user_id_update. Meta ga nema: promene BSUID-a stižu na messages kao sistemske poruke tipa user_changed_number ili user_changed_user_id.
- Uparivanje Coexistence eho poruka samo po to. U smb_message_echoes polje to može da se izostavi, pa odgovor ukucan u aplikaciji ostaje neviđen ako se ne uporedi i to_user_id.
Svaka veza se prati 24/7. Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, a prvih 3 dana su besplatna.
Često postavljana pitanja
Da li korisnici bez korisničkog imena takođe dobijaju BSUID?
Da. Meta postavlja user_id u webhookovima poruka bez obzira na to da li korisnik ima korisničko ime, pa većina korisnika stiže i sa brojem telefona i sa BSUID-om.
Može li Coexistence broj da ima poslovno korisničko ime?
Može. Od 29. juna 2026. firma može da ga usvoji ili promeni u Meta Business Suite, WhatsApp Manager, aplikaciji WhatsApp Business ili preko Username API-ja. Ono ne skriva poslovni broj, a business_username_updates prijavljuje svaku promenu statusa.
Da li BSUID radi preko različitih portfolija?
Ne. BSUID pripada jednom portfoliju i korisniku, a broj iz drugog portfolija ne može da mu pošalje poruku. Upravljane firme koje Meta uključi dobijaju matične BSUID-ove, sa ENT posle koda države, koji važe za sve njihove uključene portfolije.
Koliko košta easyCoexistence za WhatsApp broj?
Od US$ 9 do US$ 0,75 po vezi mesečno, u zavisnosti od broja veza, a prvih 3 dana su besplatna. Metine sopstvene naknade za poruke ostaju na načinu plaćanja vašeg WhatsApp Business naloga.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na