Whatsapp Usernames

Modified on: Fri, 7 Aug, 2026 at 8:05 AM

WhatsApp Messaging

WhatsApp Usernames: Contact Capture Without Phone Numbers

Automatically capture new contacts when WhatsApp username adopters message your business for the first time
What You'll Learn

WhatsApp is introducing usernames that allow people to message businesses without sharing their phone number. HighLevel supports this feature by automatically creating contacts from username-based messages.

This article explains how username-based contact capture works, what remains unchanged in your existing workflows, and the current limitations of the feature.

1

What are WhatsApp Usernames?

WhatsApp usernames are a new privacy feature that allows users to message businesses without revealing their phone number. When a customer chooses to use a username instead of their phone number, WhatsApp creates a unique business-scoped user identifier (BSUID) for that interaction.

This feature is part of WhatsApp's broader privacy initiative, giving users more control over their personal information while still enabling business communications.

2

Key Benefits

Username-based contact capture ensures you never lose leads due to customer privacy preferences:

No Gap in Lead Capture — Contacts are automatically created when username adopters message your business, ensuring no conversations or potential customers slip through untracked
Seamless Integration — Works automatically without requiring any setup changes to your existing WhatsApp configuration
Customer Privacy Respect — Supports customer choice in how they share their contact information while maintaining your ability to engage and follow up
Future-Ready — Positions your business for WhatsApp's evolving privacy features as username adoption grows
3

How Username-Based Contact Capture Works

When a customer using a WhatsApp username messages your business for the first time, HighLevel automatically creates a contact record. Here's how the process works:

Step 1
Customer Initiates Contact

A new customer messages your business through WhatsApp using their username instead of sharing their phone number.

Step 2
WhatsApp Provides Username and BSUID

WhatsApp sends the message along with the customer's username and a business-scoped user identifier (BSUID) instead of their phone number.

Step 3
Contact Record Created

HighLevel automatically creates a new contact in your CRM using the username and BSUID. The conversation appears in your Conversations inbox just like any other WhatsApp message.

Step 4
Engage and Follow Up

Once the customer messages you first, their BSUID becomes available and you can reply following standard WhatsApp session window and template message rules.

4

What Remains Unchanged

Username support is an additive capability. Your existing WhatsApp workflows continue to function exactly as before:

Phone Number Messaging
No Change to Existing Behavior

All phone-number-based WhatsApp messaging works exactly as it always has. You can send and receive messages using phone numbers with no difference in behavior or functionality.

Contact Import
Same Process as Before

Importing contacts by phone number continues to work as it does today. No changes to your existing import workflows or processes.

Existing Contacts
All Records Remain Intact

Your existing contact records, conversation history, and running automations are completely unaffected. The only difference is that first-time messages from username adopters create a new contact using the username and BSUID instead of a phone number.

Important Context

Phone numbers are still shared for existing customers or those who have recently interacted with your business (within a 30-day window or in your Meta contact book). The phone number is only withheld for brand-new contacts using usernames for their first message.

5

Messaging and Reply Behavior

Understanding how to communicate with username-based contacts is essential for effective engagement:

Important Limitation

You cannot start a conversation with a username-only contact. WhatsApp does not provide username lookup functionality and routes messages only by phone number or BSUID. This means there is no way to initiate cold outbound messaging to a username-only lead.

You Can Reply

Once a username-based contact messages you first, their BSUID becomes available in your system. You can then reply to their messages following the standard WhatsApp session window rules and template message requirements.

The reply behavior follows all existing WhatsApp Business API rules, including the 24-hour session window for free-form messages and the requirement to use approved templates for messages outside the session window.

6

Regional Availability

WhatsApp username functionality is currently in beta with Meta and rolling out gradually by region. HighLevel's support for username-based contact capture is available in all regions where Meta has enabled the feature.

Current MarketsStatus
Algeria, Azerbaijan, Ghana, Libya, NepalCurrently enabled
Colombia, Dominican Republic, Singapore, Malaysia, PeruCurrently enabled
Additional MarketsRolling out as Meta expands availability
Automatic Support

No action is required on your part. As Meta enables username support in additional regions, HighLevel's contact capture functionality automatically works in those new markets.

7

Frequently Asked Questions

Q: Will I lose any leads if customers use WhatsApp usernames?
No. HighLevel automatically captures username-based contacts when they message your business for the first time. The contact is created using their username and BSUID, ensuring no conversations or potential customers are lost.
Q: Can I message a customer first if they're using a username?
No. WhatsApp does not provide username lookup functionality, so you cannot initiate cold outbound messaging to username-only contacts. However, once they message you first, you can reply following standard WhatsApp session window and template message rules.
Q: Do I need to change any settings to support WhatsApp usernames?
No setup or configuration is required. Username-based contact capture works automatically for all HighLevel accounts in regions where Meta has enabled the feature.
Q: Can I export or store the WhatsApp username in a custom field?
Not currently. Usernames are not yet stored in a dedicated contact field or available for export. This is a known limitation being tracked separately for future development.
Q: What happens to my existing WhatsApp contacts and phone number messaging?
Absolutely nothing changes. All existing contacts, phone number messaging, conversation history, and automations remain completely unchanged. Username support is purely additive to prevent lead loss when customers choose to use usernames.
Q: When do phone numbers still appear for customers?
Phone numbers are still shared for existing customers or those who have recently interacted with your business within a 30-day window or are in your Meta contact book. Phone numbers are only withheld for brand-new username-only contacts messaging you for the first time.
Q: Is WhatsApp username support available in my region?
Username functionality is currently in beta and rolling out gradually by region. It is currently enabled in Algeria, Azerbaijan, Ghana, Libya, Nepal, Colombia, Dominican Republic, Singapore, Malaysia, and Peru. More markets will be added as Meta expands availability.
Q: What is a BSUID?
A business-scoped user identifier (BSUID) is a unique identifier that WhatsApp creates for each username-based customer interaction with your business. This BSUID allows you to reply to messages and maintain the conversation while respecting the customer's choice not to share their phone number.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article