How to work with BSUID contacts and request phone numbers in WOZTELL

BSUID contacts and phone number requests in WOZTELL
Table of Contents

You may have noticed that some of your contacts now reach you without a phone number. This is because Meta is introducing WhatsApp usernames as an optional feature, country by country.

When a user adopts a username, their username displays 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 BSUID (Business-Scoped User ID), a unique identifier that Meta provides automatically for each business-user relationship.

How WOZTELL handles this

WOZTELL has adapted the platform to support this change. When a contact messages you, WOZTELL receives one or more identifiers from Meta in this priority order:

  1. Phone Number: the primary identifier when available
  2. BSUID: identifies the contact when their phone number is not yet available
  3. 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 your workspace

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.

BSUID contacts and phone number requests in WOZTELL
BSUID contacts and phone number requests in WOZTELL

Contacts page

A new Username column displays each contact’s WhatsApp username (empty if they don’t have one). BSUID appears as External ID when there’s no phone number. You can search and filter by both BSUID and Username.

BSUID contacts and phone number requests in WOZTELL

How to request a phone number

In many cases, it’s still better to have the lead’s or customer’s phone number on file. That’s why, in WOZTELL, Phone Number Request is automatically available for contacts who don’t have a phone number yet.

BSUID contacts and phone number requests in WOZTELL

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.

BSUID contacts and phone number requests in WOZTELL
BSUID contacts and phone number requests in WOZTELL

You can set this up as an auto-reply in your chatbot flow, so it’s sent whenever a contact messages you and no phone number is detected.

Option 2: Template message (using templates and 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:

  1. Choose Utility or Marketing category
  2. Include the special Request Contact Info component
  3. Create templates in multiple languages if needed
  4. Submit for Meta’s approval

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

BSUID contacts and phone number requests in WOZTELL

Using the template Whitelist

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

You control which templates appear through the Whitelist. Having a template with the Request Contact Info component doesn’t automatically make it available to agents.

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.

BSUID contacts and phone number requests in WOZTELL

Sending 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.

BSUID contacts and phone number requests in WOZTELL
BSUID contacts and phone number requests in WOZTELL
BSUID contacts and phone number requests in WOZTELL

Sending a Phone Number Request 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.

BSUID contacts and phone number requests in WOZTELL
BSUID contacts and phone number requests in WOZTELL

What does the contact decide?

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

  • Phone Number
  • Username (if they have one configured)
BSUID contacts and phone number requests in WOZTELL

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

Whichever option you use, the phone number has to arrive through Request Contact Info for WOZTELL to link it to the contact.

Best practices for requesting a phone number

Asking a contact to type their phone number in the chat is not the same as a Phone Number Request.

This doesn’t work: Asking a contact to “type your phone number in the chat”

A phone number received as a regular text message cannot be properly associated with their contact identity through this feature.

Use one of these instead:

  • Interactive Message: Send a Request Contact Info interactive message directly
  • Template Message: Use a template with the Request Contact Info component

This ensures the phone number is properly recorded and linked to their contact identity in WOZTELL.

Why using the proper method matters

When you use the proper Request Contact Info method, Meta handles the phone number as structured data tied to the contact’s BSUID. This means:

  • The phone number is correctly associated with the contact’s identity
  • WOZTELL can automatically merge the phone number with their existing BSUID
  • Conversation history is maintained
  • All future conversations use the phone number as the priority identifier

When a contact simply types a number in the chat, none of this automatic linking happens.

Contact import is different

Contact import is a separate process for adding pre-existing contacts using supported External IDs.

You can import contacts using:

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

When you import a contact with a phone number, WOZTELL immediately creates a record for them using that phone number as the primary identifier.

To send your first Phone Number Request, log in to WOZTELL and open a conversation with a contact who has no phone number. If you’re not using WOZTELL yet, you can start for free. The full guides are in our Knowledge Base.