Passar para o conteúdo principal

Suporte para nome de usuário do WhatsApp: Mudanças na Wati

Resumo

O WhatsApp está introduzindo um recurso de Nome de Usuário que permite aos usuários ocultar seus números de telefone ao interagir com empresas. A partir de junho de 2026, alguns clientes podem optar por proteger sua privacidade exibindo apenas um nome de usuário em vez de seu número de telefone.

Para garantir que suas comunicações comerciais permaneçam ininterruptas, a Wati atualizou seu sistema para dar suporte ao novo identificador BSUID (ID de Usuário de Escopo Empresarial) da Meta.

Este artigo explica o que muda para você e como continuar enviando mensagens aos clientes sem interrupções.

Instruções

O que está mudando na Wati

Gerenciamento de Contatos:

  • Contatos do WhatsApp agora podem existir sem um número de telefone

  • O BSUID (um identificador exclusivo) é armazenado automaticamente quando os contatos enviam mensagens para você

  • Contatos duplicados são mesclados quando um número de telefone se torna disponível posteriormente

  • Você pode exportar seus contatos com o novo campo BSUID

  • A importação manual ainda requer um número de telefone

Observação: Atualmente, contatos apenas com BSUID não são sincronizados devido a limitações em sistemas externos de CRM. Para dar suporte à compatibilidade futura, recomendamos armazenar opcionalmente o BSUID como um campo personalizado em seu CRM.

Transmissões e Campanhas:

  • Envie campanhas tanto para contatos com número de telefone quanto para contatos apenas com BSUID

  • Ao enviar, a Wati garante que as mensagens vão apenas para contatos alcançáveis pelo seu número de WhatsApp selecionado

Observação: Os usuários do aplicativo móvel Wati devem atualizar para a versão 3.43.0 ou superior para suportar a alteração do BSUID. Se o aplicativo não for atualizado, algumas conversas podem não aparecer na caixa de entrada.

Caixa de Entrada da Equipe:

  • Veja o nome de exibição do contato, nome de usuário do WhatsApp ou BSUID quando o número de telefone estiver oculto

  • Continue atendendo chamadas para usuários com privacidade protegida

Automação:

  • Fluxos de trabalho agora funcionam com contatos que não têm número de telefone (apenas BSUID)

  • Ações que requerem número de telefone (como fallback de SMS/RCS) pularão contatos apenas com BSUID

Anúncios CTWA:

  • Os fluxos de Clique para WhatsApp continuam funcionando mesmo quando o número de telefone de um usuário está oculto

O que não está mudando

  • Seus fluxos de trabalho existentes baseados em número de telefone continuam funcionando

  • Você ainda pode enviar campanhas usando números de telefone

  • A cobrança permanece consistente - o código do país é derivado do prefixo BSUID

Limitações Importantes

Tipo de Mensagem

Contatos Apenas com BSUID

Mensagens regulares

✅ Suportado

Modelos de autenticação (one-tap, zero-tap, copiar código)

❌ Não suportado

Por quê? Esses modelos exigem um número de telefone para entrega.

Fallback de SMS/RCS: Não disponível para contatos apenas com BSUID porque o fallback requer um número de telefone.

Como resolver isso

Use o botão Solicitar Informações de Contato em modelos de Utilidade/Marketing. Este recurso permite que as empresas solicitem o número de telefone de um cliente usando o botão Solicitar Informações de Contato em modelos de Utilidade e Marketing do WhatsApp. Quando um cliente compartilha suas informações de contato, a Wati as recebe e as mapeia automaticamente para o contato BSUID correspondente no CRM.

Observação: O botão Solicitar Informações de Contato não é compatível com modelos de autenticação.

O que você deve saber: A janela de 30 dias

Quando um usuário habilita a proteção de nome de usuário, o Meta fornece seu número de telefone apenas durante conversas ativas. Se não houver interação por 30 dias consecutivos, o Meta pode parar de retornar o número de telefone.

A Wati protege você: No momento em que a Wati captura um número de telefone durante uma conversa ativa, ele é salvo permanentemente no seu registro de contato - mesmo que a janela do Meta expire posteriormente.

Reidentificação: Se um usuário "oculto" entrar em contato com você novamente após 30 dias de silêncio, a Wati usa o BSUID para vincular automaticamente suas mensagens ao perfil de contato original.

Como se preparar para a mudança do BSUID

  • Integre o novo identificador antecipadamente - Atualize seus sistemas e fluxos de trabalho internos para suportar o novo identificador, para que o envio de mensagens continue funcionando sem problemas após a introdução dos nomes de usuário.

  • Atualize suas integrações - Se plataformas conectadas como Shopify, HubSpot ou Salesforce atualmente dependem apenas de números de telefone como identificadores, verifique se elas suportam BSUID.

  • Revise fluxos de trabalho que dependem de números de telefone - Audite suas automações, integrações e sistemas conectados para identificar áreas que podem ser afetadas quando os números de telefone não estiverem disponíveis.

  • Atualize chatbots e fluxos de automação - Se seus fluxos de trabalho exigirem números de telefone, configure seus chatbots para solicitar proativamente aos usuários que compartilhem seus números de telefone quando necessário.

  • Revise modelos de autenticação - Se você usa fluxos de autenticação one-tap ou zero-tap, planeje estratégias de mensagens alternativas para usuários que optam por ocultar seus números de telefone.

  • Verifique exportações de contatos - Verifique se o BSUID está incluído em seus dados de contato exportados.

Suporte de Webhook para a alteração do BSUID

Os webhooks suportados por BSUID seguem um contrato com prioridade para BSUID. Nesses webhooks,

bsuid está sempre incluído e deve ser usado como o identificador primário do usuário.

O `waId` (número de telefone) é opcional e pode não estar presente em todas as cargas úteis de webhook.

Para garantir a compatibilidade com usuários que optam por ocultar seu número de telefone, sua integração deve identificar e rastrear usuários usando o `bsuid` em vez de depender de números de telefone.

Os seguintes webhooks suportam BSUID:

  • Mensagem Recebida (BSUID)

  • Nova Mensagem de Contato (BSUID)

  • Mensagem de Sessão Enviada (BSUID)

  • Mensagem de Sessão Enviada v2 (BSUID)

  • Modelo de Mensagem Enviada (BSUID)

  • Modelo de Mensagem Enviada v2 (BSUID)

  • Chatbot Acionado (BSUID)

  • Botão CTA Clicado (BSUID)

  • Status da Chamada (BSUID)

Para saber mais sobre webhooks suportados por BSUID, consulte nossa documentação para desenvolvedores.

Referência Rápida

Cenário

Número de Telefone Disponível

Apenas BSUID

Enviar campanha

✅ Sim

✅ Sim

Fallback de SMS/RCS

✅ Sim

❌ Não

Modelos de autenticação

✅ Sim

❌ Não

Pesquisar contato

✅ Sim

❌ Não

Gatilhos de automação

✅ Sim

✅ Sim

Chamadas do WhatsApp

✅ Sim

✅ Sim

Por que o mascaramento de número é diferente dos Nomes de Usuário e BSUID do WhatsApp

Os Nomes de Usuário e o Mascaramento de Número do WhatsApp resolvem desafios de privacidade diferentes e podem funcionar juntos.

Nomes de Usuário e BSUID do WhatsApp

  • Controlado pelo cliente.

  • Aplica-se apenas quando um cliente opta por usar um nome de usuário do WhatsApp em vez de compartilhar seu número de telefone.

  • Nesses casos, a empresa pode receber um BSUID em vez do número de telefone do cliente.

  • Se o cliente optar posteriormente por compartilhar seu número de telefone, a empresa ainda poderá acessá-lo e armazená-lo.

  • Contatos existentes que já possuem números de telefone não são afetados.

Mascaramento de Número

  • Controlado pela empresa.

  • Aplica-se a números de telefone que já existem em sua conta Wati.

  • Impede que operadores selecionados visualizem números de telefone de clientes dentro da Wati.

  • Ajuda as empresas a restringir o acesso a dados confidenciais de clientes, independentemente de como o número de telefone foi coletado originalmente.

Exemplo

Um cliente pode:

  • Enviar mensagens para sua empresa usando um nome de usuário do WhatsApp e, inicialmente, manter seu número de telefone privado.

  • Posteriormente, compartilhar seu número de telefone durante uma conversa, processo de pedido, solicitação de suporte ou fluxo de qualificação de leads.

Assim que o número de telefone estiver disponível na Wati, o Mascaramento de Número determinará se seus operadores podem visualizar esse número de telefone.

Por esse motivo, os Nomes de Usuário do WhatsApp não substituem o Mascaramento de Número. Os nomes de usuário controlam se um número de telefone é inicialmente compartilhado com uma empresa, enquanto o Mascaramento de Número controla quem dentro da empresa pode ver os números de telefone que já estão disponíveis.

Perguntas Frequentes (FAQs)

Geral

1. O que é BSUID?

BSUID (Business-Scoped User ID) é um identificador exclusivo fornecido pelo Meta para usuários do WhatsApp. A Wati armazena automaticamente o BSUID quando um cliente envia uma mensagem para sua empresa e o utiliza para identificar contatos mesmo quando seus números de telefone estão ocultos.

2. Um contato do WhatsApp pode existir sem um número de telefone na Wati?

Sim. A Wati suporta contatos que possuem apenas um BSUID e nenhum número de telefone.

Mensagens e Gerenciamento de Contatos

3. Posso enviar campanhas para contatos que possuem apenas um BSUID?

Sim. A Wati suporta o envio de campanhas tanto para contatos com número de telefone quanto para contatos apenas com BSUID.

4. Posso importar contatos manualmente usando apenas um BSUID?

Não. A importação manual de contatos ainda requer um número de telefone.

5. Posso enviar modelos de autenticação para contatos apenas com BSUID?

Não. Modelos de autenticação, incluindo modelos one-tap, zero-tap e copiar código, exigem um número de telefone e não são suportados para contatos apenas com BSUID.

6. Como posso coletar um número de telefone de um contato apenas com BSUID?

Você pode usar o botão Solicitar Informações de Contato em modelos de Utilidade ou Marketing do WhatsApp. Quando o cliente compartilha suas informações de contato, a Wati mapeia automaticamente o número de telefone para o contato BSUID existente.

Caixa de Entrada, Automação e Integrações

7. Fluxos de trabalho de automação podem funcionar com contatos apenas com BSUID?

Sim. Os fluxos de trabalho de automação da Wati suportam contatos que possuem apenas um BSUID. No entanto, ações que requerem um número de telefone, como fallback de SMS ou RCS, são ignoradas para contatos apenas com BSUID.

8. Qual identificador as integrações devem usar para o suporte do Nome de Usuário do WhatsApp?

As integrações devem usar o `bsuid` como identificador primário, pois os números de telefone podem não estar sempre disponíveis. O campo `waId` (número de telefone) é opcional e pode não estar presente em todas as cargas úteis de webhook.

Privacidade e Mascaramento de Número

9. Qual é a diferença entre Nomes de Usuário do WhatsApp e Mascaramento de Número?

Os Nomes de Usuário do WhatsApp são controlados pelo cliente e determinam se um número de telefone é inicialmente compartilhado com uma empresa. O Mascaramento de Número é controlado pela empresa e determina se os operadores podem visualizar números de telefone que já existem na Wati.

10. O que acontece se um cliente com número de telefone oculto entrar em contato com minha empresa novamente após 30 dias?

Se um cliente entrar em contato com sua empresa novamente após 30 dias de inatividade, a Wati usa o BSUID do cliente para reconectar automaticamente as novas mensagens ao perfil de contato original. Se a Wati capturou anteriormente o número de telefone do cliente durante uma conversa ativa, esse número de telefone permanece armazenado no registro de contato.

Respondeu à sua pergunta?