Existe uma mudança silenciosa acontecendo no WhatsApp Business, e ela pode passar despercebida até o dia em que o seu CRM começa a perder o rastro dos clientes. O nome dessa mudança é BSUID, o novo identificador que a Meta passou a enviar nas conversas.
O risco não é dramático à primeira vista: nada explode, nenhuma mensagem para de chegar. O problema é mais sutil. Se o seu sistema identifica o cliente apenas pelo número de telefone, ele pode simplesmente deixar de reconhecer quem chega por um username, fragmentando o histórico sem gerar erro visível.
Neste artigo, explicamos o que é o BSUID, como ele aparece nas conversas, em que ponto ele difere do número de telefone e por que ignorá-lo pode custar caro para a operação de atendimento e vendas.
O que é o BSUID
O BSUID (Business Scoped User ID) é um identificador único que a Meta cria para representar um usuário dentro do contexto de uma empresa na API do WhatsApp Business. Diferente do número, ele não é visível para o cliente e é gerado automaticamente. Segundo a documentação oficial da Meta, ele segue o padrão código do país mais uma sequência de até 128 caracteres, como no exemplo US.13491208655302741918.
A própria documentação para desenvolvedores da Meta define três características centrais: o BSUID é único por empresa, permanece o mesmo se o cliente trocar de username e é regenerado se ele trocar de número, como também detalha o changelog da Twilio.
O calendário já avançou desde a publicação deste artigo. A documentação da Meta registra que os BSUIDs começaram a aparecer nos webhooks no início de abril de 2026, que a reserva do username de empresa foi liberada em 29 de junho de 2026 e que as APIs passaram a aceitar o envio de mensagens direcionadas ao BSUID em julho de 2026. Na prática, o identificador já circula na sua operação, mesmo que ninguém tenha mexido na integração.
Parent BSUID: quando a empresa tem vários portfólios
Há um detalhe que afeta quem opera com mais de um portfólio de negócios. Como o BSUID é escopado por portfólio, o mesmo cliente teria identificadores diferentes em cada um deles. Para esse caso, a Meta oferece o parent BSUID, entregue no campo parent_user_id e reconhecível pelo trecho ENT entre o código do país e a sequência numérica, no formato US.ENT.11815799212886844830. Ele vale para todos os portfólios inscritos na mesma conta, mas depende de habilitação junto ao contato Meta da empresa.
Como o BSUID aparece nas conversas
Quando um cliente envia mensagem, o identificador do usuário (BSUID) passa a aparecer nos webhooks de mensagens, mesmo que ele não tenha ativado o username. Se o cliente adotou um username e ocultou o número, o campo com o telefone pode chegar vazio ou nulo, e a empresa passa a reconhecê-lo pelo BSUID. Para ajudar na transição, a Meta criou o Livro de Contatos, que mapeia automaticamente número e BSUID a partir das interações, mas apenas das que acontecem depois da sua ativação.
Número de telefone vs BSUID
| Aspecto | Número de telefone | BSUID |
|---|---|---|
| Visibilidade | Visível ao cliente | Identificador técnico interno |
| Escopo | Global, igual para todos | Único por empresa (portfólio) |
| Se o cliente troca o username | Continua igual | Permanece o mesmo |
| Se o cliente troca o número | Muda | É regenerado |
| Templates de autenticação one-tap, zero-tap e copy code | Obrigatório | Não suportado |
Por que ele pode quebrar o seu CRM
O ponto crítico é a chave de identificação. Se o CRM usa apenas o número como chave primária, o sistema perde o vínculo assim que o cliente adota o username e oculta o número. O atendimento continua rodando, mas o histórico se parte em pedaços.
O BSUID identifica o usuário dentro do portfólio da empresa e permite enviar mensagem a ele sem conhecer o número de telefone.
Síntese da documentação oficial da Meta sobre BSUID
Esse é o tipo de falha que não dispara alarme, mas corrói a qualidade dos dados, tema que já tratamos ao falar dos sinais silenciosos que afastam clientes. Sem um vínculo estável, a personalização perde precisão e leads qualificados se perdem no meio do caminho.
O que fazer
- Adotar o BSUID como chave estável de identificação, ao lado do número.
- Ler o campo
user_idnos webhooks de mensagens e ofrom_user_idnos webhooks de status, tratando o caso em que o número chega vazio. - Atualizar filtros de webhook que hoje dependem só do número do remetente.
- Ativar cedo o mapeamento entre número e BSUID, já que ele não é retroativo.
Se você começou por aqui, vale entender também como reservar o username da sua empresa e seguir o checklist para preparar as integrações antes que a adoção se generalize.
Perguntas frequentes
O que significa BSUID no WhatsApp?
BSUID, ou Business Scoped User ID, é um identificador único que a Meta cria para representar um usuário dentro do contexto de uma empresa na API do WhatsApp Business.
O BSUID substitui o número de telefone?
Não totalmente. Ele passa a ser o identificador principal nas conversas, mas o número continua existindo e ainda é exigido nos templates de autenticação do tipo one-tap, zero-tap e copy code.
O mesmo cliente tem BSUIDs diferentes em empresas diferentes?
Sim. O BSUID é único por relação entre usuário e empresa. O mesmo cliente terá um BSUID diferente para cada empresa com que interage.
Por que o BSUID pode quebrar meu CRM?
Se o CRM identifica o cliente só pelo número, ele perde o vínculo quando o cliente adota um username e oculta o número, fragmentando o histórico sem gerar erro visível.
O que é o Livro de Contatos da Meta?
É um recurso que mapeia automaticamente número e BSUID a partir das interações. Ele não é retroativo, então só registra o que acontece após a ativação.
O que é o parent BSUID?
É um identificador que funciona em vários portfólios de negócios da mesma empresa. Ele chega no campo parent_user_id, usa o formato com ENT entre o código do país e a sequência numérica e precisa ser habilitado junto ao contato Meta.
