BSUID no WhatsApp: o que é e o que muda na API em 2026

O WhatsApp está passando por uma mudança importante na forma como identifica usuários dentro da sua API oficial.

A Meta está introduzindo o BSUID (Business Scoped User ID), um novo identificador que passa a complementar e, em alguns casos, substituir o uso do número de telefone nas integrações do WhatsApp Business.

Essa atualização faz parte de uma evolução maior da plataforma, especialmente com a chegada dos nomes de usuário no WhatsApp, que reduzem a dependência do número como principal forma de identificação.

Neste artigo, você vai entender o que é o BSUID, como ele funciona tecnicamente, o que muda na prática e como essa mudança impacta empresas que utilizam o WhatsApp como canal de atendimento e comunicação — inclusive o risco real de perder rastreabilidade de clientes e sofrer bloqueios caso a integração não seja atualizada.

Como funcionava a identificação no WhatsApp antes do BSUID

Até então, o WhatsApp utilizava o número de telefone como base para identificar usuários.

Na prática:

• o número funcionava como identificador único
• era utilizado em webhooks, APIs e integrações
• estruturava toda a lógica de envio e recebimento de mensagens

Esse modelo sempre foi suficiente para a operação do WhatsApp Business, mas traz algumas limitações, principalmente com a evolução da plataforma.

Limitações do modelo baseado em número

Com o crescimento do uso do WhatsApp por empresas, alguns pontos começaram a ficar evidentes:

• dependência total do número de telefone
• necessidade de expor o número para iniciar conversas
• dificuldade de evoluir para novos formatos (como usernames)
• maior sensibilidade em relação a dados pessoais

Esses fatores levaram a Meta a repensar a forma como os usuários são identificados dentro da plataforma.

O que é BSUID no WhatsApp

O BSUID (Business Scoped User ID) é um identificador único criado pela Meta para representar um usuário dentro do contexto de uma empresa na API do WhatsApp Business.

Na prática, ele funciona como um ID técnico. Diferente do número de telefone:

• não é visível para o usuário
• é gerado automaticamente pela Meta
• passa a ser utilizado nos eventos da API

Exemplo de formato:

US.13491208655302741918

O BSUID segue o padrão {código do país ISO 3166 alfa-2}.{até 128 caracteres alfanuméricos}. É importante usar sempre o valor completo — incluindo o código do país e o ponto — ao utilizá-lo em chamadas de API. Omitir ou modificar qualquer parte do BSUID faz a requisição falhar.

Esse identificador começa a aparecer em:

• webhooks
• eventos de mensagens
• integrações com a API

Comportamento do BSUID: o que muda e o que permanece

Três características técnicas do BSUID são fundamentais para entender como trabalhar com ele:

• É único por portfólio de negócios: um mesmo usuário do WhatsApp terá um BSUID diferente para cada empresa com a qual interagir. Ou seja, o BSUID não é um identificador global do usuário, mas sim um identificador vinculado à relação entre aquele usuário e o seu portfólio específico.
• É estável mesmo se o usuário mudar o nome de usuário: se um cliente alterar o username no WhatsApp, o BSUID dele para a sua empresa permanece o mesmo. Isso garante continuidade no histórico.
• É regenerado se o usuário mudar o número de telefone: nesse caso, um novo BSUID é gerado. Sistemas que mantinham o vínculo pelo número precisarão lidar com essa situação.

Por que a Meta criou o BSUID

A introdução do BSUID está diretamente ligada à chegada dos nomes de usuário no WhatsApp.

Com essa mudança:

• o número de telefone pode deixar de ser obrigatório em todas as interações
• usuários podem conversar sem compartilhar seu número
• a API precisa de um novo identificador confiável

O BSUID resolve exatamente esse ponto. Ele garante que a comunicação continue funcionando mesmo sem depender exclusivamente do número.

Mas há uma consequência direta para empresas: se o CRM ou a integração ainda usar apenas o número de telefone como chave primária para identificar clientes, o sistema quebrará assim que os primeiros usuários adotarem o username e ocultarem o número. O histórico de conversas ficará fragmentado e leads qualificados poderão ser perdidos silenciosamente.

O que muda na prática com o BSUID

A mudança acontece principalmente na camada técnica, mas tem impactos diretos na operação.

Identificação do usuário deixa de ser única

Agora, uma conversa pode envolver:

• número de telefone
• nome de usuário
• BSUID (identificador principal da API)

Isso exige que sistemas estejam preparados para trabalhar com múltiplos identificadores.

Webhooks e eventos da API são atualizados

As notificações passam a incluir novos campos. Quando um usuário envia uma mensagem para a sua empresa, o evento de recebimento agora inclui o campo fromBSUID com o BSUID do remetente. Se esse usuário adotou um username e ocultou o número, o campo from pode estar vazio ou nulo.

Os dois campos coexistem quando o número ainda está disponível. Ou seja, a estrutura passa a funcionar assim:

• from: número de telefone (pode estar vazio)
• fromBSUID: BSUID do remetente (sempre presente)

O mesmo vale para eventos de status de entrega, que passam a incluir o campo toBSUID.

Atenção: qualquer automação ou integração que pressupõe que o campo from sempre contenha um número de telefone vai parar de funcionar corretamente quando usuários com username começarem a interagir.

Envio de mensagens evolui

Com a evolução da API, será possível:

• enviar mensagens usando número
• enviar mensagens usando BSUID
• utilizar ambos conforme o contexto e necessidade

O campo to na API já aceita tanto um número de telefone quanto um BSUID. O serviço detecta automaticamente o formato e faz o roteamento correspondente, sem necessidade de campos novos.

Quando o número de telefone ainda aparece nos webhooks

Mesmo depois que um usuário adotar um username e ocultar o número, o telefone ainda será incluído nos webhooks quando pelo menos uma destas condições for verdadeira:

• sua empresa enviou ou recebeu uma mensagem desse número nos últimos 30 dias
• o usuário está salvo no Livro de Contatos

Importante: esse período de 30 dias é contado por número de telefone comercial, não por portfólio. Isso significa que interações com um número comercial específico não garantem a visibilidade do telefone do cliente em outros números do mesmo portfólio.

O Livro de Contatos da Meta

Para facilitar a transição, a Meta disponibilizou o Livro de Contatos, um recurso que armazena automaticamente o mapeamento entre número de telefone e BSUID a partir das interações realizadas.

Suas principais características:

• é fornecido e hospedado pela Meta, sem necessidade de configuração adicional
• está habilitado por padrão
• tem escopo no nível do portfólio comercial
• captura apenas interações que ocorrem após a sua ativação — dados históricos anteriores não são armazenados retroativamente

Na prática, isso significa que quanto antes as integrações começarem a funcionar com o BSUID, mais completa será a base de mapeamentos disponível para consulta futura.

Cronograma da mudança do BSUID no WhatsApp

A implementação acontece de forma gradual.

31 de março de 2026

• BSUIDs começam a aparecer em todos os webhooks de produção
• empresas passam a receber o novo identificador automaticamente

Início de abril de 2026

• lançamento do Livro de Contatos gerenciado pela Meta
• início do mapeamento automático entre número e BSUID

Junho de 2026

• liberação do envio de mensagens via BSUID em produção
• início da implementação gradual dos nomes de usuário para os usuários finais

Ao longo de 2026

• adoção crescente dos nomes de usuário
• redução progressiva da dependência do número como identificador principal

Limitações do BSUID que as empresas precisam conhecer

O BSUID não resolve todos os cenários. Existem situações em que ele ainda não pode ser utilizado:

• Templates de autenticação (OTP de um toque, sem toque e cópia de código) ainda exigem número de telefone. O BSUID não pode ser usado nesses casos.
• O BSUID é restrito ao portfólio de negócios onde foi gerado. Ele não pode ser compartilhado ou utilizado em portfólios diferentes.
• O Livro de Contatos não é retroativo. Interações anteriores à sua ativação não são registradas.

O que as empresas precisam considerar a partir dessa mudança

Essa atualização exige atenção principalmente para quem utiliza o WhatsApp de forma estruturada.

Alguns pontos importantes:

• sistemas que usam apenas número como identificador precisam evoluir para suportar o BSUID
• automações devem considerar que o campo from pode estar vazio ou nulo
• integrações devem ler os campos fromBSUID e toBSUID nos eventos da API
• filtros de webhook baseados em número de telefone do remetente precisam ser atualizados para aceitar também valores BSUID

Na prática, empresas que utilizam plataformas especializadas tendem a não sentir impacto direto, já que essas soluções, como a Digisac, acompanham continuamente as mudanças da Meta e já incorporam essas atualizações nas integrações com a API oficial.

Impacto no atendimento e nas operações

Apesar da mudança técnica, o funcionamento do atendimento tende a permanecer estável.

O impacto acontece principalmente:

• na forma como os dados são estruturados
• na identificação dos usuários nos bastidores
• nas integrações com a API

Para equipes de atendimento, a experiência continua a mesma, desde que a tecnologia utilizada esteja atualizada. O risco real está nas operações que dependem de integrações customizadas ou de sistemas que nunca foram ajustados para trabalhar com múltiplos identificadores.

BSUID e privacidade no WhatsApp

Assim como outras atualizações recentes, essa mudança reforça o foco da Meta em privacidade.

Na prática:

• o número de telefone deixa de ser obrigatório em todos os cenários
• o usuário ganha mais controle sobre seus dados
• a identificação se torna mais segura e desvinculada de informações pessoais sensíveis

Esse modelo segue o conceito de privacy by design, cada vez mais presente nas plataformas digitais — e que tende a se intensificar nos próximos anos.

Conclusão

A introdução do BSUID no WhatsApp representa uma evolução importante na estrutura da API, acompanhando mudanças como os nomes de usuário e a redução da dependência do número de telefone.

Para empresas, o principal ponto é entender que:

• a identificação de usuários está mudando e o número de telefone não pode mais ser a única chave de vínculo com o cliente
• integrações precisam acompanhar essa evolução — especialmente nos campos fromBSUID, toBSUID e nos filtros de webhook
• a base técnica do WhatsApp está sendo atualizada de forma progressiva, com marcos concretos já em andamento desde março de 2026
• a janela para adaptar sistemas sem impacto na operação é agora — antes que a adoção dos usernames se generalize em junho de 2026

Assim como em outras mudanças recentes da Meta, o impacto maior acontece nos bastidores. Empresas que utilizam plataformas que acompanham continuamente essas atualizações, como a Digisac, tendem a passar por essa transição de forma transparente, sem impacto direto na operação ou necessidade de ajustes manuais.

Na prática, isso significa que, enquanto o WhatsApp evolui sua infraestrutura, o atendimento ao cliente continua funcionando normalmente — com mais segurança, consistência e preparação para as próximas mudanças da plataforma.