> For the complete documentation index, see [llms.txt](https://docs-pt.sinch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-pt.sinch.com/whatsapp/username-bsuid-vem-ai.md).

# Username (BSUID - vem aí!)

O **Username** é a nova feature da Meta, que permite aos clientes iniciarem conversas com a sua empresa pelo WhatsApp de forma simples, sem precisar revelar o número de telefone pessoal deles, usando um nome de usuário único (username).

Sabendo-se que cada pessoa tem um usuário único no WhatsApp, a Meta cria um BSUID (Business-Scoped User ID) correspondente. Esse BSUID é um identificador interno gerado exclusivamente para a relação daquela pessoa com a sua empresa.

### **Como funciona?**

Os usuários que não adotarem nomes de usuário continuarão a ser identificáveis por seus números de telefone, enquanto os usuários que adotarem nomes de usuário serão identificáveis para a empresa por meio de um BSUID.

Se um usuário adotar um nome de usuário, seu número de telefone não estará mais visível para as empresas. Em vez disso, o usuário poderá optar por compartilhá-lo proativamente com a empresa, se necessário.

## Guia de Atualizações: Mudanças na Interface do Usuário

### 1. Importação de Contatos 

A tela de gerenciamento de contatos e a planilha de upload foram atualizadas para suportar o novo identificador da Meta.<br>

* **Nova Coluna na Tabela:** A visualização padrão da sua lista de contatos agora inclui uma coluna dedicada para o **BSUID** ao lado do telefone clássico.
* **Upload de Planilha de Contatos:** No assistente de importação, a primeira coluna (`Destination`) foi flexibilizada:
  * Ela continua aceitando o número de telefone tradicional.
  * Agora ela também aceita o **BSUID** diretamente como destino.
  * Para envios de WhatsApp, o cliente pode incluir a informação do BSUID na mesma coluna do telefone ou adicionar uma coluna secundária dedicada.<br>

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

<figure><img src="/files/3HQOZwHU6jeSyltqTZvP" alt=""><figcaption></figcaption></figure>

### 2. Importação de Grupos e Restrições Multicanal

Como o BSUID é um identificador exclusivo do ecossistema WhatsApp, criamos uma trava de segurança na interface para evitar falhas em envios de outros canais (como SMS ou RCS).

* **Regra de Negócio:** Se um grupo de contatos contiver apenas BSUIDs e o cliente tentar enviar uma mensagem por um canal diferente do WhatsApp, o disparo **não será processado**.
* **Alerta de Interface (Banner de Aviso):** Um alerta visual amarelo foi adicionado nas telas de destinatários de outros canais para avisar sobre o uso de BSUID ser exclusivo do Whatsapp.<br>

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

### 3. Fluxo de Envio de Mensagens&#x20;

O fluxo de envios em massa foi otimizado para dar suporte a listas híbridas (mescladas).

* **Envios Híbridos:** Agora é possível combinar, em um único disparo de WhatsApp, contatos identificados por BSUIDs e contatos identificados por números de telefone tradicionais.

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

### 4. Gerenciador de Arquivos&#x20;

Atualizamos as orientações de ajuda diretamente na tela de upload de arquivos no File Manager.

* **Nota de Orientação (Tooltip):** Um lembrete direto foi inserido no topo da área de upload para guiar de forma intuitiva.

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

### 5. Relatórios e Analytics

A interface de relatórios detalhados recebeu novas colunas de dados e três novas opções de busca e filtragem para garantir total rastreabilidade.

| **Campo / Filtro**            | **Como Funciona na Interface**                                                                                                          |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Filtro de BSUID**           | Um novo campo de busca dedicado permite filtrar os relatórios por um BSUID específico (ex: `BR.2769022033788091`).                      |
| **Coluna BSUID no Relatório** | Os relatórios gerados agora possuem uma coluna exclusiva para exibir o **BSUID**, permitindo fácil exportação e conferência.            |
| **Busca por Destino**         | Permite buscar pelo identificador usado no envio. Se enviou via BSUID, busque pelo BSUID. Se enviou por telefone, busque pelo telefone. |
| **Filtro de Telefone**        | Mantém a busca tradicional focada exclusivamente no número de telefone do cliente.                                                      |

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

<figure><img src="/files/8gYayqA1zyTSooY4ZyiB" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-pt.sinch.com/whatsapp/username-bsuid-vem-ai.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.