Tudo o Que Você Precisa Saber Sobre Nomes de Usuário e BSUID do WhatsApp (A Partir de Junho de 2026)

Por que o WhatsApp está Introduzindo Nomes de Usuário?

O que está Mudando?

Mensagens de Autenticação (Código de Verificação/OTP) Devem Ser Enviadas por Número de Telefone

Há também uma limitação importante: Mensagens de autenticação ainda exigem um número de telefone.
Você não pode enviar mensagens de autenticação OTP ou copy-code usando apenas um BSUID. Se esse fluxo for importante para sua empresa, você precisa de uma maneira clara de solicitar e armazenar o número de telefone do usuário.

E, em alguns casos, o WhatsApp ainda pode compartilhar o número de telefone com a empresa, como quando:

• O usuário opta ativamente por compartilhá-lo
• Já existe uma conversa entre o usuário e a empresa
• A empresa está salva nos contatos do WhatsApp do usuário

Portanto, as empresas agora precisam suportar ambas as situações ao mesmo tempo:

• Clientes identificados apenas por BSUID
• Clientes identificados tanto por número de telefone quanto por BSUID

É por isso que isso não é apenas uma atualização de produto. É uma atualização do sistema.

O que é BSUID (Business Scoped User ID)

Como o BSUID funciona

• É gerado automaticamente pelo WhatsApp
• Aparece em payloads de webhook (como user_id)
• Funciona mesmo quando o número de telefone está ausente
• Está vinculado a um portfólio de negócios específico

Então, do ponto de vista do sistema, isso se torna o seu identificador de novo usuário em conversas recebidas.

Formato BSUID (Como Se Apresenta)

Um BSUID segue uma estrutura fixa:

• Começa com o código ISO 3166 alpha-2 Código de país de duas letras
• Seguido por um ponto (.)
• Depois uma string alfanumérica única (até 128 caracteres)

Example:
US.13491208655302741918

Ao usá-lo em APIs, o valor completo deve ser usado exatamente como está.
Qualquer alteração ou truncamento fará a requisição falhar.

Regras Principais Que Você Deve Saber

• Um BSUID é único para cada par portfólio de negócios-usuário (portfólios de negócios eram anteriormente conhecidos como Business Managers)
• Ele é regenerado se um usuário alterar seu número de telefone (o que aciona um webhook de mensagens de status do sistema)
• Ele é vinculado a um portfólio de negócios (não pode ser usado em diferentes portfólios)
• Ele aparece em webhooks mesmo que o usuário não tenha ativado nomes de usuário

Limitações do BSUID

BSUID é poderoso, mas não é um substituto completo para números de telefone.

• Você não pode enviar mensagens de autenticação (OTP, códigos de verificação) usando BSUID
• Esses fluxos ainda exigem um número de telefone
• Portanto, se seu caso de uso depende de OTP, você deve coletar o número do usuário

O que NÃO está Mudando

Mecanismos de Envio e Recebimento de Mensagens

• O uso de modelos de mensagem permanece inalterado.
• O suporte a vários tipos de mensagem (texto, imagens, vídeos, documentos etc.) permanece inalterado.
• A estrutura da interface da API de envio de mensagens permanece basicamente consistente, exceto que o parâmetro de identificador precisa ser compatível com o BSUID.
• Empresas que já possuem informações de número de telefone de pessoas em conversas existentes não as perderão e poderão continuar usandos para enviar mensagens a seus contatos.

Regras de Cobrança de Conversas

• O mecanismo de janela de conversa de 24 horas permanece inalterado.
• O método de cobrança das conversas permanece inalterado.
• Independentemente de o cliente usar um número de telefone ou um nome de usuário, a lógica de cobrança permanece consistente.

O que Mais?

• Números de telefone ainda serão parte do funcionamento do WhatsApp.
• Se um usuário não adotar nomes de usuário, as empresas receberão tanto seu número de telefone quanto o identificador de escopo comercial.

Isso significa que as empresas devem concentrar seus principais esforços na identificação do cliente e associação de dados; as capacidades principais de comunicação por mensagens e a lógica de negócios continuarão funcionando como estão

A seguir, vamos ver os desafios que as empresas enfrentarão ao se adaptar a este novo sistema de identificação.

Desafios Enfrentados pelas Empresas

Desafio 1: Incapacidade de Obter Números de Telefone Diretamente para Novos Usuários

Quando um novo usuário entra em contato usando um nome de usuário, você receberá apenas um BSUID.

Você não obterá o número de telefone deles por padrão.

Você ainda pode responder e continuar a conversa usando o BSUID. Mas se o seu negócio precisa do número de telefone (por exemplo, para OTP ou verificação), agora você precisa pedir explicitamente por ele dentro do chat e aguardar o consentimento do usuário.

Desafio 2: Mapeamento do BSUID com Dados Existentes de Clientes

A maioria dos CRMs hoje é construída em torno de números de telefone.

• perfis de clientes
• histórico de chat
• pedidos
• segmentação

Tudo está vinculado ao número de telefone como chave primária.

Agora, com o BSUID em cena, você precisa decidir:

• Você adiciona o BSUID como um novo campo?
• Ou cria uma camada de mapeamento separada entre número de telefone e BSUID?

Esta não é apenas uma decisão técnica, impacta a consistência dos dados, a lógica de consulta e a complexidade do sistema.

Desafio 3: Manter a Continuidade da Conversa Quando os Clientes Alternam Entre Diferentes Identificadores

Do lado do usuário, nada muda. Ainda é uma única conversa.

Mas do lado do seu sistema, as coisas podem quebrar.

Exemplo:

• Primeira interação → Identificado via BSUID
• Depois → Usuário compartilha número de telefone

Se seu sistema não vincular ambos corretamente, o mesmo usuário pode ser tratado como dois clientes diferentes.

Consequências:

• Registros duplicados
• Histórico de chat quebrado
• Experiência ruim do cliente

Desafio 4: Lidando com Fluxos de Verificação & OTP

BSUID não pode ser usado para mensagens de autenticação.

Portanto, se seu fluxo depende de:

• OTP
• Verificação de login
• Vinculação de conta

Você deve primeiro coletar o número de telefone do usuário.

Isso significa que seus fluxos atuais podem precisar ser redesenhados para:

• Solicitar consentimento explicitamente
• Capturar o número
• Armazená-lo e mapeá-lo corretamente

A seguir, vamos ver o que realmente quebrará se esses desafios não forem tratados adequadamente.

O Que Vai Quebrar (Se Você Ignorar Isso)

Aqui está o que começa a quebrar:

• Você pode perder conversas
  Novos usuários que vêm via nomes de usuário não serão mapeados corretamente no seu sistema.
  

• Fluxos de mensagens quebram
  Mensagens de serviço e fluxos de CTWA (Click-to-WhatsApp Ads) podem não ser acionados conforme o esperado.
  

• O histórico de chat fica desconectado
  O mesmo usuário pode aparecer como múltiplas identidades.
  

• Os dados de CRM tornam-se não confiáveis
  Os perfis de clientes podem não armazenar ou mapear dados corretamente.
  

• Usuários duplicados aumentam
  Um usuário = múltiplos registros entre número de telefone e BSUID.
  

• A automação para de funcionar
  Workflows vinculados a números de telefone não serão acionados.
  

• Fluxos de trabalho de ponta a ponta quebram
  Desde a captura de leads até os follow-ups, as coisas começam a desmoronar.
  

• Equipes de vendas perdem visibilidade
  Leads não podem ser identificados ou rastreados adequadamente.
  

É por isso que o impacto é maior do que parece.
Não é apenas um problema de dados, afeta toda a jornada do seu cliente.

A seguir, vamos ver como resolver isso e lidar com a identificação do cliente corretamente.

Soluções de Identificação do Cliente

Cenário 1: Novos Clientes Iniciando Contato Pela Primeira Vez via Nome de Usuário (Apenas BSUID)

Quando um novo cliente inicia uma conversa usando um nome de usuário, seu sistema pode receber apenas o BSUID.

Nesse caso, o BSUID se torna o ponto de partida do perfil desse cliente.

Aqui está como lidar com isso:

• Seu modelo de dados deve suportar mais de um identificador para o mesmo cliente.
• Seu CRM deve ser capaz de criar um perfil de cliente usando BSUID.
• Seu sistema deve suportar busca e identificação usando BSUID.
• Se o negócio precisar do número de telefone (por exemplo, quando um endereço de entrega é necessário ou um código de verificação precisa ser enviado), solicite-o no momento certo dentro da conversa.
• Se o usuário compartilhar, armazene esse número e relacione-o de volta ao mesmo perfil baseado em BSUID.

Cenário 2: Clientes Cujo Número de Telefone Você Já Tem

Se seu negócio já tem o número de telefone de um cliente, você pode continuar usando-o.

Esta parte não muda.

Mesmo que o usuário habilite nomes de usuário, você ainda pode enviar mensagens usando o número de telefone que já conhece. Mas se esse mesmo usuário posteriormente iniciar uma conversa usando um nome de usuário, seu sistema deve ser capaz de conectar o novo BSUID com o registro existente baseado em número de telefone.

Aqui está como lidar com isso:

• Seu modelo de dados ainda deve suportar múltiplos identificadores para um cliente.
• Quando um BSUID aparecer, relacione-o ao registro de cliente existente.
• Seu sistema deve suportar busca por número de telefone ou BSUID.
• PriorizE o número de telefone para mensagens de saída, especialmente para fluxos de verificação ou autenticação

Cronograma & Plano de Ação

O WhatsApp está implementando isso em fases, o que lhe dá tempo para se preparar, mas apenas se você começar cedo.

Cronograma

• 31 de março de 2026 → O BSUID começará a aparecer no Webhook.
• Maio de 2026 → Testes com BSUID disponíveis (você pode começar a enviar usando BSUID).
• Junho de 2026 → Pessoas em países de teste podem começar a adotar nomes de usuário. A implantação de nomes de usuário começa.
• Restante de 2026 → Pessoas em todo o mundo podem começar a adotar nomes de usuário.

O Que as Empresas Devem Fazer

1. Fase de Preparação (Atual)

• Aprenda e compreenda o mecanismo BSUID e os detalhes técnicos.
• Identifique onde os números de telefone são usados nos fluxos de trabalho.
• Defina como você irá lidar com número de telefone vs BSUID.
• Avalie o escopo e a carga de trabalho necessária para modificar os sistemas existentes.
• Desenvolva planos para ajustes no banco de dados e compatibilidade da API.
• Inicie a pesquisa técnica e o design da solução.
• Alinhe as equipes internas (produto, engenharia, marketing) e planeje sua estratégia de nome de usuário comercial.

2. Fase de Implementação (Antes do Lançamento do Recurso)

• Atualize o CRM e o banco de dados para suportar BSUID.
• Complete a transformação de compatibilidade da camada de integração da API.
• Implemente o processo de solicitação de autorização de número de telefone.
• Garanta que as mensagens de código de verificação sejam enviadas usando números de telefone.
• Complete a verificação do ambiente de teste.
• Prepare um plano de lançamento gradual (lançamento em escala reduzida).

3. Teste

• Execute testes de ponta a ponta com cenários reais.
• Valide:
  • Criação de usuário baseada em BSUID
  • Fluxos de coleta de número de telefone
  • Mapeamento entre identificadores
  • Fluxos de mensagens e automação

4. Fase de Ativação (Após o Recurso Ser Lançado)

• Implemente em fases (não mude tudo de uma vez).
• Monitore a saúde operacional do sistema, como precisão na criação de perfis, taxas de sucesso de OTP e desempenho dos fluxos de trabalho.
• Lidere com feedback dos usuários e trate anomalias.
• Otimize a lógica de identificação do cliente.
• Melhore continuamente a precisão da associação de dados.
• Monitore as taxas de autorização de número de telefone e otimize o tempo e as mensagens usadas nas solicitações.
• Solicite e configure seu nome de usuário comercial.

Lista de Verificação Pré-Lançamento

Antes de ir ao ar, verifique se:

• O BSUID está integrado em todos os seus sistemas.
• Você ainda pode enviar e receber mensagens sem números de telefone.
• Todos os fluxos de trabalho são testados para ambos os identificadores.
• Chatbots e jornadas podem solicitar números de telefone quando necessário.
• Os fluxos de trabalho existentes são auditados e atualizados para evitar falhas.

Priorização

• Alta Prioridade → Ajustes na estrutura do CRM e banco de dados, modificações na compatibilidade da API, ajustes na lógica de envio de códigos de verificação (impacta funcionalidades essenciais).
• Média Prioridade → Adaptação dos sistemas de atendimento ao cliente, atualizações dos sistemas de marketing (impacta a eficiência do negócio).
• Baixa Prioridade → Otimização de relatórios de dados, limpeza de dados históricos (pode ser refinado gradualmente).

Isso não é algo para corrigir no último momento.
Quanto mais cedo você se adaptar, mais suave será sua transição.

Onde Encontrar Mais Recursos

Se você está implementando isso, não confie em suposições, use a documentação oficial.

Aqui estão os principais recursos para começar:

• Guia do BSUID
  https://docs.ycloud.com/reference/bsuid
  → Abrange como o BSUID funciona, formato e uso em APIs
  
  

• Atualizações de Webhook (Campos BSUID)
  https://docs.ycloud.com/reference/webhook-updates-bsuid
  → Ajuda você a entender como o BSUID aparece nos payloads de webhook e quais mudanças na integração
  
  

• Documentação para Desenvolvedores do Meta (BSUID)
  https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids
  → Referência oficial sobre como o BSUID é introduzido e usado nas APIs do WhatsApp
  
  

Estas devem ser suas referências primárias ao atualizar seu sistema.

Concluindo!

Glossário

Aqui estão os termos-chave que você verá em webhooks e APIs, explicados de forma simples:

• contacts (novo array)
  Uma lista de usuários envolvidos na mensagem. Pense nisso como a "seção de informações do cliente" no webhook.
  

• profile
  Detalhes básicos sobre o usuário dentro de contacts.
  

• username
  Novo atributo. O nome de usuário do WhatsApp (se o usuário tiver ativado).
  Se o usuário não definiu um nome de usuário, este campo não aparecerá.
  
  

• wa_id
  Novo atributo. O número de telefone do usuário.
  Se o número de telefone estiver disponível, você o verá aqui.
  Se o usuário estiver usando um nome de usuário e o número não for compartilhado, isso pode estar ausente.
  
  
  

• user_id (BSUID)
  Novo atributo. O campo mais importante daqui para frente.
  Este é o BSUID, um ID único que representa o usuário para o seu negócio.
  Ele sempre estará presente e deve ser usado para identificar usuários quando o número de telefone não estiver disponível.
  
  
  

• parent_user_id
  Um BSUID de nível superior que pode funcionar em vários portfólios de negócios (se habilitado).
  A maioria das empresas não usará isso, a menos que gerenciem vários portfólios.
  
  

Forma simples de entender isso:

• wa_id → Número de telefone (pode ou não estar disponível)
• user_id → BSUID (sempre disponível, novo padrão)
• username → O que o usuário mostra publicamente