Os webhooks são o ponto onde a mudança do BSUID se torna concreta para quem desenvolve ou administra integrações: é ali que o campo de telefone pode deixar de vir preenchido, e onde sistemas mal preparados travam primeiro.
Por isso, entender exatamente o que muda no payload é o passo mais técnico e mais urgente da adaptação.
Além disso, este artigo faz parte do cluster Como Organizar a Comunicação da Sua Empresa.
O Que Mudou no Payload dos Webhooks?
Antes, de fato, todo evento de mensagem trazia o número de telefone do cliente no campo wa_id, de forma confiável e constante.
Com o BSUID, dois campos novos passam a acompanhar e em alguns casos substituir essa informação:
user_id: traz o BSUID do cliente, em geral presente em todos os webhooks de mensagem, independentemente de o usuário ter adotado username ou não.parent_user_id: usado sobretudo em cenários específicos de hierarquia de contas, como integrações que operam em nome de múltiplos números comerciais.
Nesse sentido, o ponto crítico: quando o telefone não está disponível (usuário com username, fora da janela de 30 dias, sem Contact Book ativo), o campo wa_id pode chegar vazio ou nulo.
Assim, sistemas escritos assumindo que esse campo sempre existe vão falhar exatamente nesse ponto.
Leia mais: O Que é BSUID?
Onde os Parsers Antigos Costumam Quebrar?
- Validação obrigatória de telefone: por exemplo, parsers que rejeitam ou descartam eventos sem
wa_idpreenchido perdem silenciosamente mensagens de clientes com username. - Deduplicação por telefone: nesse caso, lógicas que usam o número como chave única de deduplicação passam a criar registros duplicados quando o mesmo cliente aparece ora com telefone, ora só com BSUID.
- Templates de autenticação: tentar enviar um template de autenticação (one-tap, zero-tap, copy code) usando BSUID no lugar do telefone retorna erro — ainda assim, esses templates continuam exigindo o número.
Leia mais: O Que é o Contact Book da Meta?
Checklist Prático Para Atualizar Sua Integração
- Portanto, tratar
user_id(BSUID) como identificador obrigatório, não opcional, em toda a lógica de recebimento. - Além disso, tornar o campo de telefone opcional em todas as rotinas de processamento, e nunca assumir que ele virá preenchido.
- Da mesma forma, atualizar regras de deduplicação para usar o BSUID como chave primária, mantendo o telefone como dado complementar.
- Por fim, testar o fluxo completo com uma conta que já usa username, simulando o cenário de telefone ausente.
Leia mais: Como Adaptar CRMs Para a Era BSUID
Perguntas Frequentes
Não. Na prática, ele continua existindo e sendo preenchido quando o telefone está disponível (dentro da janela de 30 dias ou já mapeado no Contact Book). Ainda assim, a diferença é que ele deixou de ser garantido em todo evento.
Em geral, aparece em todos os webhooks de mensagem, no campo user_id, independentemente de o usuário ter adotado username ou não.
Em resumo, depende de como ela identifica destinatários. Nesse caso, se a base de contatos depende exclusivamente de telefone para envio, vale verificar com o fornecedor se já existe suporte a BSUID para reengajamento de contatos que adotaram username.
Leitura Recomendada
- Como Organizar a Comunicação da Sua Empresa
- O Que é BSUID?
- Como Adaptar CRMs Para a Era BSUID
- Por Que Empresas Perderão o Histórico de Clientes
- O Que é o Contact Book da Meta?
- O Fim das Mensagens Gratuitas no WhatsApp
- Telefone Deixou de Ser a Identidade do Cliente
- Omnichannel vs Multicanal: Qual a Diferença Real?
- Como Usernames Substituem Parcialmente o Telefone
- A Nova Identidade Digital dos Consumidores
- O Fim do Cross Tracking Entre Empresas
- Por Que Só 16% das Empresas Têm Omnichannel Real
- O Impacto dos Agentes de IA no Atendimento
- Blueprint de Operações B2C
Sua Integração Está Preparada Para a Nova Arquitetura do WhatsApp?
Se sua empresa utiliza WhatsApp Business, CRM ou integrações automatizadas, este é, portanto, o momento de garantir que seus sistemas continuem funcionando corretamente na era do BSUID.
Fale com a equipe da Dinâmica e descubra, assim, como adaptar sua comunicação para evitar falhas, preservar o histórico dos clientes e manter suas integrações prontas para as mudanças da Meta.
Quer uma solução personalizada para sua empresa?
Preencha o formulário e, assim, um especialista entra em contato com você.
Prefere falar direto com a gente?
- WhatsApp: Clique e Fale Com Um Especialista
- Telefone: Ligue Agora – (11) 2225-8800
- E-mail: contato@dinamicasp.com.br
- Formulário: Preencha os Dados de Contato
- Site: Dinâmica Informática e Telecomunicações
