Username no WhatsApp é oficial: o que é BSUID e como preparar sua empresa

A Meta tornou oficial o lançamento de usernames no WhatsApp. A partir de julho, clientes podem usar um @username em vez de compartilhar o número de telefone ao iniciar conversas com empresas. Para quem usa a API do WhatsApp, isso significa uma mudança importante: você vai receber um BSUID (business-scoped user ID) em vez do número de telefone em mensagens de novos clientes que optarem por username.

TL;DR: Usernames do WhatsApp são opcionais e protegem a privacidade do cliente. Quando ele usa @username, a API retorna um BSUID (ID único) em vez do telefone. Você pode enviar mensagens ativas via BSUID ou pedir o número com um botão CTA direto na conversa.

Eu acompanhei a documentação técnica e os materiais que a Meta liberou para parceiros. Neste artigo, vou direto ao ponto: o que muda na prática, como funciona o BSUID, e o que você precisa fazer agora para não quebrar seu fluxo de atendimento.

O que são usernames no WhatsApp?

Usernames são handles únicos (tipo @SuaEmpresa) que empresas e usuários podem reivindicar. Para consumidores, é uma forma de iniciar conversas sem expor o número de telefone. Para empresas, é uma identidade adicional — mais fácil de compartilhar que um número longo.

A funcionalidade é opcional. Quem não quer, continua usando telefone normalmente. Mas quem adota username pode simplesmente compartilhar o @handle em redes sociais, site ou QR code, e receber mensagens sem divulgar o número.

Empresas já podem reservar e aprovar usernames via WhatsApp Manager, Meta Business Suite ou a Username API. Quando o rollout chegar na sua região (começa em julho), o username aprovado fica ativo e alcançável.

Eu recomendo planejar sua estratégia de username agora — handles óbvios como @SuaMarca vão rápido.

O que é BSUID e quando ele aparece?

BSUID significa business-scoped user ID. É um identificador único gerado pelo WhatsApp para representar um cliente específico na sua empresa.

Ele aparece quando:

• Um cliente que adotou username inicia uma conversa com sua empresa pela primeira vez.
• O cliente nunca mandou mensagem antes, então você não tem o número dele no Contact Book.

Nesse caso, o webhook da Cloud API retorna o BSUID no campo from, em vez de um número de telefone.

O impacto inicial é limitado: a mudança afeta só conversas novas de clientes que escolheram username e nunca falaram com você antes.

Se o cliente já está no seu Contact Book (porque conversou antes, ou você importou o contato), o número continua vindo normalmente — desde que o Contact Book esteja habilitado (está por padrão) e vocês tenham interagido recentemente.

Resumo: BSUID é o "nome" técnico do cliente quando ele opta por privacidade. Você não vê o telefone, mas pode conversar e até enviar mensagens ativas usando o BSUID.

Como enviar mensagens para quem usa BSUID?

A Meta está liberando duas funcionalidades novas em julho para você continuar engajando clientes que usam username:

1. Send to BSUID

Você pode enviar mensagens business-initiated (templates aprovados) diretamente para o BSUID, sem precisar do número de telefone.

Na prática, é o mesmo fluxo de envio via API — você troca o campo to (que antes era +5511999998888) pelo BSUID que recebeu no webhook.

Isso significa que campanhas, notificações, lembretes e cobranças continuam funcionando normalmente, mesmo sem o telefone.

2. Phone Number Request CTA

Um botão de call-to-action que pede o número de telefone do cliente dentro da conversa.

Quando você envia esse CTA e o cliente aceita compartilhar, o WhatsApp retorna o número no próprio thread e adiciona automaticamente ao seu Contact Book.

Eu vejo isso como uma solução elegante: você não perde a capacidade de coletar telefone — só precisa do consentimento explícito do cliente, o que aliás está alinhado com LGPD.

A Meta recomenda usar o CTA quando você realmente precisa do telefone (por exemplo, para integrar com sistemas legados, enviar SMS, ou fazer cobrança via operadora).

O que muda na sua integração técnica?

Se você usa a Cloud API do WhatsApp (diretamente ou via parceiro como Twilio, Zenvia, MessageBird), vai precisar ajustar três pontos:

Processar webhooks com BSUID

Quando o webhook de mensagem inbound chega, o campo from pode ser:

• Um número de telefone (+5511999998888), ou
• Um BSUID (BSUID:abc123xyz...).

Seu código precisa detectar qual dos dois chegou e tratar cada caso.

Exemplo (pseudocódigo):

if (message.from.startsWith("BSUID:")) {
  // Cliente usa username; armazene o BSUID como identificador
  customer_id = message.from;
} else {
  // Cliente compartilhou telefone; use como sempre
  customer_id = message.from;
}

Armazenar BSUID no CRM

Se hoje você usa telefone como chave primária ou identificador único de cliente, vai precisar também aceitar BSUID.

Opções:

• Criar um campo identifier que pode ser telefone ou BSUID.
• Manter campo phone nullable e adicionar campo bsuid.
• Normalizar ambos em um contact_id interno.

A escolha depende da arquitetura do seu CRM. O ponto é: não assuma que from sempre tem formato de telefone.

Atualizar lógica de envio e roteamento

Se você faz roteamento (por exemplo, direcionar conversa pro agente que atendeu aquele telefone antes), vai precisar rotear também por BSUID.

Se você faz envio de templates via API, use o BSUID no campo to quando aplicável.

Boa notícia: a Meta já liberou acesso ao Dummy API / sandbox e aos webhooks de teste. Você consegue simular conversas com BSUID antes do rollout, então não precisa esperar julho pra começar.

Documentação oficial: https://developers.facebook.com/docs/whatsapp

Como fica o Contact Book?

O Contact Book (habilitado por padrão) continua sendo sua principal ferramenta para garantir acesso ao número de telefone.

Quando habilitado, o WhatsApp armazena o número de clientes que interagiram com você e o retorna nos webhooks — mesmo se o cliente adotar username depois.

Ou seja: se você já conversou com alguém, o número continua aparecendo normalmente.

O BSUID só chega quando:

• Cliente nunca falou com você antes, e
• Cliente adotou username, e
• Você não tem o número dele importado no Contact Book.

Por isso eu recomendo: mantenha o Contact Book ativo e, se possível, importe os contatos de clientes antigos para garantir continuidade.

Vale a pena adotar username como empresa?

Sim, especialmente se você divulga o WhatsApp em canais públicos (Instagram, site, anúncios).

Um @username é:

• Mais fácil de lembrar que um número +55 11 99999-8888.
• Mais limpo em bio de rede social ou post.
• Menos propenso a erro de digitação (ninguém vai errar um dígito no meio).

Além disso, quando você reserva o username, ele fica exclusivo — ninguém mais pode pegar. Isso protege sua identidade de marca.

Eu sugiro reservar o username principal da sua marca e eventuais variações (abreviações, nome fantasia) o quanto antes, antes que outros reivindiquem.

Estratégia prática: checklist de preparação

Aqui está o que eu faria se gerenciasse uma integração WhatsApp Business hoje:

1. Reservar username via WhatsApp Manager ou API — agora, antes do rollout.
2. Testar BSUID no sandbox usando a Dummy API da Meta — simule webhook com BSUID e ajuste seu código.
3. Atualizar CRM/banco para aceitar identificadores que não são telefone.
4. Revisar lógica de roteamento (agentes, filas, tags) para funcionar com BSUID.
5. Implementar Phone Number Request CTA onde você realmente precisa do telefone (ex: integração com ERP, envio de NF por SMS).
6. Documentar internamente que novos clientes podem vir sem telefone — treine suporte e comercial.

A Meta disse que o rollout é gradual nas próximas semanas. Ou seja, você tem uma janela curta, mas real, para se preparar.

Principais aprendizados

• Usernames são opcionais, mas vão se popularizar — privacidade é tendência.
• BSUID substitui o telefone em conversas novas de clientes que usam @username.
• Você pode enviar mensagens ativas (templates) via BSUID, sem o telefone.
• O Phone Number Request CTA permite pedir o número dentro da conversa, com consentimento.
• Contact Book ativo garante que você continue recebendo telefone de clientes antigos.
• Integração técnica exige ajustes em webhook, CRM e roteamento — comece a testar no sandbox hoje.

Perguntas frequentes

O que é BSUID no WhatsApp?

BSUID (business-scoped user ID) é um identificador único que o WhatsApp gera para representar um cliente quando ele usa username em vez de compartilhar o número de telefone com sua empresa.

Vou perder o telefone de todos os meus clientes?

Não. Clientes antigos (já no Contact Book) continuam retornando o telefone normalmente. BSUID aparece só em conversas novas de quem adota username e nunca falou com você antes.

Consigo enviar mensagens ativas para BSUID?

Sim. A partir de julho, você pode enviar mensagens business-initiated (templates aprovados) usando o BSUID no campo to da API, exatamente como faz com telefone.

Como peço o número de telefone de um cliente que usa username?

Use o Phone Number Request CTA, um botão que pede consentimento dentro da conversa. Se o cliente aceitar, o número é retornado no thread e adicionado ao Contact Book automaticamente.

Preciso mudar minha integração antes de julho?

Sim, o quanto antes. A Meta recomenda preparar seus webhooks, CRM e lógica de roteamento para processar BSUID. Você já pode testar no sandbox — não espere o rollout para descobrir que algo quebrou.

Username é obrigatório para empresas?

Não. É opcional, mas recomendado para facilitar divulgação e proteger sua identidade de marca. Clientes também escolhem se querem adotar username — quem não adota continua usando telefone normalmente.

---

E você, já está preparando sua integração para BSUID? Conta nos comentários se usa WhatsApp API e qual o maior desafio que você vê nessa transição — ou se já testou no sandbox e tem dicas pra compartilhar.