WhatsApp is adding usernames. A customer will be able to message your business with a handle like @priya.k, without sharing a phone number. For businesses on the WhatsApp Business API, that changes something basic: a chat may arrive without the customer's phone number, identified instead by a business-scoped user ID (BSUID).
This guide explains what's changing, what stays the same, and what to do about it now. It's based on Meta's BSUID documentation, checked on 20 November 2026.
The short answer
- Usernames are optional. People and businesses could reserve one from 29 June 2026. Meta is rolling out messaging by username gradually, country by country, and hasn't published dates.
- A BSUID is a customer ID that only your business sees. It looks like
US.1349…. Meta has sent BSUIDs in webhooks since early April 2026, alongside the phone number. - The phone number is still sent in most chats. For a customer with a username, Meta includes the number if you and the customer messaged or called in the last 30 days, or if they're in your contact book. Otherwise you may get the BSUID only.
- You can reply to a BSUID. Since July 2026 the API accepts a BSUID as the recipient for every message type except one-tap, zero-tap and copy-code OTP templates, which still need the phone number.
- Phone numbers still matter. Meta still recommends messaging customers by phone number, and you'll need numbers for OTPs, CRMs and most opt-in records.
What a WhatsApp username is
A username is a public handle of 3–35 characters (English letters, numbers, . and _; case doesn't matter). Customers can share it instead of their number. Businesses can have one too: one per business phone number, unique across WhatsApp.
A business username does not hide your business number. It's an easier way for customers to find you, not a privacy setting for the business.
To claim one, go to WhatsApp Manager → Phone numbers → Profile → Username, or use Meta Business Suite. Names are mostly first come, first served. Meta holds back some well-known names for the businesses that own them, and matching your Instagram or Facebook name needs that account linked. You can change a business username twice in 14 days (ten times for a reserved username).
What a BSUID is
A business-scoped user ID identifies one WhatsApp user for one business. The same person has a different BSUID for every business, so a BSUID can't be used to track people across companies.
Three details matter:
- It's scoped to your business portfolio, not to one WhatsApp Business Account. All your numbers in the same portfolio see the same BSUID for a customer. A number in a different portfolio can't use it.
- It stays the same when the customer changes their username. It changes when they change their phone number, and Meta sends a system message with the old and new IDs.
- Large groups of businesses can ask Meta for a "parent" BSUID shared across several portfolios.
When you still get the phone number
For a customer with a username, Meta includes their phone number in the webhook if any of these is true, for that business phone number:
| Condition | Phone number included? |
|---|---|
| You messaged or called them in the last 30 days | Yes |
| They messaged or called you in the last 30 days | Yes |
| They're in your business's contact book | Yes |
| None of the above, and they contact you by username only | Maybe not: you may get the BSUID only |
The contact book is kept by Meta for your business portfolio. It records customers you've interacted with since it launched, so your existing, active customers keep arriving with their numbers.
Need the number? Meta added a request contact info button (early July 2026). You can put it on a utility or marketing template or an interactive message. If the customer taps it and shares, you receive their number.
What changes for your team
Customer records. If your CRM, spreadsheet or helpdesk uses the phone number as the only key, a username-only chat has nowhere to go. Store the BSUID next to the phone number, and match on either.
Order lookups and OTPs. Many businesses find a customer's order by phone number. With a username-only chat, ask for the order number or email instead, or ask the customer to share their number. One-tap, zero-tap and copy-code OTP templates can't be sent to a BSUID at all.
Opt-in records. Your marketing opt-in is usually tied to a phone number. If a customer reaches you by username only, record their consent against the BSUID and keep both together if they later share the number.
Ad leads. Click-to-WhatsApp ads still open a chat with your business. If the customer uses a username, the first message may carry only a BSUID. Ask for what you need (city, budget, a callback number) in the first automated reply.
What developers need to change
If you're integrated with the Cloud API directly, Meta says BSUID support is required to keep processing messages from people who use usernames. From the docs:
- Messages webhooks add
user_id(the BSUID),usernameandparent_user_id. When the number is hidden,wa_idandfrommay be missing, so don't treat them as required. - Status webhooks add
recipient_user_id;recipient_idmay be missing. - System messages
user_changed_numberanduser_changed_user_idtell you when a BSUID changes. - Sending: use the
recipientfield with a BSUID. If you send bothtoandrecipient, the phone number wins. Error131062means that message type can't go to a BSUID.
What to do now
- Keep collecting phone numbers with consent, at checkout, in sign-up forms and in ad lead forms. A number with opt-in is still the most useful thing you can have.
- Message active customers regularly (useful updates, not spam). Anyone you've talked to in the last 30 days arrives with their number.
- Check your tools. Ask your WhatsApp provider and CRM how they handle a chat with no phone number.
- Write a first reply that works without a number, asking for an order number, email or the details you need.
- Claim your business username before someone else takes a similar one.
Where Mywa fits
In Mywa, contacts are matched by phone number today. Because Meta keeps sending the number for customers you've talked to in the last 30 days and those in your contact book, your existing customers' chats, campaigns and automations keep working as they do now. Collecting opted-in numbers through Mywa's contacts, ad lead automations and Google Sheets sync is still the best way to stay ready.
See how Mywa handles contacts and the shared inbox, or connect your number.
The bottom line
Usernames give customers a way to reach you without sharing their number, and BSUIDs are how your business recognises them. Most chats will still include the phone number for a while, because Meta sends it for recent conversations and contacts. Store the BSUID next to the number, don't make the number a required field anywhere, and keep collecting numbers with consent.
Sources: Meta: business-scoped user IDs · Meta: it's time to reserve your WhatsApp username (29 June 2026) · WhatsApp Help: usernames · WhatsApp Help: business usernames. Checked 20 November 2026.