Meta is introducing WhatsApp Business Usernames as an optional feature that lets WhatsApp users display a username instead of their phone number when messaging businesses. To support this, Meta has introduced BSUID (Business-Scoped User ID) — a unique identifier tied to each business-user relationship.
When a user adopts a username, their username will be displayed in WhatsApp instead of their phone number. This means businesses can no longer assume that a user's phone number will always be available from the start. Instead, you'll identify them by their BSUID, which Meta provides automatically.
WOZTELL has adapted the platform to support this change. You can now work with contacts using BSUID, request their phone number when you need it, and manage their information as their identity evolves over time.
When a contact messages you, WOZTELL receives one or more identifiers from Meta. Here's the priority order:
If a contact starts with only a BSUID and later shares their phone number, WOZTELL links both identifiers and maintains conversation continuity. The phone number then becomes the priority identifier going forward.
You can import contacts using these External ID types:
Note: Username cannot be used as an External ID for importing contacts.
Settings now include access to request and manage your channel's WhatsApp Business Username. WOZTELL directs you to Meta's environment where final username management happens.
You'll see the status of your username:
Once WOZTELL can work with contacts using BSUID, the next step is requesting the phone number when your business needs it.
Phone Number Request is only available for contacts who don't have a phone number in WOZTELL. If the contact already has a phone number, the request option won't appear.
There are two ways to request it:
Send a special WhatsApp Request Contact Info interactive message directly to the contact.
REQUEST_CONTACT_INFO component and doesn't require a template. Use this when you want to request a phone number quickly without setting up templates first.Use WhatsApp templates that include the Request Contact Info component. This gives you more control over the message content and branding.
From Settings, create a new template:
Once approved, templates become available to use.
Note: Templates with these special components may take slightly longer to get approved by Meta.
The Whitelist in Settings acts like a favorites list for templates. Only whitelisted templates appear when agents send a Phone Number Request.
Here's the workflow:
This means having a template with the Request Contact Info component doesn't automatically make it available to agents — you control which templates appear through the Whitelist.
When configuring the Whitelist, WOZTELL filters and displays only templates that contain the Request Contact Info component, making it easy to find and add them.
When a contact without a phone number messages you, you can start a Phone Number Request directly in the conversation. Select from the whitelisted templates and send.
The option only appears if the contact doesn't have a phone number in WOZTELL.
WOZTELL provides ready-to-use default templates in these languages:
For Request Contact Info: Default templates are created for all new and existing channels, submitted to Meta for approval, and automatically added to the Whitelist once approved.
When you send a Request Contact Info, the contact has control over what they share. WhatsApp may offer them the option to share:
You can't force a contact to share their phone number. They decide what information to provide.
When a contact shares their phone number through Request Contact Info:
A contact's identity can evolve like this:
BSUID only → BSUID + Phone Number → Phone Number as the primary identifier
Username continues to complement the contact's information when available.
Asking a contact to type their phone number in the chat is not the same as a Phone Number Request.
A phone number received as a regular text message cannot be properly associated with their contact identity through this feature.
To obtain and correctly link the phone number, you must use:
This ensures the phone number is properly recorded and linked to their identity in WOZTELL.
Contact import is a separate process for adding pre-existing contacts using supported External IDs.