Como analisar possíveis impactos da evolução de IDs do WhatsApp nos fluxos do Builder/Studio 1 de junho de 2026 13:20 Atualizado Índice: Visão geral O que muda no formato das variáveis Como executar a análise no Builder/Studio Cenários que a análise identifica Como interpretar o relatório CSV O que significa cada nível de criticidade Boas práticas Limitações da análise Preciso corrigir os meus fluxos agora? FAQ Visão geralO 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áveisAtualmente essas variáveis retornam o identificador no seguinte formato:5599999990002@wa.gw.msging.netA 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.netFluxos 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/StudioA 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 identificaA 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 CSVO 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 criticidadeAltaIndica 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édiaIndica uso operacional ou indireto das variáveis, como armazenamento, trackings, eventos ou variáveis intermediárias. Necessário validar o comportamento esperado.BaixaIndica 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. FAQMeu 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 Usernames no WhatsApp: BSUID, novos IDs e impactos no Blip Documentação oficial da Meta sobre BSUIDs Blip Academy - Trilha de Usernames 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 BSUID - ID de contatos, metadata, endpoints e aplicabilidade no Blip [Beta] Envio Direto para Mensagens de Utilidade