BLOG

BSUID WhatsApp: o que é e como preparar seu CRM

BSUID WhatsApp explicado: o que é, por que telefone como chave no CRM não basta e um checklist de modelagem para se preparar.

Mesa de trabalho com notebook exibindo a ficha de um contato sem número de telefone, ao lado de um bloco de notas com

O BSUID WhatsApp (Business-Scoped User ID) é o identificador que a Meta cria para representar uma pessoa dentro da conta de uma empresa. Com os nomes de usuário, o cliente pode conversar sem mostrar o telefone, e um CRM que usa DDD + telefone como chave pode não reconhecer esse contato. Este guia explica o que muda e traz um checklist de modelagem para você se preparar.

Principais pontos

  • O BSUID identifica a pessoa só dentro da conta de uma empresa: o mesmo cliente tem IDs diferentes em empresas diferentes.
  • Com username ativo, o telefone pode não chegar no webhook; o user_id é o campo de referência.
  • Telefone como chave primária ou NOT NULL pode gerar erro no webhook ou mensagem descartada.
  • Checklist: contact_id interno, phone_e164 aceitando nulo, campo bsuid indexado e histórico preso ao contact_id.
  • O evento user_id_update avisa quando o BSUID muda, para atualizar o contato sem duplicar.
  • Pedir telefone e e-mail só quando necessário e com permissão respeita a minimização de dados da LGPD.

BSUID WhatsApp: o que é e o que ele não é

BSUID é a sigla de Business-Scoped User ID, ou ID de usuário no escopo da empresa. Em português simples: é um código que a Meta gera para identificar uma pessoa dentro do universo de uma empresa. Pense no número de cadastro do cliente na sua loja. Ele vale para você, mas não diz nada em outra loja. O BSUID WhatsApp existe para responder 'é a mesma pessoa de ontem?' sem depender do telefone.

Formato típico: prefixo de país e código opaco

O formato costuma trazer um prefixo de país seguido de um código longo, como BR.xxxxxxxxxxxxxxxxx. O código é opaco: não carrega DDD, não tem pedaço do telefone e não dá para deduzir nada dele. Trate como texto, guarde inteiro e não tente cortar, converter ou 'interpretar'. Os detalhes estão na documentação da Meta sobre business-scoped user IDs.

Por que o mesmo cliente tem BSUIDs diferentes em empresas diferentes

O BSUID não é universal. A mesma pessoa tem um código na empresa A e outro, totalmente diferente, na empresa B. Na prática:

  • você não consegue usar o BSUID para reconhecer seu cliente em bases de outras empresas;
  • outras empresas também não conseguem usar o dele para rastrear seu cliente;
  • o código só faz sentido dentro da conta em que foi gerado.

O BSUID também não é um telefone, não substitui o cadastro do cliente e não é um dado para exibir ou compartilhar por aí. Ele é uma chave de referência para o seu sistema. Quem entende o BSUID WhatsApp como 'o telefone com outro nome' monta a modelagem errada.

Username no WhatsApp: por que o telefone pode sumir do atendimento

A mudança que traz o BSUID para o seu dia a dia é o nome de usuário (@username). Ele permite que uma pessoa converse com empresas sem revelar o próprio número.

Como funciona o @username para quem fala com empresas

Para o cliente, é uma questão de privacidade: ele escolhe um nome de usuário e fala com a empresa sem expor o telefone. Para você, a conversa chega, mas o número pode não vir junto. O atendimento continua funcionando; o que muda é o dado que o seu sistema recebe. É essa diferença que torna o BSUID WhatsApp um assunto de modelagem, e não só de atendimento.

O que a Meta publicou e quando

Segundo o changelog da Meta, o campo user_id (o BSUID) passou a constar nos webhooks da Cloud API em março de 2026, com a liberação mais ampla dos nomes de usuário prevista para meados do ano. Há também um artigo prático sobre o que mudar em webhooks e CRM, que é fonte secundária. Cronogramas mudam: confira datas e detalhes na documentação oficial antes de tomar qualquer decisão.

Número de telefone oculto no WhatsApp: o que muda na prática

Quando a pessoa oculta o número, o telefone pode não vir no evento. Dependendo do provedor ou da integração que entrega o webhook, campos como from, wa_id ou o telefone em formato E.164 podem chegar vazios. O identificador de referência passa a ser o user_id, conforme a documentação da Meta.

Isso não quer dizer que todo cliente vai esconder o telefone. Muitos continuarão aparecendo com número. O ponto é que o seu sistema precisa funcionar nos dois casos: contato com telefone e contato só com BSUID.

Por que DDD + telefone como chave no CRM deixa de bastar

Durante anos, usar DDD + telefone como identificador do cliente foi o jeito mais simples de montar uma base. Funcionava porque o número sempre chegava. Agora ele é um dado que pode faltar, e isso é um risco de modelagem para tratar com calma.

O que quebra: campo obrigatório, chave única e deduplicação por telefone

A chave primária telefone no CRM costuma vir acompanhada de regras: a coluna não aceita vazio (NOT NULL), o valor não pode repetir (UNIQUE) e a deduplicação compara pelo número. Se a mensagem chega sem telefone, cada regra falha de um jeito:

Regra do sistema O que acontece sem telefone
Telefone obrigatório O cadastro falha e o webhook pode responder com erro
Telefone como chave única Vários contatos sem número podem colidir entre si
Deduplicação por telefone Não há como saber se é um contato novo ou antigo
Mensagem ligada ao telefone A conversa fica sem dono ou é descartada

O que perde valor: cruzar listas externas só pelo número

Como o BSUID muda de empresa para empresa, planilhas e bases externas cruzadas apenas por telefone perdem utilidade para quem usa username. Se o seu processo de enriquecimento depende de 'achar o número e completar o cadastro', ele deixa de funcionar para esses contatos.

Exemplo do dia a dia: o contato que não vira cadastro

Imagine a Carla, atendente de uma clínica. Uma paciente escreve pedindo horário, usando username. O sistema da clínica exige telefone para criar o contato, então a mensagem não vira cadastro. Carla vê a conversa solta, sem histórico, sem responsável e sem etiqueta. Se a paciente voltar amanhã, ninguém sabe que já conversou. Nada disso é falha de atendimento: é falha de modelagem.

Checklist de modelagem: como adaptar o CRM ao BSUID

Adaptar o CRM ao BSUID é, antes de tudo, organizar o cadastro. Siga a ordem abaixo. Se o seu sistema é uma planilha ou um CRM pronto, veja a dica no fim da seção.

1. ID interno do contato como chave primária (contact_id)

Crie um identificador próprio, gerado por você, e use como chave primária da tabela de contatos. Um UUID (um código único gerado pelo sistema) resolve. Ele não depende de nenhum dado de terceiros. Telefone e BSUID passam a ser atributos do contato, não a identidade dele.

2. Telefone opcional: phone_e164 aceitando nulo

Guarde o telefone em um campo próprio, no formato E.164 (telefone com código do país e DDD, como +5511999999999), e permita que fique vazio. Quando o cliente informar ou autorizar o número, você preenche.

3. Campo extra e indexado para o BSUID

Crie um campo de texto para o BSUID (o valor de user_id) e adicione um índice, porque é por ele que você vai localizar o contato a cada evento que chegar.

Campo Tipo Observação
contact_id UUID Chave primária interna, gerada por você
phone_e164 Texto Aceita nulo; preenchido quando o telefone for informado ou autorizado
bsuid Texto Indexado; guarde o valor completo recebido em user_id
contact_id (em atendimentos e mensagens) UUID Chave estrangeira que liga todo o histórico ao contato

4. Histórico preso ao contact_id, não ao telefone

Mensagens, atendimentos, etiquetas e notas devem apontar para o contact_id. Assim, se o cliente começar só com username e mais tarde informar o telefone (ou o contrário), você atualiza os atributos do contato e o histórico continua intacto.

5. Tratar o evento user_id_update sem duplicar contatos

Existe um evento de webhook chamado user_id_update, enviado quando o BSUID de uma pessoa muda, por exemplo após troca de número. Ele traz o par previous (o BSUID antigo) e current (o novo), como descrevem este resumo sobre o evento e o material da Meta. A regra é simples: procure o contato pelo valor antigo, troque pelo novo e siga. Não crie outro contato e não apague a linha do tempo. O resumo é fonte secundária, então confirme o formato exato no changelog da Meta.

6. Regra de mesclagem: quando telefone e BSUID se encontram

Defina antes o que acontece quando o mesmo cliente aparece de dois jeitos: uma vez com telefone, outra só com BSUID. Uma regra segura:

  • se o cliente informar o telefone numa conversa que já tem BSUID, atualize o mesmo contato;
  • se um telefone novo coincidir com um contato já existente, peça confirmação de uma pessoa antes de unir os cadastros;
  • registre quem fez a mesclagem e quando.

Dica para quem usa planilha ou CRM pronto

Você não precisa mexer em banco de dados para começar. Veja se o seu CRM tem campo personalizado de texto para guardar o ID e se o telefone pode ficar em branco. Em planilha, crie uma coluna de código do contato (interno, seu) e outra para o BSUID.

BSUID WhatsApp: o que muda no seu CRM na prática

Para quem atende e vende, a mudança aparece em três momentos: quando a conversa chega, quando alguém responde e quando o histórico é consultado. O quadro compara um cadastro preso ao telefone com um cadastro preparado para o BSUID WhatsApp.

Momento Cadastro preso ao telefone Cadastro preparado
Mensagem chega sem número Erro ou conversa solta Contato criado ou localizado pelo BSUID
Cliente informa o telefone depois Cadastro duplicado Mesmo contato atualizado
Cliente troca de número Histórico fica no cadastro antigo user_id_update atualiza o contato existente
Gestor consulta o histórico Busca só por telefone Busca por contato, com tudo junto

Pense no Rafael, dono de uma loja de pisos que atende por WhatsApp. Um cliente chama por username pedindo orçamento. Com o cadastro preparado, a conversa vira contato, entra no funil, ganha responsável e etiqueta. Três dias depois, o cliente passa o telefone para o envio da proposta. Rafael registra o número no mesmo contato, e a conversa de segunda continua lá, no mesmo lugar.

Esse é o ganho do BSUID WhatsApp bem tratado: o atendimento não depende de o cliente abrir mão da privacidade para ser reconhecido.

Onde a API e os webhooks do FlowZap se encaixam

Um aviso de transparência primeiro: este artigo não descreve nem antecipa suporte a BSUID no FlowZap. Ele mostra como estruturar o seu lado do CRM caso a API que você usa passe a enviar esse identificador. O que descrevemos aqui é onde a API e os webhooks entram na arquitetura que você está preparando.

Recebimento: o handler do seu sistema não pode exigir telefone preenchido

A API REST do FlowZap (com chaves por organização, área ou número) e os webhooks assinados, com novas tentativas, levam eventos de mensagem ao sistema da sua empresa. O papel do desenvolvedor é construir o handler (o código que recebe o evento) de modo que aceite um contato sem telefone: buscar pelo identificador disponível, criar o contato com contact_id novo se for o caso e responder sucesso ao webhook. Em /docs você confere quais campos de identidade cada evento traz. Quem prefere montar o recebimento com menos código pode ver o passo a passo de webhook do WhatsApp no n8n. Para acompanhar eventos ao vivo, os eventos em tempo real (SSE) são outra opção.

Envio: guardar a referência da conversa, não só o número

Na hora de responder, evite montar a integração com o telefone como único parâmetro. Guarde, junto do contact_id, a referência da conversa e o número de WhatsApp da empresa que atendeu. Isso deixa seu fluxo de envio modular: se amanhã o contato não tiver telefone, você não precisa refazer o desenho.

CRM e campos personalizados para telefone e e-mail coletados com permissão

O CRM do FlowZap permite campos personalizados de texto, número, data, lista, telefone e e-mail, além de funil por etapas e responsável por contato. É um lugar natural para guardar o telefone ou o e-mail que o cliente informar com permissão, ao lado do histórico de atendimentos.

O que conferir antes de depender de BSUID

Antes de apostar o seu processo no BSUID, confira em /docs o que cada evento traz hoje. Se tiver dúvida sobre identificadores, fale com a equipe.

LGPD: peça o telefone só quando precisar e com permissão

O telefone é dado pessoal. A Lei Geral de Proteção de Dados (Lei 13.709/2018) traz, no artigo 6º, inciso III, o princípio da necessidade: usar só o mínimo preciso para a finalidade. Nesse sentido, o BSUID ajuda, porque permite identificar o contato sem expor o número em todas as etapas. Este texto não é aconselhamento jurídico: valide as regras com o jurídico da sua empresa.

Quando pedir telefone e e-mail

Pergunte-se: 'preciso do telefone para atender esta pessoa agora?'. Se a resposta for não, não insista. Peça quando houver motivo claro: na qualificação, no fechamento ou para enviar um documento. Explique para que serve ('para enviar o boleto e avisar da entrega') e registre no campo personalizado do CRM. Para organizar essas etapas, veja o guia de funil de vendas no WhatsApp.

Quem não autorizou não recebe campanha

No FlowZap, campanhas só vão para contatos com consentimento registrado. Siga a mesma lógica no seu processo: não tente descobrir o número de quem escolheu ocultá-lo, não cruze bases para 'adivinhar' o telefone e não envie mensagem a quem não permitiu.

Plano de ação em 5 passos para a sua equipe

Para não deixar o tema parado, divida o trabalho entre quem desenvolve, quem atende e quem decide.

  1. Mapear onde o telefone é usado como chave (desenvolvedor). Olhe o banco, as planilhas e as integrações. Liste tudo que quebra se o número vier vazio.
  2. Criar contact_id e os campos phone_e164 (aceitando nulo) e bsuid (desenvolvedor). Migre os contatos atuais mantendo o telefone preenchido.
  3. Ajustar o handler do webhook e testar com um evento sem telefone (desenvolvedor). Garanta que o sistema responde sucesso e cria ou localiza o contato.
  4. Tratar user_id_update e definir a regra de mesclagem (desenvolvedor e gestor de atendimento). Decidam juntos quem aprova a união de cadastros.
  5. Revisar a política de coleta de dados (dono e gestor de atendimento). Defina quando a equipe pede telefone e e-mail e onde registra.

Como próximos passos, leia a documentação oficial da Meta, confira em /docs os eventos do FlowZap e, se quiser entender o cenário de custos da API, leia API do WhatsApp é paga? O que muda em outubro de 2026.

Comece com o FlowZap

Veja o que o FlowZap faz e compare os planos. Para criar a conta, basta o nome da empresa, um e-mail e uma senha: o cadastro não pede cartão de crédito, e o pagamento é por Pix ou cartão de crédito, sem fidelidade.

Perguntas frequentes

O que é BSUID no WhatsApp?

BSUID (Business-Scoped User ID) é um código opaco que a Meta gera para identificar uma pessoa dentro da conta de uma empresa. Não é o telefone e não vale fora do portfólio daquela empresa: a mesma pessoa tem BSUIDs diferentes em empresas diferentes.

O número de telefone fica oculto para todos os clientes?

Não. Só quando a pessoa usa um nome de usuário e escolhe ocultar o número. Muitos clientes continuarão aparecendo com telefone. Por isso, o ideal é seu sistema aceitar os dois casos: contato com telefone e contato identificado apenas pelo BSUID.

Posso continuar usando o telefone como chave primária no CRM?

É arriscado. Se o telefone vier vazio, um campo obrigatório ou único pode derrubar o cadastro. Prefira um ID interno do contato como chave primária, telefone opcional em campo próprio e um campo separado e indexado para o BSUID.

O que é o evento user_id_update?

É um evento de webhook que avisa quando o BSUID de uma pessoa muda, por exemplo após troca de número. Ele traz o valor anterior e o atual. Use o par para atualizar o contato existente, sem duplicar nem perder o histórico. Confirme o formato na documentação da Meta.

O FlowZap já suporta BSUID?

Este artigo não afirma nem antecipa suporte a BSUID no FlowZap. A plataforma oferece API REST, webhooks assinados e eventos em tempo real para levar mensagens ao seu sistema. Veja em /docs os campos de cada evento e fale com a equipe em /contato.

Fontes

  1. facebook.com
  2. facebook.com
  3. medium.com
  4. quora.com

Atenda o WhatsApp da empresa em equipe.

Conecte o número por QR code e responda pelo navegador, com a API para integrar seus sistemas.

Cadastro sem cartão de crédito · Pix ou cartão de crédito, sem fidelidade