Como analisar possíveis impactos da evolução de IDs do WhatsApp nos fluxos do Builder/Studio – Blip | Blip Help

Índice:

Visão geral

O WhatsApp está evoluindo seu modelo de identificação de usuários com a introdução de Usernames e novos identificadores. Com essa mudança o número de telefone pode deixar de ser compartilhado automaticamente em algumas interações. Nesse cenário, algumas variáveis do Blip utilizadas em fluxos do Builder/Studio podem assumir um novo formato de identificador, deixando de conter exclusivamente o número de telefone.

Para apoiar a adaptação dos fluxos, disponibilizamos no Blip uma funcionalidade de análise automática que identifica usos das seguintes variáveis:

contact.identity
tunnel.originator
tunnel.identity

Importante: a análise sinaliza dependências potenciais, mas não significa necessariamente que o fluxo irá quebrar. O risco principal está em operações que assumem que essas variáveis sempre conterão um número de telefone.

O que muda no formato das variáveis

Atualmente essas variáveis retornam o identificador no seguinte formato:

5599999990002@wa.gw.msging.net

A partir de 1º de junho de 2026 e nos casos em que o número de telefone do usuário não for compartilhado pela Meta o formato passará a ser:

e4b11bdd-a9bf-46ad-a9b0-34116dece5fe@wa.gw.msging.net

Fluxos que extraem o número de telefone diretamente desse valor - por exemplo, via contact.identity.split("@")[0] - precisarão ser revisados.

Como executar a análise no Builder/Studio

A funcionalidade está disponível diretamente no Builder/Studio, dentro do fluxo a ser analisado.

Acesse o Builder/Studio do fluxo desejado
No banner exibido na parte superior, clique no link Analisar fluxo
Aguarde o processamento automático
Revise os blocos destacados visualmente no fluxo
[Opcional] Clique em Baixar relatório para obter o CSV detalhado

Os blocos destacados indicam que alguma ação utiliza variáveis potencialmente impactadas e exige validação e/ou alteração manual.

Observação: se nenhum bloco usar as variáveis analisadas, o banner ficará verde, indicando que nenhuma ação é necessária no momento.

Cenários que a análise identifica

A varredura sinaliza usos das variáveis em contextos como:

Extração do número de telefone (ex: split("@")[0])
Scripts personalizados e chamadas HTTP
Integrações externas com CRMs, ERPs e outros sistemas que recebem ou armazenam o valor como número de telefone
Parsing de identificadores e regras condicionais
Armazenamento do identificador como chave operacional em sistemas terceiros

Como interpretar o relatório CSV

O relatório disponível para download contém uma linha por ação identificada, com as seguintes colunas:

Coluna	Descrição
Block Name	Nome do bloco identificado no fluxo
Block ID	Identificador técnico do bloco
Action Name	Nome da ação encontrada
Action ID	Identificador da ação
Action Type	Tipo da ação utilizada
VariableName	Variável identificada (contact.identity, tunnel.originator ou tunnel.identity)
Criticality	Grau de criticidade potencial (alta, média ou baixa)
Router context enabled	Indica se o contexto de roteador está habilitado para aquele bloco

O que significa cada nível de criticidade

Alta

Indica alta probabilidade de dependência do número de telefone. Associada geralmente a scripts, chamadas HTTP, parsing ou manipulação direta do identificador. Revisão prioritária recomendada.

Média

Indica uso operacional ou indireto das variáveis, como armazenamento, trackings, eventos ou variáveis intermediárias. Necessário validar o comportamento esperado.

Baixa

Indica baixo risco imediato de impacto operacional. Revisão opcional e preventiva.

Boas práticas

Trate contact.identity, tunnel.originator e tunnel.identity como strings genéricas, não assuma que o valor sempre será um número de telefone
Revise integrações externas que consumam essas variáveis como identificador fixo

Limitações da análise

A análise NÃO substitui a validação e a correção manual do fluxo
Alguns cenários personalizados podem não ser detectados automaticamente
O relatório representa o estado do fluxo no momento em que a análise foi executada, as alterações não são refletidas no relatório automaticamente. Execute a análise novamente após alterações para um relatório atualizado.

Preciso corrigir os meus fluxos agora?

Não necessariamente. O impacto ocorre especificamente em interações com usuários que não compartilharem o número de telefone, o que acontece quando adotam um username no WhatsApp. Usuários sem username não serão afetados.

A recomendação é realizar a validação preventiva dos fluxos, priorizando os sinalizados com criticidade alta e tendo em mente que, de acordo com o cronograma da Meta, a disponibilidade geral de usernames deverá acontecer em todos os países já em agosto de 2026.

FAQ

Meu fluxo foi sinalizado. Isso significa que ele vai quebrar?
Não. A análise identifica dependências potenciais que precisam ser validadas manualmente. Um fluxo sinalizado pode funcionar normalmente dependendo de como a variável é utilizada.

A análise altera meu fluxo automaticamente?
Não. A análise é somente uma ferramenta de diagnóstico. Nenhum bloco, script, variável ou integração é alterado automaticamente pelo Blip. As evoluções precisam ser feitas manualmente pelo responsável pelo fluxo.

Meu fluxo não foi sinalizado. Estou 100% preparado?

Não necessariamente. A análise cobre os principais usos das variáveis dentro do Builder/Studio, mas integrações externas, bancos de dados e sistemas conectados também devem ser revisados.

Posso ignorar os alertas?
Depende da lógica implementada. Recomenda-se revisar especialmente scripts, integrações, chamadas HTTP e qualquer uso que presuma o telefone como identificador fixo.

Saiba mais

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 😃