Usernames no WhatsApp: o telefone pode sumir do webhook, e o seu CRM precisa estar pronto
O WhatsApp está liberando nomes de usuário. Para quem usa a API oficial, isso tem um efeito prático: o telefone do cliente pode não vir mais na mensagem. Junte a isso o anúncio de que o marketing sai da Cloud API em 2027, e o seu CRM tem duas lições de casa.
o que mudaUsernames e o fim do telefone como chave
O WhatsApp está liberando aos poucos, ao longo de 2026, os nomes de usuário: o cliente pode ter um @ e conversar sem expor o número. A adesão é opcional. A reserva de username para empresas abriu em 29 de junho.
Para quem integra pela API oficial, a consequência está na documentação da Meta: quando o cliente tem username, "their phone number will not be included in webhooks, unless you have interacted with the user before". O número só vem se houve conversa ou ligação com aquele contato nos últimos 30 dias, ou se ele está na agenda da empresa.
bsuidO que é o BSUID
O BSUID (business-scoped user ID) é um identificador do cliente que vale só para a sua empresa. Ele vem sempre no webhook, com ou sem username, e passou a ser a chave estável da conversa. Três detalhes importam:
- É diferente para cada empresa: o mesmo cliente tem um BSUID com você e outro com o concorrente.
- Muda se o cliente trocar de número.
- O suporte é obrigatório. A Meta escreve que "Supporting business-scoped user IDs (BSUID) is required for all partners and directly-integrated businesses" e que, sem ele, a empresa pode perder a capacidade de processar mensagens desses clientes.
no crmOnde o CRM quebra
Muito CRM de WhatsApp foi construído com o telefone como identidade do cliente: a mensagem chega, o sistema procura o lead pelo número, acha ou cria. Com o telefone vazio no webhook, três coisas dão errado:
- Lead duplicado: o sistema não acha ninguém pelo número e cria um contato novo, sem histórico.
- Conversa órfã: a mensagem entra sem vínculo com o card e ninguém responde.
- Automação cega: regras que dependem do número (roteamento por DDD, deduplicação, integração com outros sistemas) param de funcionar para esse cliente.
A correção é guardar o BSUID como identificador da conversa, ligado ao lead, e tratar o telefone como um dado que pode faltar. Nos CRMs que mantemos, essa mudança entra junto com a revisão de deduplicação, que já precisava lidar com o mesmo número com e sem o nono dígito.
marketingA outra data: marketing sai da Cloud API
Em outubro, a Meta anunciou que a Cloud API vai parar de enviar mensagens de marketing: "Cloud API will stop supporting marketing messages on October 13, 2027." Contas criadas a partir de 13 de abril de 2027 já nascem sem essa opção. O caminho passa a ser a Marketing Messages API for WhatsApp, que a Meta descreve com otimização de entrega, métricas comparativas e validade de mensagem para campanha com prazo.
Mensagens de atendimento, utilidade e autenticação continuam na Cloud API. A mudança pega quem usa o mesmo fluxo para responder cliente e para disparar campanha.
leitura otomO que fazer agora
- Confirme se o seu sistema já grava o BSUID que chega no webhook.
- Revise a busca de lead: ela precisa achar o cliente pelo BSUID quando o telefone vier vazio.
- Teste com um número de teste que tenha username, antes que o cliente real apareça.
- Separe o envio de campanhas do envio de atendimento, já pensando na Marketing Messages API.
- Pergunte ao seu provedor de API qual é o plano dele para as duas datas.
Quem usa o Otom CRM ou um sistema feito pela Otom pode falar com a gente para conferir o status dessas mudanças.
perguntasPerguntas frequentes
O que é BSUID no WhatsApp?
É o business-scoped user ID, um identificador do cliente que vale só para a sua empresa e vem sempre no webhook da API oficial. Ele muda se o cliente trocar de número, e o suporte a ele é obrigatório para empresas e parceiros integrados.
O telefone do cliente vai sumir da API do WhatsApp?
Para clientes com username, o telefone deixa de vir no webhook, a não ser que tenha havido conversa ou ligação com ele nos últimos 30 dias ou que ele esteja na agenda da empresa.
A Cloud API do WhatsApp vai parar de enviar marketing?
Sim. Segundo a Meta, a Cloud API deixa de enviar mensagens de marketing em 13 de outubro de 2027, e contas criadas a partir de 13 de abril de 2027 já não terão essa opção. O caminho é a Marketing Messages API for WhatsApp.
O seu CRM acha o cliente quando o telefone não vem?
A gente revisa a integração do seu WhatsApp com o CRM para os usernames e prepara o envio de campanhas para a mudança de 2027.
Quero revisar minha integração