Pular para o conteúdo principal

Atualização do canal WhatsApp - Usernames, BSUID e novos IDs

  • Atualizado

Índice:

  1. Introdução
  2. Cronograma
  3. Empresas - Como adotar ou reservar um username
  4. Contatos - Identificação de BSUID
    1. Visão geral
    2. Onde encontrar o BSUID - Metadata das mensagens
    3. Propriedades disponíveis
    4. Premissas
    5. Como extrair a informação do metadata
  5. Identificação interna de contatos no Blip
    1. Visão geral
    2. Evolução do campo contact.identity
    3. Ações necessárias e possíveis impactos
    4. Principais recomendações

Introdução

Conforme anunciado pela Meta recentemente, o modelo de identificação dos contatos no WhatsApp Business está evoluindo. Visando a privacidade de usuários, a Meta está introduzindo Usernames no WhatsApp. Documentação técnica oficial da Meta

A adoção de usernames é opcional tanto para o usuário final quanto para as empresas. Caso o usuário final adote um username, entretanto, seu número de telefone não será mais compartilhado, sendo exibido apenas o username e outros IDs técnicos relacionados. As empresas, porém, mesmo que tenham adotado o username, continuarão exibindo o número de telefone registrado em sua conta do WhatsApp. 

Além da introdução de usernames no WhatsApp, cada username é associado a um BSUID (Business-Scoped User ID), um identificador único entre o usuário e uma empresa específica que permite o envio de mensagens no WhatsApp mesmo quando o número de telefone do usuário não está disponível. Diferente do número de telefone, que é sempre o mesmo número independente da empresa com a qual aquele contato interage, o BSUID de um mesmo usuário será único e diferente para cada uma das empresas com que o contato interagir (baseado no Business Manager/Business Portfolio da empresa). 

 

Cronograma

  • Junho/2026: a funcionalidade de Usernames será liberada pela Meta para teste em alguns países

  • Julho/2026: rollout para uma segunda amostra de países de teste definidos pela Meta

  • Agosto/2026: expectativa de lançamento global em GA pela Meta

Todos os marcos descritos acima podem ser alterados previamente com base nas definições e diretrizes da própria Meta.

 

Empresas - Como adotar ou reservar um username

Assim como o usuário, a empresa também poderá adotar o uso de um username ou até mesmo reservar um username para suas contas de WhatsApp. Essa adoção, porém, ainda não está disponível. Atualizaremos essa documentação assim que possível para refletir esse processo.

 

Contatos - Identificação de BSUID

Visão geral

Todos os contatos, independente de adotarem um username ou não, passarão a vir com o novo identificador criado pela Meta para o WhatsApp, o BSUID. 

O número de telefone do contato/usuário final só será informado pela Meta nas interações B2C se:

  • O contato não tiver adotado username

  • O número de telefone do contato está registrado na Lista de Contato do business (feature lançada pela Meta em Abril/2026 e nativamente habilitada para registrar dados dos contatos que interagem com o business)

Onde encontrar o BSUID - Metadata das mensagens

O BSUID é disponibilizado pela Blip no metadata das mensagens (mensagens, notificações e ecos, em casos de ativações de Coexistência) e estará presente no objeto metadata de cada envelope (mensagens, notificações ou eco) desde que essas informações sejam enviadas ao Blip pela Meta/Whatsapp nos webhooks correspondentes.

Para consultar a informação do BSUID via metadata:

  1. Acesse o bot desejado no Portal

  2. Acesse o menu superior do Blip

  3. Clique no ícone de três pontos (...)

  4. Selecione a opção Log no menu

  5. Localize o objeto metadata dentro do envelope da mensagem

Propriedades disponíveis

Dentro do metadata, os identificadores estarão disponíveis através das seguintes propriedades:

  • #wa.bsuid: Identificador único do usuário (BSUID)

  • #wa.parentId: Identificador do usuário compartilhado entre diferentes empresas (quando aplicável)

Premissas

  • A propriedade #wa.parentId será incluída apenas nos casos em que a Meta autorizar essa feature para a empresa. Importante: o pedido de ativação do Parent ID deve ser feito pela empresa para a Meta através de chamado. 

  • Todos esses campos dependem da disponibilização por parte da Meta/Facebook; portanto, sua presença está condicionada aos dados recebidos pelo canal no Blip.

  • Essas informações permitem rastrear e interagir com usuários de forma consistente, mesmo sem acesso direto ao número de telefone.

 

Como extrair a informação do metadata

Para extrair essas informações, você deve definir duas ações de saída no bloco Início do Studio:

1. Definir variável de metadata

Defina uma variável com os seguintes parâmetros:

  • Nome da variável: metadata

  • Valor: {{input.message@metadata}}

 

2. Executar script

Execute um script para obter apenas o valor do #wa.bsuid presente neste metadata. Configuração do script:

function run(metadata){
metadata= JSON.parse(metadata);
return metadata["#wa.bsuid"];
}

Será apresentado o escopo do script, conforme imagem abaixo:

  • DICA! Utilize registro de eventos para engrandecer a captura de dados e torná-los mais apresentáveis a partir de relatórios personalizados.

     

Identificação interna de contatos no Blip

Visão geral

Visando minimizar o impacto para os nossos clientes, a Blip cria uma abstração que analisa os dados recebidos da Meta e realiza o relacionamento com um contato existente ou cria um novo contato quando necessário.

Com a evolução do modelo de identificação do WhatsApp, a Blip também está evoluindo a forma como os contatos são identificados na plataforma.

Evolução do campo contact.identity

Atualmente o campo contact.identity (disponível na biblioteca de variáveis do Blip) é preenchido com o número de telefone do usuário neste formato:

  • {phone_number}@wa.gw.msging.net

A partir de evolução prevista para o dia 1º de junho de 2026, considerando que o número de telefone pode não estar mais disponível, novos contatos serão criados com um ID próprio da Blip no formato::

  • {guid}@wa.gw.msging.net

O campo contact.identity, portanto, deixa de representar obrigatoriamente um número de telefone e passa a ser um ID interno da Blip. Contatos já existentes no Blip anteriormente ao dia 1º de junho não serão afetados.

Ações necessárias e possíveis impactos

É importante revisar sua operação no Blip para garantir que ela não dependa de um formato específico do campo contact.identity existente no Blip. Sugerimos o mapeamento principalmente em:

  • APIs, webhooks, bancos de dados e sistemas externos integrados ao Blip (CRM, ERP e etc)

  • Fluxos conversacionais no próprio Blip

  • Regras de negócio que utilizam o contact.identity (exemplo: logs, auditorias ou relatórios que assumem formato numérico)

Principais recomendações

  • Trate o contact.identity como um identificador genérico (string), sem assumir que é um número de telefone

  • Remova validações rígidas de formato (ex: regex de telefone)

  • Não o utilize como chave primária baseada em número de telefone

 

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