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