Índice:

1. Visão geral
   1. O que evolui e o que não muda
   2. Conhecendo os novos IDs
2. Cronograma geral de Usernames: Meta + Blip
3. Por que se preparar agora?
4. Impactos por área
5. Usernames no Blip: artigos técnicos relacionados
6. Changelog/Registro de alterações

⚠️ IMPORTANTE

As funcionalidades, nomenclaturas, cronogramas e comportamentos descritos neste material podem evoluir ao longo do rollout conduzido pela Meta e pela Blip. Esta documentação será atualizada continuamente conforme novas definições forem disponibilizadas. Consulte o changelog para entender o que e quando foi alterado.

Visão geral

O modelo de identificação de usuários no WhatsApp Business está evoluindo.

Com a introdução de usernames no WhatsApp pela Meta, usuários poderão interagir com empresas sem necessariamente compartilhar seu número de telefone em todas as interações. Essa mudança introduz novos identificadores técnicos no ecossistema, como o BSUID (Business-Scoped User ID), e impacta diretamente operações conversacionais, integrações, automações e estratégias de relacionamento historicamente construídas sobre o número de telefone.

O BSUID é único por relação usuário ↔ empresa: o mesmo usuário terá BSUIDs diferentes para cada empresa com que interagir (com base no Business Manager/Business Portfolio). Ao contrário do número de telefone, que é global e imutável, o BSUID é contextual e restrito ao escopo de cada negócio.

No Blip, essa evolução também traz mudanças na forma como contatos são identificados internamente na plataforma, bem como alterações em variáveis de fluxo, APIs, envio de mensagens ativas e interfaces do Portal e Desk.

IMPORTANTE! O telefone não desaparece e não é desabilitado, ele deixa de ser uma premissa universal nas interações do WhatsApp.

O que evolui e o que não muda

Conhecendo os novos IDs

Conheça os principais identificadores usados no WhatsApp e como cada um se comporta no novo modelo de identidade do WhatsApp!

Cronograma geral de Usernames: Meta + Blip

⚠️Datas, fases e marcos apresentados refletem o roadmap atual compartilhado pela Meta e podem sofrer alterações ao longo da evolução do rollout.

Por que se preparar agora?

O rollout da Meta será gradual e iniciará em países específicos antes de chegar ao Brasil. Isso significa que, a partir de junho/2026, usuários dessas regiões já podem iniciar conversas com qualquer empresa sem compartilhar o PN, exigindo que o Blip suporte imediatamente os novos IDs e o formato {guid}@wa.gw.msging.net.

O risco mais perigoso da transição não gera erro visível: o usuário não desaparece, mas seu contexto histórico pode se fragmentar silenciosamente. Sistemas podem continuar funcionando enquanto a integridade da identidade se degrada.

Quanto mais cedo o mapeamento de usuários entre PN e BSUID for realizado, maior a chance de preservar histórico, continuidade e integridade operacional. Saiba como se preparar.

Durante a transição ainda é possível receber e conciliar phone number e BSUID de um mesmo usuário nas interações.

Impactos por área

Artigos relacionados

• Evolução da identificação dos contatos no Blip + possível impacto no uso das variáveis contact.identity, tunnel.originator e tunnel.identity a partir de 1º de junho de 2026
• Mapeamento de riscos no Portal Blip: como analisar possíveis impactos da evolução de IDs do WhatsApp nos fluxos do Builder/Studio
• BSUID - ID de contatos, metadata, endpoints e aplicabilidade no Blip
  • Endpoint de consulta PN ↔ BSUID - Documentação técnica
• Envio de mensagens ativas com BSUID
• Novas variáveis do Builder/Studio
• Username empresarial - Adoção no Blip e boas práticas
• Como se preparar para o novo modelo de identidade do WhatsApp

Changelog - Registro de alterações na documentação

2026

1º de junho

• Reestruturação da documentação em formato de Hub de Usernames
• Adicionados novos artigos dedicados sobre:
  • Evolução da identificação de contatos no Blip
  • Como analisar possíveis impactos da evolução de IDs do WhatsApp nos fluxos do Builder/Studio
  • BSUID - ID de contatos, metadata, endpoints e aplicabilidade no Blip
  • Envio de mensagens ativas com BSUID
  • Novas variáveis do Builder/Studio
  • Usernames empresariais
• Adicionada visão consolidada dos novos IDs do ecossistema WhatsApp (PN, BSUID, Parent BSUID, Username e GUID Blip)
• Adicionadas orientações sobre impactos operacionais, riscos técnicos e estratégias de preparação
• Inclusão da seção de changelog (visibilidade de alterações na doc)
• Inclusão da página de roadmap de usernames no Blip

30 de abril

• Atualizado o artigo original com detalhamento técnico sobre BSUID e evolução dos IDs no WhatsApp
• Adicionadas informações sobre:
  • BSUID no metadata das mensagens
    • Propriedades #wa.bsuid e #wa.parentId
    • Exemplos de consulta e extração no Builder/Studio
  • Evolução do campo contact.identity
  • Impactos em fluxos, APIs e integrações
  • Recomendações técnicas para adaptação
• Adicionados alertas sobre dependência de split e parsing de phone number nas variáveis de ID do contato

10 de março

• Primeira publicação da documentação sobre evolução da identificação de contatos no WhatsApp.
• Introdução aos conceitos de username e BSUID.
• Publicado cronograma inicial da Meta.
• Publicadas primeiras orientações sobre identificação de contatos no Blip.

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 😃