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.
Entender exatamente o que muda no payload é o passo mais técnico e mais urgente da adaptação.
Este artigo faz parte do cluster Como Organizar a Comunicação da Sua Empresa.
O Que Mudou no Payload dos Webhooks?
Antes, 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, presente em todos os webhooks de mensagem, independentemente de o usuário ter adotado username ou não.parent_user_id: usado em cenários específicos de hierarquia de contas, como integrações que operam em nome de múltiplos números comerciais.
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.
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: parsers que rejeitam ou descartam eventos sem
wa_idpreenchido perdem silenciosamente mensagens de clientes com username. - Deduplicação por telefone: 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 — esses templates continuam exigindo o número.
Leia mais: O Que é o Contact Book da Meta?
Checklist Prático Para Atualizar Sua Integração
- Tratar
user_id(BSUID) como identificador obrigatório, não opcional, em toda a lógica de recebimento. - Tornar o campo de telefone opcional em todas as rotinas de processamento, e nunca assumir que ele virá preenchido.
- Atualizar regras de deduplicação para usar o BSUID como chave primária, mantendo o telefone como dado complementar.
- 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. Ele continua existindo e sendo preenchido quando o telefone está disponível (dentro da janela de 30 dias ou já mapeado no Contact Book). A diferença é que ele deixou de ser garantido em todo evento.
Aparece em todos os webhooks de mensagem, no campo user_id, independentemente de o usuário ter adotado username ou não.
Depende de como ela identifica destinatários. 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?
- 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
Sua Integração Está Preparada Para a Nova Arquitetura do WhatsApp?
Se sua empresa utiliza WhatsApp Business, CRM ou integrações automatizadas, este é o momento de garantir que seus sistemas continuem funcionando corretamente na era do BSUID.
Fale com a equipe da Dinâmica e descubra 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 um especialista entra em contato com você.