Atualização do canal WhatsApp - Usernames, BSUID e novos IDs 30 de abril de 2026 12:44 Atualizado Índice: Introdução Cronograma Empresas - Como adotar ou reservar um username Contatos - Identificação de BSUID Visão geral Onde encontrar o BSUID - Metadata das mensagens Propriedades disponíveis Premissas Como extrair a informação do metadata Identificação interna de contatos no Blip Visão geral Evolução do campo contact.identity Ações necessárias e possíveis impactos Principais recomendações IntroduçãoConforme 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 MetaA 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 usernameAssim 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 BSUIDVisão geralTodos 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 mensagensO 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: Acesse o bot desejado no Portal Acesse o menu superior do Blip Clique no ícone de três pontos (...) Selecione a opção Log no menu Localize o objeto metadata dentro do envelope da mensagem Propriedades disponíveisDentro 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 metadataPara extrair essas informações, você deve definir duas ações de saída no bloco Início do Studio:1. Definir variável de metadataDefina uma variável com os seguintes parâmetros: Nome da variável: metadata Valor: {{input.message@metadata}} 2. Executar scriptExecute 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 BlipVisão geralVisando 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.identityAtualmente 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.netA 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.netO 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 Carrosel - Conteúdo Dinâmico Como alterar a foto de perfil do WhatsApp Testes Unitários Obter acesso a WABA da minha empresa Como validar a configuração do provedor IA