# Username (BSUID - coming soon!)

The **Username** feature is Meta's latest release, which enables customers to seamlessly initiate WhatsApp conversations with your business without revealing their personal phone numbers, by utilizing a unique username.

Given that each individual has a unique WhatsApp username, Meta generates a corresponding BSUID (Business-Scoped User ID). This BSUID serves as an internal identifier created exclusively for the relationship between that person and your business.

### How it works? <a href="#how-it-works" id="how-it-works"></a>

Users who do not adopt usernames, will continue be identifiable by their phone numbers, while users who do adopt usernames will be identifiable to the business by a BSUID.

If a user adopts a username, their phone number will no longer be visible to businesses. Instead, that user can choose to proactively share it with a business if needed.

### Update Guide: User Interface Changes

#### 1. Contact Import

The contact management screen and the upload spreadsheet have been updated to support Meta's new identifier.

* **New Table Column:** The default view of your contact list now includes a dedicated column for the **BSUID** alongside the traditional phone number.
* **Contact Spreadsheet Upload:** Within the import wizard, the first column (`Destination`) has been made more flexible:
  * It continues to accept traditional phone numbers.
  * It now also accepts the **BSUID** directly as a destination.
  * For WhatsApp dispatches, clients can include the BSUID information in the same column as the phone number or add a dedicated secondary column.

<figure><img src="/files/NAfQ8AB9nfYGH3DOAIo3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wbN2ez0j0nfREd3FS913" alt=""><figcaption></figcaption></figure>

#### 2. Group Import and Multi-Channel Restrictions

Since the BSUID is an exclusive identifier within the WhatsApp ecosystem, we have implemented an interface safeguard to prevent delivery failures on other channels (such as SMS or RCS).

* **Business Rule:** If a contact group contains only BSUIDs and the client attempts to send a message via a channel other than WhatsApp, the dispatch **will not be processed**.
* **Interface Alert (Warning Banner):** A yellow visual alert has been added to the recipient screens of other channels to warn that BSUID usage is exclusive to WhatsApp.

<figure><img src="/files/k3HekwKdIKObgEhi4roE" alt=""><figcaption></figcaption></figure>

#### 3. Message Sending Flow

The bulk dispatch workflow has been optimized to support hybrid (merged) lists.

* **Hybrid Dispatches:** It is now possible to combine contacts identified by BSUIDs and contacts identified by traditional telephone numbers in a single WhatsApp dispatch.<br>

<figure><img src="/files/dh6juk8MqbTXkQbFIPIf" alt=""><figcaption></figcaption></figure>

#### 4. File Manager

We have updated the help guidelines directly on the file upload screen within the File Manager.

* **Guidance Note (Tooltip):** A direct reminder has been inserted at the top of the upload area to provide intuitive guidance.

<figure><img src="/files/x1Nl9tUccoiXDafLpWZe" alt=""><figcaption></figcaption></figure>

#### 5. Reports and Analytics

The detailed reporting interface now features new data columns and three new search and filtering options to ensure complete traceability.

| **Field / Filter**         | **How It Works in the Interface**                                                                                                 |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **BSUID Filter**           | A new dedicated search field allows you to filter reports by a specific BSUID (e.g., `BR.2769022033788091`).                      |
| **BSUID Column in Report** | Generated reports now feature an exclusive column to display the **BSUID**, facilitating easy export and verification.            |
| **Search by Destination**  | Allows searching by the identifier used for the dispatch. If sent via BSUID, search by BSUID. If sent via phone, search by phone. |
| **Phone Filter**           | Retains the traditional search focused exclusively on the client's phone number.                                                  |

<figure><img src="/files/v9zbcUPeK9dEGVhnsSoB" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/s4rJS27G3B5ynyP8upRu" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-latam.messaging.sinch.com/whatsapp/username-bsuid-coming-soon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.