Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

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.

April 2026

Kada su BSUID-ovi počeli dolaziti u Cloud API webhookove, prije nego što korisnička imena dospiju do korisnika.

July 2026

Kada API-ji počinju prihvaćati poruke poslane na BSUID, postavljene u recipient umjesto u to.

30 days

Razdoblje zadržavanja po broju poslovnog telefona u kojem svaka poruka ili poziv s korisnikom čuva njegov broj u webhookovima.

128

Većina alfanumeričkih znakova nakon dvoslovne oznake države i točke u BSUID-u.

131062

Pogreška Messages API-ja: Business-scoped User ID (BSUID) recipients are not supported for this message.

user_changed_user_id

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:

contacts[].user_idThe user's BSUID, in incoming messages and in sent, delivered and read statuses
messages[].from_user_idThe sender's BSUID, beside from
contacts[].profile.usernameThe username, when the user has one; never on sent statuses
statuses[].recipient_user_idThe recipient's BSUID, unless a send to a phone number failed
parent_user_idA parent BSUID shared by enrolled portfolios, such as US.ENT.11815799212886844830
wa_id, from, recipient_idNow left out when the phone number cannot be shared

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:

messages webhook: a text from a user known only by BSUID
{
  "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.

POST /<BUSINESS_PHONE_NUMBER_ID>/messages, sent to a 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.
Radite ovo uz EasyCoexistence

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 razdoblje

Provjereno na