{"id":456,"date":"2026-10-28T16:00:31","date_gmt":"2026-10-28T16:00:31","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/"},"modified":"2026-10-28T16:00:39","modified_gmt":"2026-10-28T16:00:39","slug":"usernames-whatsapp-bsuid","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/","title":{"rendered":"Usernames do WhatsApp e BSUID: o que muda para quem usa a API"},"content":{"rendered":"\n<p><em>Atualizado em 28\/10\/2026<\/em><\/p>\n\n\n\n<p>Usernames s\u00e3o nomes \u00fanicos e opcionais que usu\u00e1rios e empresas podem adotar no WhatsApp; quando um cliente ativa o dele, o n\u00famero de telefone pode deixar de chegar nos webhooks da API. Para que as integra\u00e7\u00f5es continuem identificando quem escreveu, a Meta criou o BSUID (business-scoped user ID), um identificador do usu\u00e1rio v\u00e1lido s\u00f3 dentro do seu portf\u00f3lio empresarial. Desde abril de 2026 ele aparece nos webhooks, e desde julho de 2026 a API aceita enviar mensagens para ele.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que s\u00e3o usernames no WhatsApp<\/h2>\n\n\n\n<p>Segundo a <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-scoped-user-ids\" target=\"_blank\" rel=\"noreferrer noopener\">documenta\u00e7\u00e3o de BSUID da Meta<\/a>, o username \u00e9 um nome que o usu\u00e1rio pode definir para aparecer no app no lugar do n\u00famero de telefone. Cada pessoa tem no m\u00e1ximo um, pode troc\u00e1-lo de tempos em tempos, e a troca n\u00e3o altera nem o n\u00famero nem o BSUID. Adotar um username \u00e9 opcional, tanto para pessoas quanto para empresas.<\/p>\n\n\n\n<p>Do lado da empresa existe o <strong>username comercial<\/strong>. Ele n\u00e3o esconde o n\u00famero da empresa (a Meta deixa claro que usernames comerciais n\u00e3o s\u00e3o um recurso de privacidade) e cada username aponta para um \u00fanico n\u00famero comercial. As regras de formato s\u00e3o:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>s\u00f3 letras do alfabeto ingl\u00eas, d\u00edgitos, ponto e sublinhado;<\/li>\n\n\n<li>de 3 a 35 caracteres, com pelo menos uma letra;<\/li>\n\n\n<li>n\u00e3o pode come\u00e7ar nem terminar com ponto, nem ter dois pontos seguidos;<\/li>\n\n\n<li>n\u00e3o pode come\u00e7ar com <code>www.<\/code> nem terminar com sufixo de dom\u00ednio, como <code>.com<\/code>;<\/li>\n\n\n<li>mai\u00fasculas e min\u00fasculas s\u00e3o iguais, mas ponto e sublinhado contam: <code>minhaloja<\/code>, <code>minha.loja<\/code> e <code>minha_loja<\/code> s\u00e3o nomes diferentes.<\/li>\n\n<\/ul>\n\n\n\n<p>Desde 29 de junho de 2026 as empresas podem reservar e adotar o username pelo Meta Business Suite, pelo Gerenciador do WhatsApp, pelo app WhatsApp Business ou pela API. Na atualiza\u00e7\u00e3o de 23 de outubro de 2026, a Meta incluiu um limite: cada n\u00famero comercial pode trocar de username at\u00e9 2 vezes em 14 dias corridos (10 vezes para usernames reservados). Passou disso, a API devolve o erro <code>130429<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que \u00e9 o BSUID<\/h2>\n\n\n\n<p>O BSUID identifica um usu\u00e1rio do WhatsApp para uma empresa espec\u00edfica. Pela documenta\u00e7\u00e3o, ele \u00e9:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>gerado automaticamente, tenha o usu\u00e1rio um username ou n\u00e3o;<\/li>\n\n\n<li>formado pelo c\u00f3digo de pa\u00eds ISO 3166 alfa-2, um ponto e at\u00e9 128 caracteres alfanum\u00e9ricos, por exemplo <code>US.13491208655302741918<\/code>;<\/li>\n\n\n<li>\u00fanico por par usu\u00e1rio + portf\u00f3lio empresarial (o antigo Business Manager);<\/li>\n\n\n<li>regenerado quando o usu\u00e1rio troca de n\u00famero de telefone.<\/li>\n\n<\/ul>\n\n\n\n<p>O escopo \u00e9 o ponto que mais pega: um BSUID s\u00f3 funciona com n\u00fameros do mesmo portf\u00f3lio. Num SaaS, o BSUID que chegou no n\u00famero do cliente A n\u00e3o serve para enviar pelo n\u00famero do cliente B.<\/p>\n\n\n\n<p>Empresas com v\u00e1rios portf\u00f3lios podem pedir \u00e0 Meta o <strong>BSUID principal<\/strong> (parent BSUID), que vale em todos os portf\u00f3lios inscritos. Ele tem <code>ENT<\/code> depois do c\u00f3digo do pa\u00eds (<code>US.ENT.11815799212886844830<\/code>) e chega no campo <code>parent_user_id<\/code>. A inscri\u00e7\u00e3o depende de elegibilidade avaliada pelo contato da Meta.<\/p>\n\n\n\n<p>A Meta afirma que o suporte a BSUID \u00e9 obrigat\u00f3rio para parceiros, empresas com integra\u00e7\u00e3o direta e anunciantes de an\u00fancios de clique para o WhatsApp, porque ningu\u00e9m controla quando um cliente vai ativar o username.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Campos novos nos webhooks<\/h2>\n\n\n\n<p>O BSUID aparece em todo webhook que normalmente traria o telefone. A tabela resume os campos documentados:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Webhook<\/th><th>Campo<\/th><th>O que traz<\/th><\/tr><\/thead><tbody><tr><td>Mensagem recebida<\/td><td><code>contacts[].user_id<\/code><\/td><td>BSUID do usu\u00e1rio<\/td><\/tr><tr><td>Mensagem recebida<\/td><td><code>contacts[].profile.username<\/code><\/td><td>Username, s\u00f3 se o usu\u00e1rio tiver um<\/td><\/tr><tr><td>Mensagem recebida<\/td><td><code>messages[].from<\/code><\/td><td>Telefone (pode ser omitido)<\/td><\/tr><tr><td>Mensagem recebida<\/td><td><code>messages[].from_user_id<\/code><\/td><td>BSUID<\/td><\/tr><tr><td>Status<\/td><td><code>statuses[].recipient_id<\/code><\/td><td>Telefone (pode ser omitido)<\/td><\/tr><tr><td>Status<\/td><td><code>statuses[].recipient_user_id<\/code><\/td><td>BSUID, sempre inclu\u00eddo (exceto em <code>failed<\/code> enviado por telefone)<\/td><\/tr><tr><td>Qualquer um, se habilitado<\/td><td><code>parent_user_id<\/code>, <code>from_parent_user_id<\/code>, <code>recipient_parent_user_id<\/code><\/td><td>BSUID principal<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Um webhook de mensagem recebida de quem ativou o username e com quem voc\u00ea n\u00e3o falou nos \u00faltimos 30 dias pode chegar assim, sem telefone:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"contacts\": [\n    {\n      \"profile\": { \"name\": \"Pablo M.\", \"username\": \"pablomorales\" },\n      \"user_id\": \"BR.13491208655302741918\"\n    }\n  ],\n  \"messages\": [\n    {\n      \"from_user_id\": \"BR.13491208655302741918\",\n      \"id\": \"wamid.HBgL...\",\n      \"timestamp\": \"1761650000\",\n      \"type\": \"text\",\n      \"text\": { \"body\": \"Oi, meu pedido chegou?\" }\n    }\n  ]\n}<\/code><\/pre>\n\n\n\n<p>Webhooks de <code>user_preferences<\/code>, grupos e chamadas tamb\u00e9m ganharam os campos. E o novo <code>business_username_updates<\/code> avisa quando o status do username da empresa muda (<code>context: \"revoked\"<\/code> quando a Meta revoga o nome).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quando o telefone ainda vem no webhook<\/h3>\n\n\n\n<p>Mesmo com o username ativo, o n\u00famero do usu\u00e1rio continua no payload se pelo menos uma condi\u00e7\u00e3o for verdadeira:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>voc\u00ea enviou mensagem ou ligou para aquele n\u00famero nos \u00faltimos 30 dias;<\/li>\n\n\n<li>voc\u00ea recebeu mensagem ou liga\u00e7\u00e3o daquele n\u00famero nos \u00faltimos 30 dias;<\/li>\n\n\n<li>o usu\u00e1rio est\u00e1 no seu contact book.<\/li>\n\n<\/ol>\n\n\n\n<p>As duas primeiras condi\u00e7\u00f5es s\u00e3o avaliadas <strong>por n\u00famero comercial<\/strong>, n\u00e3o por portf\u00f3lio. Se o cliente fala com o n\u00famero de vendas, o webhook do n\u00famero de suporte pode chegar sem telefone.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Troca de n\u00famero e troca de BSUID<\/h3>\n\n\n\n<p>Quando o usu\u00e1rio troca de n\u00famero, o BSUID \u00e9 regenerado e voc\u00ea recebe uma mensagem de sistema no campo <code>messages<\/code> com <code>system.type<\/code> igual a <code>user_changed_number<\/code>, trazendo <code>user_id<\/code>, <code>previous_user_id<\/code> e <code>wa_id<\/code> quando pode compartilhar o n\u00famero. Se o n\u00famero n\u00e3o puder ser compartilhado, o tipo \u00e9 <code>user_changed_user_id<\/code> e s\u00f3 os identificadores mudam. Basta assinar <code>messages<\/code> (<code>user_id_update<\/code> n\u00e3o \u00e9 um campo assin\u00e1vel). Detalhes do formato geral dos eventos est\u00e3o em <a href=\"https:\/\/vectalk.com.br\/blog\/webhook-whatsapp-api\/\">webhooks da API do WhatsApp<\/a> e em <a href=\"https:\/\/vectalk.com.br\/blog\/status-mensagem-webhook-whatsapp\/\">status de mensagem via webhook<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Como enviar mensagem por BSUID<\/h2>\n\n\n\n<p>Desde julho de 2026, o <code>POST \/&lt;PHONE_NUMBER_ID&gt;\/messages<\/code> aceita o campo <code>recipient<\/code> com o BSUID no lugar de <code>to<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl -X POST 'https:\/\/graph.facebook.com\/&lt;API_VERSION&gt;\/&lt;PHONE_NUMBER_ID&gt;\/messages' \\\n  -H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"recipient_type\": \"individual\",\n    \"recipient\": \"BR.13491208655302741918\",\n    \"type\": \"text\",\n    \"text\": { \"body\": \"Seu pedido saiu para entrega.\" }\n  }'<\/code><\/pre>\n\n\n\n<p>Regras que valem a pena gravar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Use o valor inteiro.<\/strong> C\u00f3digo do pa\u00eds, ponto e todos os caracteres. Qualquer altera\u00e7\u00e3o faz a requisi\u00e7\u00e3o falhar.<\/li>\n\n\n<li><strong><code>to<\/code> ganha de <code>recipient<\/code>.<\/strong> Se voc\u00ea mandar os dois, a Meta usa o telefone.<\/li>\n\n\n<li><strong>Exce\u00e7\u00e3o: autentica\u00e7\u00e3o.<\/strong> Templates de autentica\u00e7\u00e3o one-tap, zero-tap e copy code exigem o telefone. Mand\u00e1-los para um BSUID retorna o erro <code>131062<\/code>.<\/li>\n\n\n<li><strong>Escopo do portf\u00f3lio.<\/strong> BSUID de outro portf\u00f3lio n\u00e3o funciona.<\/li>\n\n<\/ul>\n\n\n\n<p>Na <a href=\"https:\/\/vectalk.com.br\/blog\/marketing-messages-api-whatsapp\/\">Marketing Messages API<\/a> o envio por BSUID tamb\u00e9m existe desde 5 de maio de 2026, mas a Meta avisa que a otimiza\u00e7\u00e3o de entrega n\u00e3o roda nesses envios e recomenda usar o telefone quando voc\u00ea tiver.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Pedir o telefone ao cliente<\/h3>\n\n\n\n<p>Se o contato s\u00f3 tem BSUID e voc\u00ea precisa do n\u00famero (para nota fiscal, cobran\u00e7a ou OTP), a Meta criou o bot\u00e3o <code>REQUEST_CONTACT_INFO<\/code>. Ele pode entrar em templates de utilidade e marketing ou ser enviado como mensagem interativa. Quando o usu\u00e1rio toca, o n\u00famero \u00e9 compartilhado na conversa e chega um webhook de contatos com <code>origin: \"contact_request\"<\/code>. O texto do bot\u00e3o n\u00e3o \u00e9 personaliz\u00e1vel.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Contact book: a agenda que a Meta guarda para voc\u00ea<\/h2>\n\n\n\n<p>O contact book \u00e9 hospedado pela Meta e n\u00e3o exige integra\u00e7\u00e3o. Depois que o recurso \u00e9 lan\u00e7ado, toda intera\u00e7\u00e3o (mensagem ou liga\u00e7\u00e3o, enviada ou recebida) entre um n\u00famero do portf\u00f3lio e um usu\u00e1rio grava o telefone e o BSUID dele. A partir da\u00ed, os webhooks daquele usu\u00e1rio trazem o telefone mesmo que ele ative o username.<\/p>\n\n\n\n<p>Pontos de aten\u00e7\u00e3o:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>n\u00e3o \u00e9 retroativo: conversas anteriores ao lan\u00e7amento n\u00e3o entram;<\/li>\n\n\n<li>o escopo \u00e9 o portf\u00f3lio empresarial;<\/li>\n\n\n<li>os dados ficam at\u00e9 voc\u00ea desativar o recurso (em Meta Business Suite &gt; Configura\u00e7\u00f5es da empresa &gt; Informa\u00e7\u00f5es da empresa) ou a conta; desativar apaga tudo, e reativar n\u00e3o restaura;<\/li>\n\n\n<li>pela API, <code>GET \/&lt;PHONE_NUMBER_ID&gt;\/contact_book<\/code> diz se existe telefone guardado para um BSUID (campo <code>present<\/code>), sem nunca devolver o n\u00famero, e um <code>DELETE<\/code> remove a entrada.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Impacto no CRM que usa telefone como chave<\/h2>\n\n\n\n<p>A maioria das integra\u00e7\u00f5es usa <code>wa_id<\/code> ou <code>from<\/code> como chave prim\u00e1ria do contato. Com usernames, mensagens podem chegar sem telefone e o BSUID muda quando o cliente troca de n\u00famero.<\/p>\n\n\n\n<p>Um modelo que resiste a isso:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Crie uma tabela de identidades<\/strong>, n\u00e3o uma coluna. Cada contato pode ter telefone, BSUID por portf\u00f3lio e BSUID principal.<\/li>\n\n\n<li><strong>Procure por BSUID primeiro<\/strong>, depois por telefone. Se achar pelos dois e forem contatos diferentes, fa\u00e7a merge.<\/li>\n\n\n<li><strong>Grave o par telefone + BSUID sempre que vierem juntos.<\/strong> \u00c9 assim que voc\u00ea reconhece o cliente quando ele aparecer s\u00f3 com BSUID.<\/li>\n\n\n<li><strong>Trate <code>user_changed_number<\/code> e <code>user_changed_user_id<\/code><\/strong> atualizando o BSUID a partir de <code>previous_user_id<\/code>.<\/li>\n\n\n<li><strong>Responda pelo mesmo n\u00famero comercial<\/strong> quando poss\u00edvel, por causa da regra dos 30 dias por n\u00famero.<\/li>\n\n\n<li><strong>Teste antes de ver em produ\u00e7\u00e3o.<\/strong> O Painel de Apps tem um bot\u00e3o <em>Test<\/em> no webhook de mensagens com cen\u00e1rios de usu\u00e1rio com e sem username.<\/li>\n\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-js\">async function resolverContato(value) {\n  const c = value.contacts?.[0] ?? {};\n  const msg = value.messages?.[0] ?? {};\n  const bsuid = c.user_id ?? msg.from_user_id;\n  const telefone = msg.from ?? c.wa_id; \/\/ pode vir vazio\n\n  let contato = bsuid ? await db.contatoPorBsuid(bsuid) : null;\n  if (!contato &amp;&amp; telefone) contato = await db.contatoPorTelefone(telefone);\n  if (!contato) contato = await db.criarContato();\n\n  await db.vincular(contato.id, { bsuid, telefone, username: c.profile?.username });\n  return contato;\n}<\/code><\/pre>\n\n\n\n<p>Se o seu fluxo depende de an\u00fancios, o mesmo cuidado vale para atribui\u00e7\u00e3o: veja <a href=\"https:\/\/vectalk.com.br\/blog\/rastrear-anuncio-click-to-whatsapp\/\">como rastrear an\u00fancios Click-to-WhatsApp<\/a>. E mudan\u00e7as paralelas na conta, como a <a href=\"https:\/\/vectalk.com.br\/blog\/conta-whatsapp-conta-de-mensagens-waba\/\">nova estrutura da WABA<\/a>, tamb\u00e9m afetam IDs que seu CRM guarda.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Cronograma confirmado na documenta\u00e7\u00e3o da Meta<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Data<\/th><th>O que aconteceu<\/th><\/tr><\/thead><tbody><tr><td>In\u00edcio de abril de 2026<\/td><td>BSUIDs come\u00e7am a aparecer nos webhooks<\/td><\/tr><tr><td>5 de maio de 2026<\/td><td><code>\/marketing_messages<\/code> aceita envio por BSUID<\/td><\/tr><tr><td>29 de junho de 2026<\/td><td>Empresas podem reservar e adotar username comercial<\/td><\/tr><tr><td>Julho de 2026<\/td><td>Cloud API aceita envio por BSUID; bot\u00e3o <code>REQUEST_CONTACT_INFO<\/code> dispon\u00edvel<\/td><\/tr><tr><td>24 de agosto de 2026<\/td><td>Consulta ao contact book (<code>GET ...\/contact_book<\/code>)<\/td><\/tr><tr><td>23 de outubro de 2026<\/td><td>Limite de troca de username (2 a cada 14 dias) e erro <code>130429<\/code><\/td><\/tr><tr><td>2026<\/td><td>WhatsApp libera usernames aos usu\u00e1rios de forma gradual<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>A Meta n\u00e3o publicou data \u00fanica para todos os usu\u00e1rios terem username; a p\u00e1gina fala s\u00f3 em libera\u00e7\u00e3o gradual em 2026. Acompanhamos as pr\u00f3ximas mudan\u00e7as em <a href=\"https:\/\/vectalk.com.br\/blog\/novidades-api-whatsapp-2026\/\">novidades da API do WhatsApp em 2026<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Como fica na Vectalk<\/h2>\n\n\n\n<p>A Vectalk \u00e9 um proxy da <a href=\"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/\">API oficial do WhatsApp<\/a>: os webhooks que voc\u00ea registra com <code>POST \/api\/webhooks<\/code> recebem o mesmo payload que a Meta envia, ent\u00e3o <code>user_id<\/code>, <code>from_user_id<\/code>, <code>username<\/code> e as mensagens de sistema chegam sem tradu\u00e7\u00e3o. O que precisa mudar est\u00e1 no seu c\u00f3digo, no modelo de contato descrito acima. A refer\u00eancia dos eventos est\u00e1 na <a href=\"https:\/\/docs.vectalk.com.br\/concepts\/webhooks\">documenta\u00e7\u00e3o de webhooks<\/a>, e o cadastro \u00e9 feito em <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Perguntas frequentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">O cliente que ativar username vai sumir do meu CRM?<\/h3>\n\n\n\n<p>N\u00e3o, se a integra\u00e7\u00e3o j\u00e1 l\u00ea o BSUID. O BSUID chega em todo webhook, com ou sem username. O que pode faltar \u00e9 o telefone, quando n\u00e3o houve conversa nos \u00faltimos 30 dias naquele n\u00famero e o cliente n\u00e3o est\u00e1 no contact book.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Posso enviar template de marketing para um BSUID?<\/h3>\n\n\n\n<p>Sim. O envio por BSUID aceita qualquer tipo de mensagem, menos templates de autentica\u00e7\u00e3o one-tap, zero-tap e copy code. Na Marketing Messages API, envios por BSUID n\u00e3o recebem otimiza\u00e7\u00e3o de entrega.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">O BSUID muda?<\/h3>\n\n\n\n<p>Muda quando o usu\u00e1rio troca de n\u00famero de telefone. Trocar de username n\u00e3o altera o BSUID. A mudan\u00e7a chega como mensagem de sistema no webhook <code>messages<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ter username esconde o n\u00famero da minha empresa?<\/h3>\n\n\n\n<p>N\u00e3o. A Meta diz que o username comercial n\u00e3o oculta o n\u00famero da empresa e n\u00e3o foi pensado como recurso de privacidade.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Um BSUID serve para todos os meus clientes de SaaS?<\/h3>\n\n\n\n<p>N\u00e3o. Ele \u00e9 restrito ao portf\u00f3lio empresarial em que foi gerado. Cada cliente ter\u00e1 BSUIDs pr\u00f3prios para os mesmos usu\u00e1rios.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Fontes oficiais consultadas em 28\/10\/2026:<\/strong> <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-scoped-user-ids\" target=\"_blank\" rel=\"noreferrer noopener\">Business-scoped user IDs<\/a> (atualizada em 23\/10\/2026), <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/changelog\" target=\"_blank\" rel=\"noreferrer noopener\">Changelog da plataforma do WhatsApp<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/marketing-messages\/send-marketing-messages\" target=\"_blank\" rel=\"noreferrer noopener\">Enviar mensagens de marketing (Marketing Messages API)<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Com os usernames, o telefone do cliente pode sumir do webhook. Veja o que \u00e9 o BSUID, os campos novos e como adaptar seu CRM.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[8],"tags":[],"class_list":["post-456","post","type-post","status-publish","format-standard","hentry","category-uncategorized-pt"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Username no WhatsApp Business e BSUID na API | Vectalk<\/title>\n<meta name=\"description\" content=\"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Username no WhatsApp Business e BSUID na API | Vectalk\" \/>\n<meta property=\"og:description\" content=\"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-28T16:00:31+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-28T16:00:39+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"Usernames do WhatsApp e BSUID: o que muda para quem usa a API\",\"datePublished\":\"2026-10-28T16:00:31+00:00\",\"dateModified\":\"2026-10-28T16:00:39+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/\"},\"wordCount\":1822,\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/\",\"name\":\"Username no WhatsApp Business e BSUID na API | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-28T16:00:31+00:00\",\"dateModified\":\"2026-10-28T16:00:39+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/usernames-whatsapp-bsuid\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Usernames do WhatsApp e BSUID: o que muda para quem usa a API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Username no WhatsApp Business e BSUID na API | Vectalk","description":"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/","og_locale":"en_US","og_type":"article","og_title":"Username no WhatsApp Business e BSUID na API | Vectalk","og_description":"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.","og_url":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-28T16:00:31+00:00","article_modified_time":"2026-10-28T16:00:39+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"Usernames do WhatsApp e BSUID: o que muda para quem usa a API","datePublished":"2026-10-28T16:00:31+00:00","dateModified":"2026-10-28T16:00:39+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/"},"wordCount":1822,"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/","url":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/","name":"Username no WhatsApp Business e BSUID na API | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-28T16:00:31+00:00","dateModified":"2026-10-28T16:00:39+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"Username no WhatsApp Business e BSUID: campos novos nos webhooks, envio por BSUID, contact book e como adaptar o CRM que usa o telefone como chave.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/usernames-whatsapp-bsuid\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"Usernames do WhatsApp e BSUID: o que muda para quem usa a API"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/456","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=456"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/456\/revisions"}],"predecessor-version":[{"id":459,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/456\/revisions\/459"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=456"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=456"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=456"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}