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.
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 | Obrigatório | Ainda 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.
“um identificador para enviar mensagem a um usuário mesmo sem saber o número dele”
Meta, documentação oficial 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 os campos fromBSUID e toBSUID nos webhooks e tratar o from 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, por exemplo, em templates de autenticação.
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.
