WhatsApp Business Usernames: How to Reserve Your @Handle and What Changes for Your Chatbot

WhatsApp Business usernames have been available to reserve since June 29, 2026 (WhatsApp Blog), but a reserved @handle isn't live yet. It goes visible when WhatsApp launches usernames in your region and notifies you, and from then on customers can start a chat using the handle. You still can't start an outbound conversation by username: your chatbot and CRM use the customer's phone number or business-scoped user ID (BSUID).

What is a WhatsApp Business username?
A WhatsApp Business username is an optional unique handle, such as @YourBusinessName, that customers can use to start a chat with a business without already having its phone number. It's different from a display name, which doesn't have to be unique, and your business phone number stays visible on the profile. Reservations opened on June 29, 2026; the handle becomes visible when WhatsApp launches usernames in your region.

Mavibot is an automation platform that runs chatbots, CRM, and mailings for businesses in WhatsApp, Instagram, and Telegram. Below are the reservation steps, followed by what to check in your chatbot, CRM, and broadcasts while usernames roll out.

What is a WhatsApp Business username?

A WhatsApp Business username is a unique @handle tied to one business phone number. Customers who know it can start a chat without saving your number. A username doesn't replace your display name (which doesn't need to be unique), and it doesn't hide your phone number: both the username and the number appear on your business profile.

Three details from WhatsApp's business help article:

  • One username per number. If you run several WhatsApp numbers, you can reuse one display name, but each number needs its own username.
  • Matching handles. "In most cases, you may be able to claim the same username you use on Facebook or Instagram"; link the number to that Page or account first (full control, or partial access with manage_phone).
  • No directory. People need your exact handle. Meta says that once usernames are active, users find a business username by "exact match search" (Business-scoped user IDs).

Meta's developer docs say "Business usernames are not intended for privacy": adopting one "will not cause your business phone number to be hidden in the app." A personal username works differently: a customer who turns one on may hide their number when they first write to you.

The username key is a privacy setting: with a key, someone must know both the exact username and the key to make first contact (WhatsApp usernames FAQ). For a business that wants to be found as @brand, a key mostly adds friction (that's our recommendation, not a rule).

When is the WhatsApp username release date?

WhatsApp opened username reservations on June 29, 2026, but hasn't published a single global launch date. Usernames are rolling out gradually, and a reserved business username becomes active when the feature launches in your region. As of November 17, 2026, WhatsApp says it will notify you in the app when your username is ready.

Stage What it means Official source
Reserved The handle is held for your number; other accounts cannot claim it. Customers may not see it yet WhatsApp business help; Meta docs: "reserved for the business phone number but is not visible to WhatsApp users"
Active / visible The handle appears on your profile and customers can find you by exact search, once usernames reach their country Meta docs
Rollout timing "Rolling out gradually over the next few months"; no global date or official country list published WhatsApp business help; WhatsApp Blog, June 29, 2026

Reservations have been open for months, so if your handle isn't reserved yet, do it now: most usernames are first-come, first-served (business help). Ignore country lists and "first wave" dates on vendor blogs unless WhatsApp or Meta publishes them.

How do you reserve a WhatsApp Business username?

You reserve a WhatsApp Business username in WhatsApp Manager or Meta Business Suite; a change made in one appears in the other. Open your phone number's profile, find Username, click Create, enter or pick a handle, and save. The name is then held for your number until usernames launch in your region and WhatsApp notifies you.

The steps follow WhatsApp's help article. If the number also runs in the WhatsApp Business app, Meta returns error 147006, so manage the username in the app instead. Partners can also use the Username API (POST /<PHONE_NUMBER_ID>/username).

Username field with the Create button in the WhatsApp Manager phone number profile

How to reserve a username in WhatsApp Manager

  1. Open WhatsApp Manager.
  2. Click Phone number in the left menu, then click your phone number.
  3. Click Profile, then scroll to Username.
  4. Click Create, then enter the username you want, or choose one from Suggested.
  5. Click Save.
  6. Click Close.

Suggested names are handles WhatsApp already reserved for your business.

Create username dialog in WhatsApp Manager with a handle entered and suggested usernames

How to reserve a username in Meta Business Suite

  1. Go to Meta Business Suite and click WhatsApp Accounts in the left menu.
  2. Click the phone number you want a username for.
  3. Click Phone numbers and open that number's settings.
  4. Scroll to Username, click Create, and enter the handle, or choose one from Suggested.
  5. Click Save, then Close.

What are the username rules, change limits, and common errors?

Business usernames follow Meta's format rules (Meta docs):

  • English letters (a–z), digits, periods, and underscores only; ñ, é, or ü make the request fail
  • 3–35 characters, with at least one letter
  • no period at the start or end, and no two periods in a row
  • no www. at the start and no domain ending such as .com, .org, or .net
  • case is ignored (myID = myid), but myid, my.id, and my_id are different names

You can change the username at any time, and your previous handle is held for 60 days, during which only you can reclaim it (business help). Meta allows up to 2 changes per number in any rolling 14-day period, or 10 if the username comes back as reserved; going over returns error 130429, subcode 2655131.

Error What Meta says it means
147001 Username not available: claimed already or failed internal checks
147002 Account not eligible: the portfolio "must have a higher messaging limit"
147003 / 147004 Link the number to the Facebook Page / Instagram account that uses the name
133010 The number is not registered for API use yet
147007 The number already has another username with reserved status; use or delete it first

If you get 147002, check your messaging limit and business verification; the tiers are explained in how to send bulk WhatsApp messages without a ban. WhatsApp also blocks words like "bank" and "police" (usernames FAQ), so stick to your own brand name.

Does a WhatsApp username replace your phone number?

No. A WhatsApp Business username doesn't replace your business phone number, and it doesn't let you message customers by @handle. Your number stays on your profile. What changes is the customer side: a person with their own username may write to you without sharing their number, and your systems then see a BSUID instead.

What changes for your customers?

Once usernames are live in their region, customers can start a chat with your @handle, and they still see your number on your profile. If a customer has their own username, their phone number won't be shared with a business they contact for the first time, according to WhatsApp's usernames FAQ.

What is the BSUID your chatbot will see?

A business-scoped user ID (BSUID) is an identifier Meta assigns to a WhatsApp user for one business portfolio. It arrives as user_id in message webhooks, for example "user_id": "US.13491208655302741918": a two-letter country code, a period, and up to 128 alphanumeric characters. BSUIDs have appeared in webhooks since early April 2026, and sending to a BSUID has been supported since July 2026 (Meta docs, page updated November 5, 2026).

Meta makes BSUID support mandatory for partners, directly integrated businesses, and Click-to-WhatsApp advertisers: "Because you cannot control whether your users adopt usernames, you must support BSUID to avoid losing the ability to process their messages." A BSUID is regenerated when a user changes their phone number, but not when they change their username. If you run several portfolios, look at Meta's parent BSUID option as well.

What changes for your chatbot and CRM?

Your chatbot and CRM must handle customers who arrive without a phone number. If your funnel, records, and broadcasts depend only on the phone field, some new conversations will break. You also can't start a conversation by @username: the API sends to a phone number or a BSUID.

You have Can the customer message you? Can you message them?
Their phone number and opt-in Yes, by number Yes, send to the number (to), subject to opt-in and templates
Only their BSUID, after they wrote to you They already started the chat Yes, send to the BSUID (recipient), still within WhatsApp window and template rules
Only a @username you found or were told Not via a directory; they would have to write first No. You cannot start an outbound chat by username

Can you start an outbound conversation by username?

No. There's no parameter for sending to @someone. You send to a phone number in to or a BSUID in recipient; if a request has both, the phone number takes precedence (Meta docs). Cold outbound still needs a number, opt-in, and an approved template outside the 24-hour window.

How should CRM records and deduplication work?

A CRM keyed only on phone numbers will create duplicates once customers arrive with just a BSUID. These rules apply to any system, whether it's a built-in tool such as Mavibot CRM or a separate one:

  • Store the BSUID from the first webhook, even when a phone number is present.
  • Allow a record with no phone number: a first-time customer may bring only a name, username, and BSUID.
  • When the person later shares a number, merge into one record, not a second lead.
  • On a phone number change, Meta sends a system webhook and a new BSUID; update the record.
  • Expect a different BSUID for the same person in each business portfolio.

How do broadcasts, templates, and the 30-day phone number rule work?

Meta still includes the customer's number in webhooks if that business phone number messaged, called, or heard from them in the last 30 days, or if the person is in your Meta contact book. The 30 days count per business number (Meta docs). The contact book is hosted by Meta; switching it off in Business settings > Business info deletes its data for good.

You can't broadcast to "everyone with only a @username". With a BSUID from a past conversation you can send to recipient, but:

  • outside the 24-hour window you still need opt-in and a marketing template;
  • Meta recommends sending marketing to phone numbers, "primarily so you can continue to receive phone numbers in webhooks";
  • one-tap, zero-tap, and copy-code authentication templates require a phone number, and a BSUID returns error 131062.

For categories and costs, see the WhatsApp message categories guide.

Does opt-in still apply when someone messages your @username?

Yes. A message to your @handle opens the 24-hour customer service window, so you can reply freely, ask for a number, or confirm consent for offers. But that's not permission to send marketing once the window closes. Consent still has to name your business and be explicit, according to Meta's Get opt-in for WhatsApp. The no-code WhatsApp bot guide covers the window and templates in more depth.

How do you ask for a number with REQUEST_CONTACT_INFO?

REQUEST_CONTACT_INFO is a Meta button type, available since early July 2026, that you add to a utility or marketing template or send as an interactive message (Meta docs). If the customer taps it, their number appears in the chat and in a contacts webhook, and Meta adds it to your contact book if that's turned on. Don't dress up a promotion as a utility request. Example:

To complete your booking and send you updates, please share the WhatsApp number you want us to use. Tap the button below.

WhatsApp chat where a business asks a new customer to share their phone number with a REQUEST_CONTACT_INFO button

What should you check in your WhatsApp funnel before usernames go live?

Check three things before usernames reach your customers: that your @handle is reserved, that every system can hold a contact without a phone number, and that no flow depends on a typed @username. Run the checklist with whoever maintains your integration.

  • The @handle is reserved in WhatsApp Manager or Meta Business Suite, one per WhatsApp number.
  • If you saw "account not eligible" (147002), your messaging limit and business verification are checked.
  • Your platform or integrator has confirmed in writing how it handles BSUIDs: storing user_id, sending via recipient, and matching records.
  • A test conversation with an empty phone field is saved as a contact, not dropped or rejected.
  • The welcome flow has a "no phone number" branch that asks politely (for example with REQUEST_CONTACT_INFO, where your setup supports it) instead of stalling.
  • Scenarios, CRM fields, and webhooks that read the phone number still work when it's empty.
  • A contact who later shares a number ends up as one record, not two.
  • Broadcast segments that assume a phone field exclude or separately handle contacts without one.
  • No flow tries to start a conversation from a typed @username.
  • Someone re-reads Meta's BSUID page before production changes; it was last updated on November 5, 2026.

Diagram: a customer messages a business @username, the webhook brings a BSUID without a phone number, and the CRM keeps one contact record

Using WhatsApp with Mavibot? Reserve your business username now, then run the checklist above on your funnel. Mavibot is an automation platform for WhatsApp, Instagram, and Telegram. Create a free account on mavibot.ai. The standard trial is 3 days; promo code MAVI10 extends it to 10 days. To connect a number, see how to set up the WhatsApp Business API with Mavibot.

WhatsApp Business username: frequently asked questions

Each answer below uses the same dates, rules, and sources as the article and stands on its own.

When is the WhatsApp username release date?

There's no single global date. WhatsApp opened reservations on June 29, 2026, and is rolling usernames out gradually by region, so a reserved handle goes live when your region gets the feature and WhatsApp notifies you in the app. Source: WhatsApp Blog.

How do I reserve a WhatsApp Business username?

Use WhatsApp Manager or Meta Business Suite: open the phone number's profile, click Create next to Username, then save a handle. Use English letters, digits, periods, or underscores (3–35 characters). If you change it later, the old handle stays yours for 60 days. Source: How to reserve and manage usernames.

Does a WhatsApp Business username replace my phone number?

No. A business username is an extra way to be found, not a substitute for your number, and it doesn't hide that number: it stays on your business profile next to the handle. Your display name stays as it is too. Source: WhatsApp Business help article.

Can I start a WhatsApp conversation with a customer using their username?

No. The WhatsApp Business Platform sends messages only to a phone number or a business-scoped user ID (BSUID), and there is no directory of usernames. A handle someone gave you isn't an address you can message; the customer has to write to you first, or you need their number and opt-in.

What is a BSUID, and why does my chatbot need it?

A BSUID is the ID Meta gives a WhatsApp user for your business portfolio, sent as user_id in webhooks. Customers with a username may arrive without a phone number, and Meta requires partners and directly integrated businesses to support BSUIDs so those messages aren't lost. Source: Business-scoped user IDs.

Will I still get my customer's phone number?

Usually, if you already know them. Meta keeps the number in webhooks when that business line exchanged a message or call with the person in the last 30 days, or when they're in your Meta contact book. A brand-new customer with a username may arrive without one, so plan a polite way to ask.

Does opt-in change if someone messages my @username?

No. A message to your handle opens the 24-hour service window for replies, but marketing after that window still needs opt-in that names your business and an approved template. Writing to you once isn't consent to promotions. Source: Get opt-in for WhatsApp.