Encontre a resposta que está procurando

Nomes de usuário do WhatsApp: o que você precisa saber

Esta função do WhatsApp permite que os usuários usem um nome de usuário em vez de compartilhar seu número de telefone ao iniciar conversas. 

A mudança impacta diretamente a forma como as empresas identificam e se comunicam com seus clientes. 

✅ O que são os nomes de usuário do WhatsApp?
● Os nomes de usuário são identificadores únicos no formato @NomeDeUsuario que as pessoas podem adotar de forma opcional.
● Ao fazer isso, seu número de telefone deixa de ser compartilhado automaticamente com as empresas, o que lhes dá maior controle sobre suas informações pessoais.
● Para as empresas, isso representa tanto uma oportunidade quanto uma mudança operacional importante, para a qual devem se preparar.

↗️ O que muda? 

  1. Novo identificador de cliente:
    1. Quando um usuário adota um nome de usuário, as empresas que usam a API do WhatsApp receberão um novo identificador de backend chamado BSUID (Business-Scoped User ID — identificador de usuário) em vez do número de telefone. 
    2. O BSUID tem o seguinte formato: `US.13491208655302741918` (código de país ISO + identificador alfanumérico único).
    3. Características-chave do BSUID:- 
      1. Único por negócio: são únicos para cada par de portfólio comercial e usuário (os portfólios comerciais eram anteriormente chamados de "gerenciadores de negócios"). Duas empresas distintas verão identificadores diferentes para o mesmo usuário. Ou seja, o mesmo usuário terá um BSUID diferente para cada empresa com a qual interagir. 
      2. Gerado automaticamente: não requer nenhuma ação do usuário nem da empresa. 
      3. Sempre presente: chega em todos os webhooks, independentemente de o usuário ter ou não um username ativo. 
      4. Regenerado se o número mudar: se o usuário trocar de telefone, um novo BSUID é gerado.  
  2. Número de telefone oculto por padrão: se um cliente adota um nome de usuário, seu número de telefone não estará visível, exceto nos cenários listados em ➡ Casos em que o número de telefone continua acessível.

 ↗️Casos em que o número de telefone continua acessível: Mesmo que um usuário ative um nome de usuário, seu número de telefone continuará incluído nos webhooks se uma destas condições for atendida: 

  1. Interação recente (30 dias): se já houve uma conversa anterior com esse número, ele continuará sendo compartilhado por um período de 30 dias consecutivos a partir da última interação. Avaliado por número de negócio. 
  2. Contact Book (Agenda de contatos): o usuário está na agenda de contatos do portfólio de negócio. A Meta lança essa funcionalidade em abril de 2026 e armazena automaticamente a relação telefone-BSUID após cada interação.
  3. Envio proativo pelo Engage: se um template for enviado usando o telefone do usuário no campo "to", a resposta sempre incluirá o telefone. As mensagens de autenticação continuam sendo enviadas exclusivamente para números de telefone.
  4. O usuário não adotou um nome de usuário: sem mudanças, o número continua visível como sempre.

↗️ Quais ações sua empresa deve tomar? 

  1. Planejar a adoção do BSUID nos sistemas da sua empresa. Integre o BSUID aos seus sistemas para continuar recebendo e gerenciando mensagens de usuários que adotem nomes de usuário.
  2. Auditar o CRM e os fluxos de trabalho para identificar onde o número de telefone é usado como identificador único no WhatsApp e adicionar suporte ao BSUID.
    1. Adicione um campo adicional no perfil do cliente para o BSUID, junto aos campos existentes (número de telefone, e-mail, etc.)
    2. Revise e atualize os sistemas de medição, assistente virtual e campanhas de mensagens ativadas que dependam do número de telefone.
  3. Atualizar a experiência do assistente virtual e os fluxos de mensagens. Se o número de telefone for necessário para sua operação, atualize seus fluxos para solicitá-lo de forma proativa aos usuários que adotarem um nome de usuário. O WhatsApp oferece um fluxo nativo para facilitar esse processo e minimizar erros.
  4. Reivindicar o nome de usuário da sua empresa. As empresas também podem adotar seu próprio nome de usuário do WhatsApp Business. Embora seja opcional, isso facilita que os clientes as encontrem e reconheçam com facilidade. O WhatsApp está reservando nomes com base em:  
    1. Nomes visíveis do WhatsApp ou contas de empresa oficiais (OBA).
    2. Nomes verificados pela Meta.
    3. Nomes de usuário comerciais do Facebook ou Instagram (quando aplicável).
  5. Realizar testes do BSUID com o acompanhamento da nossa equipe de Serviços Profissionais para garantir o funcionamento correto antes da implantação dessa mudança.

↗️ Considerações para o nome de usuário de empresa 

  • Mínimo de 3 caracteres, máximo de 35.
  • Apenas letras [a-z], números [0-9], pontos e underscores. Espaços não são permitidos.
  • Não pode começar nem terminar com ponto, nem conter pontos consecutivos.
  • Não pode começar com `www.` nem terminar com extensões como `.com`, `.org`, `.net`, entre outras.
  • É possível ter um nome de usuário por número de telefone.

⚠️  Quais fluxos são interrompidos se você não se preparar? Se a empresa não adotar o novo BSUID e um cliente com nome de usuário tentar contatá-la, os seguintes fluxos serão interrompidos:

  1. Recebimento de mensagens originadas de anúncios de clique para WhatsApp.
  2. Recebimento de mensagens de serviço.
  3. Fluxos Studio: veja a seção > Impacto em produto e soluções > Cenários de impacto em integrações.
ℹ️ As mensagens iniciadas pela empresa para números de telefone conhecidos e as mensagens de autenticação não serão afetadas.
✏️ A partir de junho de 2026, as empresas que usam a API podem reivindicar seu nome de usuário com antecedência pelo WhatsApp Manager, Meta Business Suite, a Cloud API ou o aplicativo WhatsApp Business. O nome reivindicado será ativado quando a função estiver disponível no país correspondente.

↗️Impacto em produto e soluções 

Impacto Solução
Virtual Assistant: o webhook do WhatsApp não garante mais o número de telefone para usuários com username ativo.
Identificador do usuário: o webhook não garante mais o telefone. O BSUID é entregue como identificador principal.
 BSUID como user_id` nativo. A plataforma VA processará o BSUID como identificador de sessão, sem necessidade de transformação.
Extração de telefone em fluxos Studio. Os fluxos que extraem o telefone do `user_id` atual deixarão de funcionar. Compatibilidade com telefone: se o webhook incluir o telefone, o número e o país do usuário serão armazenados em `user-data
Lógica de identidade no engine. O motor gerencia a correlação entre sessões usando o identificador recebido. Com o BSUID, essa correlação muda.
 Sem impacto na maioria dos fluxos. Os fluxos que não dependem do telefone continuam funcionando sem alterações.

Live (contact centers): o webhook do WhatsApp não garante mais o número de telefone. O BSUID é entregue como identificador principal quando o usuário tem username ativo.
Identificador do usuário: o webhook não garante mais o telefone. O BSUID é entregue como identificador principal.
 BSUID como `user_id` nativo. A plataforma Live processará o BSUID como identificador de sessão, sem necessidade de transformação.
Campo de usuário `phone` sem conteúdo. Para usuários que adotaram username, o campo `phone` disponível para os Agentes ficará vazio.
 Solicitar o número de telefone ao usuário: Quando necessário, recomendamos incorporar a opção para os Agentes solicitarem ao usuário que compartilhe seu número de telefone pelo envio de um template com o botão "Compartir Contacto".

Engage (envios proativos): os envios proativos de templates exigem um identificador de destino. Até agora, sempre se usava o número de telefone nesse campo.
Campo "to" em envios proativos.** Os envios proativos de templates exigem um identificador de destino. Até agora, usava-se o telefone.
 Suporte a BSUID no campo "to" do Engage: aceita o BSUID ou o número de telefone indistintamente como valor válido do campo "to" ao enviar templates.
Usuários sem telefone na base de dados. Se o cliente tem usuários que só interagiram com username ativo, pode ser que nunca tenham gerado sessão com telefone.
 Audiências mistas: Engage suporta o carregamento de audiências mistas  números de telefone misturados com `user_ids`para campanhas one-time.

Resposta ao proativo: garante o telefone. Quando o Engage envia um template com telefone no campo "to", a resposta do usuário sempre incluirá o telefone.  
Nova funcionalidade: botão `REQUEST_CONTACT_INFO`  A Meta apresenta um novo tipo de botão para templates do tipo utility e marketing que permite solicitar o número de telefone ao usuário de forma segura e verificada. Disponível a partir de maio de 2026.
1. A empresa envia um template message com o botão `REQUEST_CONTACT_INFO`.
2. O usuário pressiona o botão e o WhatsApp compartilha automaticamente seu número real e verificado.
3. Chega um webhook do tipo "contacts" com o telefone do usuário, pronto para uso. O telefone é adicionado automaticamente à Contact Book.
IVR to WhatsApp O IVR tem o número de telefone do usuário, por isso pode continuar enviando o template para esse número e nas interações seguintes continuaremos recebendo o número automaticamente.

Cenários de impacto em integrações
Formulários Self-Service e pré-derivação
 São formulários configurados pela plataforma do assistente virtual ou com a equipe de Suporte, sem lógica no Studio. O telefone do usuário era incluído automaticamente ao enviá-los.
O telefone deixa de chegar automaticamente. Não há lógica intermediária para gerenciar um fallback.
 Adicionar manualmente um campo "telefone" no formulário para que o usuário o preencha.
Nota: o dado inserido não tem validação automática. Se for necessária verificação, deve-se criar uma integração customizada no Studio.
Fluxos Studio com endpoints Engageware
 Alguns fluxos no Studio extraem o telefone do identificador do usuário para chamar serviços internos da Engageware
O identificador do usuário não conterá mais o telefone. As técnicas de extração atuais deixarão de funcionar porque o formato do BSUID é completamente diferente.
 Usar diretamente o BSUID como identificador do usuário em vez do telefone. As APIs da Engageware aceitarão esse novo identificador
Fluxos Studio com serviços externos
 Alguns fluxos extraem o telefone e o enviam para APIs de clientes ou serviços de terceiros que precisam do número real. O BSUID não é válido para esses serviços
Opção A (recomendada): enviar um template com o botão `REQUEST_CONTACT_INFO` da Meta. Ao pressioná-lo, o WhatsApp compartilha automaticamente o telefone verificado do usuário. Pode implicar um custo adicional por template.
Opção B: pedir ao usuário que informe seu número manualmente por meio de um formulário no fluxo do bot. Não é seguro para autenticação; se o telefone for usado para verificar identidade, deve-se adicionar um segundo fator (OTP, usuário+senha, biometria, etc.).

↗️ O que não muda? 

  1.  Os números de telefone continuam fazendo parte do funcionamento do WhatsApp.
  2.  As empresas que já têm os números de seus clientes não os perdem e podem continuar usá-los.
  3.  As mensagens iniciadas pela empresa para números conhecidos continuam funcionando normalmente.
  4.  As mensagens de autenticação não são afetadas.

↗️ Mais informações: Para consultar a documentação técnica oficial, acesse diretamente o site da Meta.

Este site armazena cookies em seu computador. Estes cookies são utilizados para coletar informações de como você interage com o nosso site e nos permite lembrar de você. Nós usamos essa informação para melhorar e personalizar sua experiência de navegação e para obter estatísticas e métricas sobre nossos visitantes, tanto neste site quanto em outros meios. Para obter mais informações sobre os cookies que utilizamos, consulte nossa Política de Privacidade.

Se você recusar, sua informação não será rastreada quando você visitar este site. Será utilizado somente um cookie em seu navegador para lembrá-lo de sua preferência de não ser rastreado.