BSUID, Business Username & Phone Number Request: Full Reference Guide

BSUID, Business Username & Phone Number Request: Full Reference Guide

Introduction

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.

How Contact Identity Works in WOZTELL

When a contact messages you, WOZTELL receives one or more identifiers from Meta. Here's the priority order:

  • Phone Number — the primary identifier when available
  • BSUID — identifies the contact when phone number is not yet available
  • Username — additional information displayed when the contact has one set up

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.

What Changed in Each Part of WOZTELL

Inbox

  • Contacts without a phone number appear with their BSUID displayed as their External ID
  • Username shows as additional information when available
  • You can search conversations by BSUID
  • Note: Inbox search does not include Username — it's a display attribute only
  • All contact information (BSUID, Username, phone number) is visible when you open the contact details
     

Contacts Page

  • A new Username column displays the contact's WhatsApp Business Username (empty if they don't have one)
  • BSUID appears as External ID when there's no phone number or other applicable identifier
  • You can search and filter by both BSUID and Username
  • All information is available in the contact's full details

Contact Import

You can import contacts using these External ID types:

  • BSUID
  • WhatsApp Phone Number
  • Instagram ID
  • Facebook PSID

Note: Username cannot be used as an External ID for importing contacts.

Broadcast & Audiences

  • A Username column has been added to show each contact's WhatsApp Business Username
  • BSUID displays as External ID when there's no phone number
  • You can search and filter by BSUID and Username
  • In Static Audiences, you can select contacts by BSUID or Username
  • Dynamic Audiences don't use BSUID or Username as segmentation criteria — they're individual identifiers, not attributes for audience rules

Channel Settings: Business Username

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:

  • Not claimed yet

  • Approved and visible

  • Reserved but not visible yet

Phone Number Request: Why and When

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:

Option 1: Interactive Message (No Template Needed)

Send a special WhatsApp Request Contact Info interactive message directly to the contact.

This message uses WhatsApp's specific 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.


Option 2: Template Message (Using Templates & Whitelist)

Use WhatsApp templates that include the Request Contact Info component. This gives you more control over the message content and branding.

Creating Templates with Request Contact Info

From Settings, create a new template:

  • Choose Utility or Marketing category
  • Include the special Request Contact Info component
  • Create templates in multiple languages if needed
  • Submit for Meta's approval

Once approved, templates become available to use.

Note: Templates with these special components may take slightly longer to get approved by Meta.

Template Whitelist: Control What Your Team Uses

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:

  1. Create the template with the Request Contact Info component
  2. Meta approves it
  3. Add it to the Whitelist in Settings
  4. The template is now available for agents to use when requesting phone numbers

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.

How to Send a Phone Number Request

From Inbox:

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.


From Contacts:

You can also initiate a Phone Number Request from the contact's record on the Contacts page. WOZTELL will redirect you to Inbox for that contact where you can select and send a whitelisted template.


Default Templates

WOZTELL provides ready-to-use default templates in these languages:

  • English
  • Mandarin Chinese
  • Traditional Chinese
  • French
  • Spanish
  • Portuguese
  • Arabic

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.


Note: The Traditional Chinese version is currently experiencing issues on Meta's side and may not work as expected.

What Does the Contact Decide in WhatsApp?

When you send a Request Contact Info, the contact has control over what they share. WhatsApp may offer them the option to share:

  • Phone Number
  • Username (if they have one configured)

You can't force a contact to share their phone number. They decide what information to provide.

What Happens When the Phone Number Arrives

When a contact shares their phone number through Request Contact Info:

  • WOZTELL receives the information in a structured format
  • The phone number is added to their contact identity
  • The phone number becomes the priority identifier — it's now used instead of BSUID
  • If the contact previously existed in WOZTELL identified only by BSUID, both identifiers are linked
  • Automatic merge happens when applicable, maintaining contact and conversation continuity

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.

Important: How to Properly Request a Phone Number

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:

  • Interactive Message (Request Contact Info component), or
  • Template Message (template with Request Contact Info component)

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.