Pular para o conteúdo principal

Como se preparar para o novo modelo de identidade no WhatsApp e no Blip

  • Atualizado

Índice

  1. Visão geral
  2. Checklist geral de preparação por área de impacto
  3. Passo a passo sugerido
    1. Analise seus fluxos
    2. Enriqueça sua base de contatos de PN com o BSUID correspondente
    3. Prepare novas implementações

  4. FAQ

     

Visão geral

A transição para usernames representa uma evolução do modelo de identidade do WhatsApp: o telefone continua existindo, mas deixa de ser a única referência possível para identificar usuários. Para garantir continuidade de histórico, integrações e automações, recomendamos revisar os principais pontos abaixo.

 

Checklist geral de preparação por área de impacto

Passo 1 - Analise seus fluxos

Utilize a análise automática disponível no Builder/Studio para encontrar possíveis dependências das variáveis contact.identity, tunnel.originator e tunnel.identity.

Sugerimos que priorize:

  1. Scripts personalizados
  2. Chamadas HTTP
  3. Integrações externas
  4. Manipulação direta do identificador do contato
     

Passo 2 - Enriqueça sua base de contatos de PN com o BSUID correspondente

Durante o período de transição:

  • Preserve os números de telefone existentes em sua base
  • Capture o BSUID sempre que disponível
  • Mantenha relacionamento entre diferentes identificadores do mesmo usuário.

Evite substituir um identificador pelo outro, implementando o suporte a múltiplos IDs.
 

Passo 3 - Prepare novas implementações

Para novos fluxos e integrações:

✅ Faça:

  • Tratar identificadores como texto
  • Consultar campos específicos para cada necessidade
  • Considerar possível ausência de telefone

❌ Evite:

  • Extrair telefone das variáveis contact.identity, tunnel.originator e tunnel.identity usando split
  • Validar usuário assumindo formato numérico
  • Usar telefone como única chave permanente


Usernames - FAQ Geral

O telefone vai deixar de existir no WhatsApp?

Não. Toda conta WhatsApp continuará vinculada a um telefone. A mudança é que o número pode deixar de ser compartilhado automaticamente em algumas interações.

Todos os meus contatos vão mudar em junho?

Não. A adoção será gradual conforme rollout da Meta e adoção de usernames pelos usuários.

O que acontece com contatos antigos?

Contatos existentes continuam funcionando normalmente. Durante a transição, o Blip manterá estratégias de compatibilidade e associação entre identificadores quando possível.

O que é BSUID?

É um identificador criado pela Meta para representar a relação entre um usuário e uma empresa específica.

O mesmo usuário pode possuir BSUIDs diferentes ao conversar com empresas diferentes.

Posso substituir telefone por BSUID em tudo?

Não necessariamente.

Cada identificador possui uma finalidade:

  • telefone → contato quando disponível;

  • BSUID → relação usuário + empresa no WhatsApp;

  • ID interno Blip → identificação do contato dentro da plataforma.

Preciso alterar todos os meus fluxos imediatamente?

Não necessariamente.

A recomendação é revisar fluxos que dependem do telefone como identificador fixo, principalmente:

  • scripts;

  • integrações externas;

  • CRMs;

  • regras condicionais.

O endpoint PN → BSUID busca informações diretamente na Meta?

Não. Ele retorna somente relações já conhecidas e armazenadas pela Blip.

Meu endpoint não retornou BSUID para um telefone. Isso é erro?

Não necessariamente. Pode significar apenas que aquele usuário ainda não teve uma interação onde o BSUID foi recebido e associado pela plataforma.

 


Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃

Artigos relacionados