[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"content:article:bsuid-whatsapp":3},{"data":4},{"id":5,"type":6,"slug":7,"path":8,"url":9,"title":10,"meta_title":11,"meta_description":12,"tldr":13,"html":19,"toc":20,"reading_minutes":113,"faqs":114,"sources":130,"keywords":142,"cluster":151,"canonical_url":9,"robots":152,"published_at":153,"updated_at":153,"author":154,"reviewer":161,"cover":162,"related":169,"json_ld":238},"4dbe7b35-9675-4e07-9abf-1c159c49e5d3","article","bsuid-whatsapp","\u002Fblog\u002Fbsuid-whatsapp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fbsuid-whatsapp","BSUID WhatsApp: o que é e como preparar seu CRM","BSUID WhatsApp: o que é e como adaptar o CRM | FlowZap","BSUID WhatsApp explicado: o que é, por que telefone como chave no CRM não basta e um checklist de modelagem para se preparar.",[14,15,16,17,18],"BSUID é um identificador do usuário criado pela Meta, válido só dentro da conta de cada empresa.","Quem usa username pode ocultar o telefone. Aí o número deixa de ser um dado em que você pode confiar no webhook.","Telefone como chave primária ou campo obrigatório no CRM pode derrubar o cadastro do contato.","O caminho é ter ID interno, telefone opcional, campo indexado para o BSUID e histórico ligado ao contato.","API e webhooks do FlowZap levam eventos ao seu sistema. Confira em \u002Fdocs o que vem em cada evento.","\u003Cp>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.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Principais pontos\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>O BSUID identifica a pessoa só dentro da conta de uma empresa: o mesmo cliente tem IDs diferentes em empresas diferentes.\u003C\u002Fli>\n\u003Cli>Com username ativo, o telefone pode não chegar no webhook; o user_id é o campo de referência.\u003C\u002Fli>\n\u003Cli>Telefone como chave primária ou NOT NULL pode gerar erro no webhook ou mensagem descartada.\u003C\u002Fli>\n\u003Cli>Checklist: contact_id interno, phone_e164 aceitando nulo, campo bsuid indexado e histórico preso ao contact_id.\u003C\u002Fli>\n\u003Cli>O evento user_id_update avisa quando o BSUID muda, para atualizar o contato sem duplicar.\u003C\u002Fli>\n\u003Cli>Pedir telefone e e-mail só quando necessário e com permissão respeita a minimização de dados da LGPD.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"bsuid-whatsapp-o-que-e-e-o-que-ele-nao-e\">BSUID WhatsApp: o que é e o que ele não é\u003C\u002Fh2>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"formato-tipico-prefixo-de-pais-e-codigo-opaco\">Formato típico: prefixo de país e código opaco\u003C\u002Fh3>\n\u003Cp>O formato costuma trazer um prefixo de país seguido de um código longo, como \u003Ccode>BR.xxxxxxxxxxxxxxxxx\u003C\u002Fcode>. 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 \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fbusiness-scoped-user-ids\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">documentação da Meta sobre business-scoped user IDs\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"por-que-o-mesmo-cliente-tem-bsuids-diferentes-em-empresas-diferentes\">Por que o mesmo cliente tem BSUIDs diferentes em empresas diferentes\u003C\u002Fh3>\n\u003Cp>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:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>você não consegue usar o BSUID para reconhecer seu cliente em bases de outras empresas;\u003C\u002Fli>\n\u003Cli>outras empresas também não conseguem usar o dele para rastrear seu cliente;\u003C\u002Fli>\n\u003Cli>o código só faz sentido dentro da conta em que foi gerado.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>O BSUID também \u003Cstrong>não é\u003C\u002Fstrong> 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.\u003C\u002Fp>\n\u003Ch2 id=\"username-no-whatsapp-por-que-o-telefone-pode-sumir-do-atendimento\">Username no WhatsApp: por que o telefone pode sumir do atendimento\u003C\u002Fh2>\n\u003Cp>A mudança que traz o BSUID para o seu dia a dia é o nome de usuário (\u003Ccode>@username\u003C\u002Fcode>). Ele permite que uma pessoa converse com empresas sem revelar o próprio número.\u003C\u002Fp>\n\u003Ch3 id=\"como-funciona-o-username-para-quem-fala-com-empresas\">Como funciona o @username para quem fala com empresas\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"o-que-a-meta-publicou-e-quando\">O que a Meta publicou e quando\u003C\u002Fh3>\n\u003Cp>Segundo o \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fchangelog\" rel=\"noopener noreferrer\" target=\"_blank\">changelog da Meta\u003C\u002Fa>, o campo \u003Ccode>user_id\u003C\u002Fcode> (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 \u003Ca href=\"https:\u002F\u002Fmedium.com\u002F@matthias_20536\u002Fmeta-bsuid-is-live-in-whatsapp-cloud-api-what-to-change-in-your-webhooks-and-crm-9b6dc69058dd\" rel=\"noopener noreferrer\" target=\"_blank\">artigo prático sobre o que mudar em webhooks e CRM\u003C\u002Fa>, que é fonte secundária. Cronogramas mudam: confira datas e detalhes na documentação oficial antes de tomar qualquer decisão.\u003C\u002Fp>\n\u003Ch3 id=\"numero-de-telefone-oculto-no-whatsapp-o-que-muda-na-pratica\">Número de telefone oculto no WhatsApp: o que muda na prática\u003C\u002Fh3>\n\u003Cp>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 \u003Ccode>from\u003C\u002Fcode>, \u003Ccode>wa_id\u003C\u002Fcode> ou o telefone em formato E.164 podem chegar vazios. O identificador de referência passa a ser o \u003Ccode>user_id\u003C\u002Fcode>, conforme a documentação da Meta.\u003C\u002Fp>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch2 id=\"por-que-ddd-telefone-como-chave-no-crm-deixa-de-bastar\">Por que DDD + telefone como chave no CRM deixa de bastar\u003C\u002Fh2>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"o-que-quebra-campo-obrigatorio-chave-unica-e-deduplicacao-por-telefone\">O que quebra: campo obrigatório, chave única e deduplicação por telefone\u003C\u002Fh3>\n\u003Cp>A chave primária telefone no CRM costuma vir acompanhada de regras: a coluna não aceita vazio (\u003Ccode>NOT NULL\u003C\u002Fcode>), o valor não pode repetir (\u003Ccode>UNIQUE\u003C\u002Fcode>) e a deduplicação compara pelo número. Se a mensagem chega sem telefone, cada regra falha de um jeito:\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Regra do sistema\u003C\u002Fth>\n\u003Cth>O que acontece sem telefone\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Telefone obrigatório\u003C\u002Ftd>\n\u003Ctd>O cadastro falha e o webhook pode responder com erro\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Telefone como chave única\u003C\u002Ftd>\n\u003Ctd>Vários contatos sem número podem colidir entre si\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Deduplicação por telefone\u003C\u002Ftd>\n\u003Ctd>Não há como saber se é um contato novo ou antigo\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Mensagem ligada ao telefone\u003C\u002Ftd>\n\u003Ctd>A conversa fica sem dono ou é descartada\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"o-que-perde-valor-cruzar-listas-externas-so-pelo-numero\">O que perde valor: cruzar listas externas só pelo número\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"exemplo-do-dia-a-dia-o-contato-que-nao-vira-cadastro\">Exemplo do dia a dia: o contato que não vira cadastro\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch2 id=\"checklist-de-modelagem-como-adaptar-o-crm-ao-bsuid\">Checklist de modelagem: como adaptar o CRM ao BSUID\u003C\u002Fh2>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"1-id-interno-do-contato-como-chave-primaria-contact-id\">1. ID interno do contato como chave primária (contact_id)\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"2-telefone-opcional-phone-e164-aceitando-nulo\">2. Telefone opcional: phone_e164 aceitando nulo\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch3 id=\"3-campo-extra-e-indexado-para-o-bsuid\">3. Campo extra e indexado para o BSUID\u003C\u002Fh3>\n\u003Cp>Crie um campo de texto para o BSUID (o valor de \u003Ccode>user_id\u003C\u002Fcode>) e adicione um índice, porque é por ele que você vai localizar o contato a cada evento que chegar.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Campo\u003C\u002Fth>\n\u003Cth>Tipo\u003C\u002Fth>\n\u003Cth>Observação\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>contact_id\u003C\u002Ftd>\n\u003Ctd>UUID\u003C\u002Ftd>\n\u003Ctd>Chave primária interna, gerada por você\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>phone_e164\u003C\u002Ftd>\n\u003Ctd>Texto\u003C\u002Ftd>\n\u003Ctd>Aceita nulo; preenchido quando o telefone for informado ou autorizado\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>bsuid\u003C\u002Ftd>\n\u003Ctd>Texto\u003C\u002Ftd>\n\u003Ctd>Indexado; guarde o valor completo recebido em \u003Ccode>user_id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>contact_id (em atendimentos e mensagens)\u003C\u002Ftd>\n\u003Ctd>UUID\u003C\u002Ftd>\n\u003Ctd>Chave estrangeira que liga todo o histórico ao contato\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"4-historico-preso-ao-contact-id-nao-ao-telefone\">4. Histórico preso ao contact_id, não ao telefone\u003C\u002Fh3>\n\u003Cp>Mensagens, atendimentos, etiquetas e notas devem apontar para o \u003Ccode>contact_id\u003C\u002Fcode>. 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.\u003C\u002Fp>\n\u003Ch3 id=\"5-tratar-o-evento-user-id-update-sem-duplicar-contatos\">5. Tratar o evento user_id_update sem duplicar contatos\u003C\u002Fh3>\n\u003Cp>Existe um evento de webhook chamado \u003Ccode>user_id_update\u003C\u002Fcode>, enviado quando o BSUID de uma pessoa muda, por exemplo após troca de número. Ele traz o par \u003Ccode>previous\u003C\u002Fcode> (o BSUID antigo) e \u003Ccode>current\u003C\u002Fcode> (o novo), como descrevem este \u003Ca href=\"https:\u002F\u002Fwww.quora.com\u002FWhat-is-WhatsApp-BSUID-business-scoped-user-ID-and-how-does-the-user_id_update-webhook-notification-work\" rel=\"noopener noreferrer\" target=\"_blank\">resumo sobre o evento\u003C\u002Fa> 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 \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fchangelog\" rel=\"noopener noreferrer\" target=\"_blank\">changelog da Meta\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"6-regra-de-mesclagem-quando-telefone-e-bsuid-se-encontram\">6. Regra de mesclagem: quando telefone e BSUID se encontram\u003C\u002Fh3>\n\u003Cp>Defina antes o que acontece quando o mesmo cliente aparece de dois jeitos: uma vez com telefone, outra só com BSUID. Uma regra segura:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>se o cliente informar o telefone numa conversa que já tem BSUID, atualize o \u003Cstrong>mesmo\u003C\u002Fstrong> contato;\u003C\u002Fli>\n\u003Cli>se um telefone novo coincidir com um contato já existente, peça confirmação de uma pessoa antes de unir os cadastros;\u003C\u002Fli>\n\u003Cli>registre quem fez a mesclagem e quando.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"dica-para-quem-usa-planilha-ou-crm-pronto\">Dica para quem usa planilha ou CRM pronto\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch2 id=\"bsuid-whatsapp-o-que-muda-no-seu-crm-na-pratica\">BSUID WhatsApp: o que muda no seu CRM na prática\u003C\u002Fh2>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Momento\u003C\u002Fth>\n\u003Cth>Cadastro preso ao telefone\u003C\u002Fth>\n\u003Cth>Cadastro preparado\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Mensagem chega sem número\u003C\u002Ftd>\n\u003Ctd>Erro ou conversa solta\u003C\u002Ftd>\n\u003Ctd>Contato criado ou localizado pelo BSUID\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Cliente informa o telefone depois\u003C\u002Ftd>\n\u003Ctd>Cadastro duplicado\u003C\u002Ftd>\n\u003Ctd>Mesmo contato atualizado\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Cliente troca de número\u003C\u002Ftd>\n\u003Ctd>Histórico fica no cadastro antigo\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>user_id_update\u003C\u002Fcode> atualiza o contato existente\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Gestor consulta o histórico\u003C\u002Ftd>\n\u003Ctd>Busca só por telefone\u003C\u002Ftd>\n\u003Ctd>Busca por contato, com tudo junto\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>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.\u003C\u002Fp>\n\u003Cp>Esse é o ganho do BSUID WhatsApp bem tratado: o atendimento não depende de o cliente abrir mão da privacidade para ser reconhecido.\u003C\u002Fp>\n\u003Ch2 id=\"onde-a-api-e-os-webhooks-do-flowzap-se-encaixam\">Onde a API e os webhooks do FlowZap se encaixam\u003C\u002Fh2>\n\u003Cp>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 \u003Ca href=\"\u002Fdocs\">API e os webhooks\u003C\u002Fa> entram na arquitetura que você está preparando.\u003C\u002Fp>\n\u003Ch3 id=\"recebimento-o-handler-do-seu-sistema-nao-pode-exigir-telefone-preenchido\">Recebimento: o handler do seu sistema não pode exigir telefone preenchido\u003C\u002Fh3>\n\u003Cp>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 \u003Ccode>contact_id\u003C\u002Fcode> novo se for o caso e responder sucesso ao webhook. Em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa> 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 \u003Ca href=\"\u002Fblog\u002Fwebhook-whatsapp-n8n\">webhook do WhatsApp no n8n\u003C\u002Fa>. Para acompanhar eventos ao vivo, os eventos em tempo real (SSE) são outra opção.\u003C\u002Fp>\n\u003Ch3 id=\"envio-guardar-a-referencia-da-conversa-nao-so-o-numero\">Envio: guardar a referência da conversa, não só o número\u003C\u002Fh3>\n\u003Cp>Na hora de responder, evite montar a integração com o telefone como único parâmetro. Guarde, junto do \u003Ccode>contact_id\u003C\u002Fcode>, 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.\u003C\u002Fp>\n\u003Ch3 id=\"crm-e-campos-personalizados-para-telefone-e-e-mail-coletados-com-permissao\">CRM e campos personalizados para telefone e e-mail coletados com permissão\u003C\u002Fh3>\n\u003Cp>O \u003Ca href=\"\u002Fproduto\">CRM do FlowZap\u003C\u002Fa> 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.\u003C\u002Fp>\n\u003Ch3 id=\"o-que-conferir-antes-de-depender-de-bsuid\">O que conferir antes de depender de BSUID\u003C\u002Fh3>\n\u003Cp>Antes de apostar o seu processo no BSUID, confira em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa> o que cada evento traz hoje. Se tiver dúvida sobre identificadores, \u003Ca href=\"\u002Fcontato\">fale com a equipe\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"lgpd-peca-o-telefone-so-quando-precisar-e-com-permissao\">LGPD: peça o telefone só quando precisar e com permissão\u003C\u002Fh2>\n\u003Cp>O telefone é dado pessoal. A Lei Geral de Proteção de Dados (Lei 13.709\u002F2018) 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.\u003C\u002Fp>\n\u003Ch3 id=\"quando-pedir-telefone-e-e-mail\">Quando pedir telefone e e-mail\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fblog\u002Ffunil-de-vendas-whatsapp\">funil de vendas no WhatsApp\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"quem-nao-autorizou-nao-recebe-campanha\">Quem não autorizou não recebe campanha\u003C\u002Fh3>\n\u003Cp>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.\u003C\u002Fp>\n\u003Ch2 id=\"plano-de-acao-em-5-passos-para-a-sua-equipe\">Plano de ação em 5 passos para a sua equipe\u003C\u002Fh2>\n\u003Cp>Para não deixar o tema parado, divida o trabalho entre quem desenvolve, quem atende e quem decide.\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Cstrong>Mapear onde o telefone é usado como chave\u003C\u002Fstrong> (desenvolvedor). Olhe o banco, as planilhas e as integrações. Liste tudo que quebra se o número vier vazio.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Criar \u003Ccode>contact_id\u003C\u002Fcode> e os campos \u003Ccode>phone_e164\u003C\u002Fcode> (aceitando nulo) e \u003Ccode>bsuid\u003C\u002Fcode>\u003C\u002Fstrong> (desenvolvedor). Migre os contatos atuais mantendo o telefone preenchido.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Ajustar o handler do webhook e testar com um evento sem telefone\u003C\u002Fstrong> (desenvolvedor). Garanta que o sistema responde sucesso e cria ou localiza o contato.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Tratar \u003Ccode>user_id_update\u003C\u002Fcode> e definir a regra de mesclagem\u003C\u002Fstrong> (desenvolvedor e gestor de atendimento). Decidam juntos quem aprova a união de cadastros.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Revisar a política de coleta de dados\u003C\u002Fstrong> (dono e gestor de atendimento). Defina quando a equipe pede telefone e e-mail e onde registra.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Como próximos passos, leia a \u003Ca href=\"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fbusiness-scoped-user-ids\u002F\" rel=\"noopener noreferrer\" target=\"_blank\">documentação oficial da Meta\u003C\u002Fa>, confira em \u003Ca href=\"\u002Fdocs\">\u002Fdocs\u003C\u002Fa> os eventos do FlowZap e, se quiser entender o cenário de custos da API, leia \u003Ca href=\"\u002Fblog\u002Fapi-do-whatsapp-e-paga\">API do WhatsApp é paga? O que muda em outubro de 2026\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"comece-com-o-flowzap\">Comece com o FlowZap\u003C\u002Fh2>\n\u003Cp>Veja \u003Ca href=\"\u002Fproduto\">o que o FlowZap faz\u003C\u002Fa> e \u003Ca href=\"\u002Fprecos\">compare os planos\u003C\u002Fa>. 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.\u003C\u002Fp>\n",[21,25,29,32,35,38,41,44,47,50,53,56,59,62,65,68,71,74,77,80,83,86,89,92,95,98,101,104,107,110],{"id":22,"text":23,"level":24},"bsuid-whatsapp-o-que-e-e-o-que-ele-nao-e","BSUID WhatsApp: o que é e o que ele não é",2,{"id":26,"text":27,"level":28},"formato-tipico-prefixo-de-pais-e-codigo-opaco","Formato típico: prefixo de país e código opaco",3,{"id":30,"text":31,"level":28},"por-que-o-mesmo-cliente-tem-bsuids-diferentes-em-empresas-diferentes","Por que o mesmo cliente tem BSUIDs diferentes em empresas diferentes",{"id":33,"text":34,"level":24},"username-no-whatsapp-por-que-o-telefone-pode-sumir-do-atendimento","Username no WhatsApp: por que o telefone pode sumir do atendimento",{"id":36,"text":37,"level":28},"como-funciona-o-username-para-quem-fala-com-empresas","Como funciona o @username para quem fala com empresas",{"id":39,"text":40,"level":28},"o-que-a-meta-publicou-e-quando","O que a Meta publicou e quando",{"id":42,"text":43,"level":28},"numero-de-telefone-oculto-no-whatsapp-o-que-muda-na-pratica","Número de telefone oculto no WhatsApp: o que muda na prática",{"id":45,"text":46,"level":24},"por-que-ddd-telefone-como-chave-no-crm-deixa-de-bastar","Por que DDD + telefone como chave no CRM deixa de bastar",{"id":48,"text":49,"level":28},"o-que-quebra-campo-obrigatorio-chave-unica-e-deduplicacao-por-telefone","O que quebra: campo obrigatório, chave única e deduplicação por telefone",{"id":51,"text":52,"level":28},"o-que-perde-valor-cruzar-listas-externas-so-pelo-numero","O que perde valor: cruzar listas externas só pelo número",{"id":54,"text":55,"level":28},"exemplo-do-dia-a-dia-o-contato-que-nao-vira-cadastro","Exemplo do dia a dia: o contato que não vira cadastro",{"id":57,"text":58,"level":24},"checklist-de-modelagem-como-adaptar-o-crm-ao-bsuid","Checklist de modelagem: como adaptar o CRM ao BSUID",{"id":60,"text":61,"level":28},"1-id-interno-do-contato-como-chave-primaria-contact-id","1. ID interno do contato como chave primária (contact_id)",{"id":63,"text":64,"level":28},"2-telefone-opcional-phone-e164-aceitando-nulo","2. Telefone opcional: phone_e164 aceitando nulo",{"id":66,"text":67,"level":28},"3-campo-extra-e-indexado-para-o-bsuid","3. Campo extra e indexado para o BSUID",{"id":69,"text":70,"level":28},"4-historico-preso-ao-contact-id-nao-ao-telefone","4. Histórico preso ao contact_id, não ao telefone",{"id":72,"text":73,"level":28},"5-tratar-o-evento-user-id-update-sem-duplicar-contatos","5. Tratar o evento user_id_update sem duplicar contatos",{"id":75,"text":76,"level":28},"6-regra-de-mesclagem-quando-telefone-e-bsuid-se-encontram","6. Regra de mesclagem: quando telefone e BSUID se encontram",{"id":78,"text":79,"level":28},"dica-para-quem-usa-planilha-ou-crm-pronto","Dica para quem usa planilha ou CRM pronto",{"id":81,"text":82,"level":24},"bsuid-whatsapp-o-que-muda-no-seu-crm-na-pratica","BSUID WhatsApp: o que muda no seu CRM na prática",{"id":84,"text":85,"level":24},"onde-a-api-e-os-webhooks-do-flowzap-se-encaixam","Onde a API e os webhooks do FlowZap se encaixam",{"id":87,"text":88,"level":28},"recebimento-o-handler-do-seu-sistema-nao-pode-exigir-telefone-preenchido","Recebimento: o handler do seu sistema não pode exigir telefone preenchido",{"id":90,"text":91,"level":28},"envio-guardar-a-referencia-da-conversa-nao-so-o-numero","Envio: guardar a referência da conversa, não só o número",{"id":93,"text":94,"level":28},"crm-e-campos-personalizados-para-telefone-e-e-mail-coletados-com-permissao","CRM e campos personalizados para telefone e e-mail coletados com permissão",{"id":96,"text":97,"level":28},"o-que-conferir-antes-de-depender-de-bsuid","O que conferir antes de depender de BSUID",{"id":99,"text":100,"level":24},"lgpd-peca-o-telefone-so-quando-precisar-e-com-permissao","LGPD: peça o telefone só quando precisar e com permissão",{"id":102,"text":103,"level":28},"quando-pedir-telefone-e-e-mail","Quando pedir telefone e e-mail",{"id":105,"text":106,"level":28},"quem-nao-autorizou-nao-recebe-campanha","Quem não autorizou não recebe campanha",{"id":108,"text":109,"level":24},"plano-de-acao-em-5-passos-para-a-sua-equipe","Plano de ação em 5 passos para a sua equipe",{"id":111,"text":112,"level":24},"comece-com-o-flowzap","Comece com o FlowZap",13,[115,118,121,124,127],{"a":116,"q":117},"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 que é BSUID no WhatsApp?",{"a":119,"q":120},"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.","O número de telefone fica oculto para todos os clientes?",{"a":122,"q":123},"É 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.","Posso continuar usando o telefone como chave primária no CRM?",{"a":125,"q":126},"É 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 que é o evento user_id_update?",{"a":128,"q":129},"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 \u002Fdocs os campos de cada evento e fale com a equipe em \u002Fcontato.","O FlowZap já suporta BSUID?",[131,134,136,139],{"url":132,"title":133},"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fbusiness-scoped-user-ids\u002F","facebook.com",{"url":135,"title":133},"https:\u002F\u002Fdevelopers.facebook.com\u002Fdocumentation\u002Fbusiness-messaging\u002Fwhatsapp\u002Fchangelog",{"url":137,"title":138},"https:\u002F\u002Fmedium.com\u002F@matthias_20536\u002Fmeta-bsuid-is-live-in-whatsapp-cloud-api-what-to-change-in-your-webhooks-and-crm-9b6dc69058dd","medium.com",{"url":140,"title":141},"https:\u002F\u002Fwww.quora.com\u002FWhat-is-WhatsApp-BSUID-business-scoped-user-ID-and-how-does-the-user_id_update-webhook-notification-work","quora.com",[143,144,145,146,147,148,149,150],"bsuid whatsapp","o que é bsuid whatsapp","business-scoped user id","username whatsapp empresas","identificador de usuário whatsapp api","chave primária telefone crm","whatsapp cloud api bsuid webhook","como adaptar crm ao bsuid","API e integrações de WhatsApp","index","2026-11-09T12:00:19.551551+00:00",{"slug":155,"name":156,"path":157,"url":158,"bio":159,"role_title":159,"same_as":160,"photo":161},"flowzap","FlowZap S\u002FA","\u002Fautores\u002Fflowzap","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap","",[],null,{"url":163,"path":164,"og_url":165,"width":166,"height":167,"alt":168},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F591de656-bed1-4deb-bb9c-d8059585ab31.webp","\u002Fmedia\u002Fblog\u002F591de656-bed1-4deb-bb9c-d8059585ab31.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F591de656-bed1-4deb-bb9c-d8059585ab31.jpg",1600,900,"Mesa de trabalho com notebook exibindo a ficha de um contato sem número de telefone, ao lado de um bloco de notas com",[170,193,216],{"type":6,"slug":171,"path":172,"url":173,"title":174,"meta_description":175,"published_at":176,"updated_at":176,"reading_minutes":177,"keywords":178,"cluster":151,"author":187,"cover":188},"whatsapp-mcp-claude-chatgpt","\u002Fblog\u002Fwhatsapp-mcp-claude-chatgpt","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwhatsapp-mcp-claude-chatgpt","WhatsApp MCP Claude: como usar o conector com a IA","WhatsApp MCP Claude: entenda o que é o MCP, como usar o conector do FlowZap com Claude e ChatGPT e quais cuidados tomar com acesso e LGPD.","2026-11-16T12:00:11.965959+00:00",12,[179,180,181,182,183,184,185,186],"whatsapp mcp claude","conector mcp whatsapp","whatsapp chatgpt integração","usar whatsapp no claude","mcp para atendimento","o que é mcp","integrar whatsapp com chatgpt","automação whatsapp com ia",{"name":156,"slug":155,"path":157},{"url":189,"path":190,"og_url":191,"width":166,"height":167,"alt":192},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.webp","\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F66723860-caca-4fe9-8b01-6ddcab5a950b.jpg","Mesa de trabalho com notebook exibindo uma conversa de atendimento, ao lado de uma janela de assistente de IA ligadas por um",{"type":6,"slug":194,"path":195,"url":196,"title":197,"meta_description":198,"published_at":199,"updated_at":199,"reading_minutes":200,"keywords":201,"cluster":151,"author":210,"cover":211},"webhook-ou-sse-whatsapp","\u002Fblog\u002Fwebhook-ou-sse-whatsapp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fwebhook-ou-sse-whatsapp","Webhook ou SSE WhatsApp: qual usar na sua integração","Webhook ou SSE WhatsApp: veja quando usar cada um, com critérios de decisão, retentativas, assinatura e chaves por número. Leia e escolha certo.","2026-11-13T12:00:29.806432+00:00",14,[202,203,204,205,206,207,208,209],"webhook ou sse whatsapp","webhook whatsapp api","eventos em tempo real whatsapp","server-sent events whatsapp","webhook assinado whatsapp","novas tentativas de webhook","api rest whatsapp chaves por número","integrar whatsapp com sistema próprio",{"name":156,"slug":155,"path":157},{"url":212,"path":213,"og_url":214,"width":166,"height":167,"alt":215},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.webp","\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002Ff70fcd2c-de5f-4147-adbd-87a72ddbee5b.jpg","Ilustração de um celular com WhatsApp do qual saem duas rotas luminosas: uma leva a um servidor com engrenagens e fila de",{"type":6,"slug":217,"path":218,"url":219,"title":220,"meta_description":221,"published_at":222,"updated_at":222,"reading_minutes":113,"keywords":223,"cluster":151,"author":232,"cover":233},"custo-por-mensagem-whatsapp-api","\u002Fblog\u002Fcusto-por-mensagem-whatsapp-api","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fcusto-por-mensagem-whatsapp-api","Custo por mensagem WhatsApp API: como reduzir em 2026","Custo por mensagem WhatsApp API: veja como desenhar menu, respostas rápidas e modelos para resolver com menos trocas. Leia o passo a passo.","2026-11-12T12:00:27.172848+00:00",[224,225,226,227,228,229,230,231],"custo por mensagem whatsapp api","quanto custa mensagem whatsapp api","cobrança janela de 24h whatsapp","reduzir custo atendimento whatsapp","api do whatsapp business valores","mensagens de serviço whatsapp cobrança","fluxo de sac no whatsapp","eficiência no atendimento por whatsapp",{"name":156,"slug":155,"path":157},{"url":234,"path":235,"og_url":236,"width":166,"height":167,"alt":237},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.webp","\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.webp","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fmedia\u002Fblog\u002F9bfd8c71-5cd4-4cd2-b392-a21f3e595447.jpg","Mesa de atendimento com celular exibindo menu numerado, notebook com caixa de conversas organizada e gráfico de linha em",{"@context":239,"@graph":240},"https:\u002F\u002Fschema.org",[241,247,250,258,269,272],{"@type":242,"@id":243,"name":244,"url":245,"logo":246},"Organization","https:\u002F\u002Fflowzap.flowpost.com.br\u002F#organization","FlowZap","https:\u002F\u002Fflowzap.flowpost.com.br\u002F","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fog\u002Fflowzap.png",{"@type":248,"@id":9,"url":9,"name":10,"inLanguage":249},"WebPage","pt-BR",{"@type":251,"@id":252,"url":9,"description":12,"inLanguage":249,"mainEntityOfPage":253,"image":165,"headline":10,"datePublished":153,"dateModified":153,"author":254,"publisher":256,"keywords":257,"articleSection":151},"BlogPosting","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fbsuid-whatsapp#content",{"@id":9},{"@id":255},"https:\u002F\u002Fflowzap.flowpost.com.br\u002Fautores\u002Fflowzap#person",{"@id":243},"bsuid whatsapp, o que é bsuid whatsapp, business-scoped user id, username whatsapp empresas, identificador de usuário whatsapp api, chave primária telefone crm, whatsapp cloud api bsuid webhook, como adaptar crm ao bsuid",{"@type":259,"itemListElement":260},"BreadcrumbList",[261,265,268],{"@type":262,"position":263,"name":264,"item":245},"ListItem",1,"Início",{"@type":262,"position":24,"name":266,"item":267},"Blog","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog",{"@type":262,"position":28,"name":10,"item":9},{"@type":270,"@id":255,"name":156,"url":158,"worksFor":271},"Person",{"@id":243},{"@type":273,"@id":274,"mainEntity":275},"FAQPage","https:\u002F\u002Fflowzap.flowpost.com.br\u002Fblog\u002Fbsuid-whatsapp#faq",[276,280,282,284,286],{"@type":277,"name":117,"acceptedAnswer":278},"Question",{"@type":279,"text":116},"Answer",{"@type":277,"name":120,"acceptedAnswer":281},{"@type":279,"text":119},{"@type":277,"name":123,"acceptedAnswer":283},{"@type":279,"text":122},{"@type":277,"name":126,"acceptedAnswer":285},{"@type":279,"text":125},{"@type":277,"name":129,"acceptedAnswer":287},{"@type":279,"text":128}]