← Voltar para o Blog Notícia · WhatsApp API · CRM

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.

9 min de leitura· Publicado em 11 Novembro 2026· Por Editorial Otom
Notebook entreaberto com luz colorida saindo da tela no escuro
Imagem ilustrativa · Unsplash
30 dias
sem contato e o telefone do cliente com username deixa de vir no webhook
Obrigatório
suporte ao BSUID para empresas e parceiros integrados
13/04/27
contas novas a partir dessa data já não enviam marketing pela Cloud API

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:

  1. Lead duplicado: o sistema não acha ninguém pelo número e cria um contato novo, sem histórico.
  2. Conversa órfã: a mensagem entra sem vínculo com o card e ninguém responde.
  3. 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.

E a cobrança por resposta? Segue valendo o que entrou em 1º de outubro: cada número tem 1.000 mensagens de serviço gratuitas por mês e, a partir da 1.001ª, cada resposta é cobrada. Explicamos no texto sobre a cobrança das respostas no WhatsApp.

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.

Fontes: Meta, business-scoped user IDs · Meta, visão geral das mensagens de marketing · Meta, preços da plataforma WhatsApp Business · PPC Land, Cloud API perde mensagens de marketing.

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