Nomes de usuário do WhatsApp e BSUID: o que muda para quem usa a API
Com os nomes de usuário do WhatsApp, quem adota um nome deixa de mostrar o número de telefone às empresas. Para a API continuar funcionando, a Meta envia um identificador novo, o business-scoped user ID (BSUID), único por usuário e por portfólio empresarial. Sistemas que identificam contatos só pelo telefone precisam passar a guardar o BSUID, senão perdem mensagens de anúncios click-to-WhatsApp e de atendimento de quem adotou nome de usuário.
Este artigo faz parte do guia API oficial do WhatsApp na operação.
O que muda
Hoje toda pessoa no WhatsApp é identificada pelo telefone. Com os nomes de usuário, passam a existir dois tipos de usuário: quem não adota continua identificado pelo telefone, e quem adota passa a ser identificado pela empresa por um identificador novo. O telefone de quem adota fica oculto por padrão, e a pessoa pode compartilhá-lo se quiser.
Como é o BSUID
- Único: dois usuários nunca têm o mesmo.
- Por empresa: duas empresas veem identificadores diferentes para a mesma pessoa. A empresa é definida no nível do portfólio empresarial.
- Presente nos webhooks que hoje trazem o telefone.
Cronograma da Meta
| Quando | O quê |
|---|---|
| Outubro de 2025 | Anúncio aos parceiros e empresas |
| Maio de 2026 | Testes do BSUID com a Meta |
| Junho de 2026 | Pessoas em países de teste começam a adotar nomes de usuário; empresas da API podem reservar o próprio nome |
| Resto de 2026 | Disponibilidade global |
O que continua igual
- Quem não adotou nome de usuário segue mandando telefone e BSUID.
- Depois de uma interação com o telefone, a Meta devolve o número por 30 dias.
- Empresas continuam podendo iniciar conversas com telefones que já conhecem.
- Mensagens de autenticação continuam só por telefone.
O que adaptar no seu sistema
- Guardar o BSUID em cada contato, ao lado do telefone e do e-mail.
- Aceitar contatos sem telefone no banco de dados e nas conversas.
- Avisar os sistemas integrados (CRM, automações, agentes de IA) de que o telefone pode faltar.
- Pedir o telefone dentro da conversa quando o fluxo depender dele. A Meta vai oferecer um fluxo nativo de compartilhamento.
- Tratar a troca de identificador quando o BSUID de um usuário mudar.
Confira os nomes exatos dos campos na documentação oficial antes de mudar o código.
Perguntas frequentes
O que é BSUID no WhatsApp?
É o business-scoped user ID, o identificador que a Meta envia à empresa para reconhecer um usuário do WhatsApp sem o telefone. Ele é diferente para cada portfólio empresarial.
Vou perder os telefones que já tenho?
Não. Empresas que já têm o telefone de conversas anteriores continuam com ele e podem seguir enviando mensagens.
O que acontece se meu sistema não usar o BSUID?
Segundo a Meta, ele deixa de receber mensagens de anúncios click-to-WhatsApp e de atendimento de quem adotou nome de usuário.
Fontes
- Meta: Business-scoped user IDs
- Meta: WhatsApp usernames overview, guia para parceiros (outubro de 2025)
Informações conferidas em 10 de novembro de 2026. A Meta muda regras e prazos; confirme na documentação oficial.