Pular para o conteúdo

Gupshup, BSUID e usernames: o que BSPs como a Gupshup estão fazendo

A Gupshup criou uma camada de identidade para a transição da Meta para BSUID e usernames no WhatsApp Business. Veja feature toggle, Identity Graph e mensagens estacionadas, e o que checar.

Cofundador da Tolky

Atualizado em 17 de novembro de 2026

9 min de leitura
Gupshup, BSUID e usernames: o que BSPs como a Gupshup estão fazendo

TL;DR

A Gupshup, um provedor de API do WhatsApp, ofereceu uma camada de compatibilidade para a mudança de identidade da Meta: o BSUID pode ser ativado por feature toggle, e a plataforma tenta manter o telefone sempre que o resolver. A Meta já entrega BSUID nos webhooks desde abril de 2026 e liberou usernames de empresa em 29/06/2026; o que importa agora é checar com o seu provedor o que está ativo e preparar CRM, bots e campanhas para contatos sem telefone.

Compartilhar

Esta é a resenha de um comunicado de um terceiro, a Gupshup, a respeito da transição do WhatsApp Business para BSUID e usernames. O texto descreve o que provedores como ela estão oferecendo e serve de checklist para qualquer empresa que acessa a API por um intermediário. Não descreve a infraestrutura da Tolky.

Como o tema já passou da fase de roadmap, vale a linha do tempo da Meta (documentação oficial): o BSUID aparece nos webhooks desde abril de 2026; em 29 de junho de 2026 empresas puderam reservar e adotar usernames corporativos; em julho o envio por BSUID e o botão de pedir telefone ficaram disponíveis; em 11/08 as trocas de BSUID passaram a chegar como mensagens de sistema (user_changed_user_id); e em 23/10 entrou o limite de 2 trocas de username a cada 14 dias.

O ponto de partida está no post sobre BSUID e usernames: o BSUID é o identificador de usuário escopado por negócio e permite responder a alguém mesmo sem o telefone. Aqui o foco é o que muda quando um provedor está no meio do caminho.

Atualizado em 17 de novembro de 2026.

Em resumo:

  • BSUID é o identificador de usuário escopado por negócio e permite responder sem o telefone da pessoa.
  • O telefone não some, mas deixou de ser garantia. Se o envio tiver telefone e BSUID, o telefone tem precedência; guarde os dois.
  • A Gupshup oferece uma camada de identidade (feature toggle de BSUID e Identity Graph); parte dos detalhes vem do comunicado dela, sem confirmação em documentação pública.
  • Prepare CRM, bots e relatórios para identidade híbrida: telefone, BSUID, username e uma chave canônica.
  • Peça por escrito ao provedor o estado do toggle e a política para mensagens estacionadas.

O que a Gupshup prometeu para a transição do BSUID?

Segundo o comunicado, a proposta é continuidade operacional: uma camada de identidade que resolve BSUID, telefone e username sempre que possível, com dois caminhos:

  1. ativar o suporte a BSUID e começar a receber o novo identificador;
  2. continuar operando com telefone enquanto a plataforma resolve a identidade por trás.

A mudança, portanto, não precisa ser uma migração de big bang. Mas tempo não é licença para ignorar o tema: é uma janela para preparar dados, relatórios, automações e atendimento humano para um mundo em que o telefone é condicional.

O que é o feature toggle de BSUID?

Em fontes públicas, a documentação de parceiros da Gupshup indica que, por padrão, a plataforma entrega apenas o telefone e omite os campos user_id nas assinaturas v2 e v3; para ativar existe uma API de parceiro por aplicativo (API para habilitar o BSUID). Com o BSUID habilitado, a Gupshup envia o BSUID junto do telefone enquanto ele estiver disponível; conforme os usernames se espalham, a combinação pode passar a BSUID mais username, ou apenas BSUID.

A decisão tem impacto de arquitetura:

  • Ativar cedo ajuda a enriquecer o CRM e testar deduplicação antes de o volume crescer.
  • Manter desligado reduz mudança imediata, mas pode esconder dependências perigosas do telefone.
  • Uma operação madura ativa em ambiente controlado, mede e só então libera em produção.

O erro é tratar o toggle como botão de "ligar depois". Quanto antes a base capturar BSUIDs, menor a chance de duplicar contatos quando conversas chegarem sem telefone. A página de suporte da Gupshup sobre Username / Business-Scoped User ID pode bloquear acessos automatizados; se não abrir, tente pelo navegador.

O que são o Identity Graph e as mensagens estacionadas?

O comunicado a parceiros descreve um Identity Graph: um repositório de mapeamento entre BSUID e telefone, alimentado por interações de entrada e saída. A cada mensagem, a plataforma tentaria responder "eu conheço o telefone por trás deste BSUID?". Se sim, preserva a experiência das integrações legadas; se não, a mensagem pode chegar só com BSUID ou ser retida.

Esse mecanismo também prevê mensagens "estacionadas": retidas por até 30 dias quando o telefone não está disponível, com uma API de recuperação indicada como futura. Esses detalhes vêm do comunicado da Gupshup e não foram confirmados em documentação pública; trate-os como informação do provedor e peça-a por escrito.

Também é importante separar duas coisas: o BSUID gerado para todos os usuários (a Meta já faz isso nos webhooks) e a adoção de username, que é gradual. Se o seu provedor diz que a geração de BSUID já cobre todos os usuários, isso é consistente com a Meta; não significa que todos já usem username.

Exemplo: o lead de anúncio com username

Imagine um lead de anúncio Click-to-WhatsApp que usa username e nunca falou com a empresa. A mensagem chega sem telefone. Se o provedor a retém como "estacionada", o lead fica parado, o SLA comercial estoura e a venda esfria. Um fluxo preparado cria o contato com o BSUID, responde dentro da janela de atendimento, pede o telefone com contexto se for necessário e mescla com o cadastro existente. A retenção é rede de proteção, não estratégia de atendimento.

O que são usernames empresariais?

O comunicado trata dos nomes de usuário empresariais: explorar sugestões da Meta, reservar ou solicitar um nome, acompanhar a aprovação e definir o username. Ele melhora a descoberta da marca; o BSUID resolve a identidade do usuário na relação com a empresa. São partes do mesmo movimento:

  • username empresarial: como clientes encontram a marca;
  • username de usuário final: como clientes conversam sem revelar o telefone;
  • BSUID: a identidade técnica estável dessa relação.

Como enviar campanhas para um BSUID?

O comunicado indica que, mesmo podendo enviar para BSUID, o Identity Graph tentará usar o telefone sempre que existir. Isso é coerente com a Meta: o envio aceita to (telefone) ou recipient (BSUID), e, com os dois, o telefone tem precedência. Três frentes pedem atenção:

Consentimento. BSUID não elimina opt-in, janela de atendimento e templates. Fora da janela de 24h, só template aprovado, e cada mensagem é cobrada; veja a nova precificação do WhatsApp Business.

Atribuição. Anúncios que cruzam WhatsApp e CRM precisam aceitar BSUID como identificador primário.

Relatórios. Dashboards por telefone podem duplicar contatos. O ideal é reportar por contato canônico, com telefone e BSUID vinculados. Veja por que isso importa em WhatsApp não é CRM.

Como pedir o telefone de forma proativa?

Quando o telefone for necessário (autenticação, entrega, cobrança, sistema legado), a Meta oferece o botão REQUEST_CONTACT_INFO em templates utility ou marketing, e a mensagem interativa request_contact_info. O rótulo é fixo ("Share Contact Info") e o telefone chega por webhook quando o usuário toca. Em atendimento comum, o BSUID pode bastar; exigir telefone em todo fluxo reduz conversão e vai contra a direção de privacidade da própria Meta.

O que sua empresa precisa fazer agora?

Se sua operação usa a Gupshup ou outro provedor que abstrai a API da Meta:

  1. Confirme o estado do toggle de BSUID: habilitado, em qual ambiente, quais campos aparecem nos webhooks e como mudam os payloads v2 e v3.
  2. Integre as APIs de business username: reserve ou solicite o nome e monitore a aprovação.
  3. Atualize o CRM para identidade híbrida: phone, bsuid, username e uma chave interna canônica.
  4. Revise bots e automações que assumem que from é telefone.
  5. Defina política para mensagens estacionadas: quem monitora, em que SLA e o que acontece com leads de mídia paga.
  6. Treine o atendimento humano: contato sem telefone não é suspeito, pode ser só um cliente com username.

Qual é o papel da Tolky?

O risco não está apenas no webhook: está na cadeia inteira de CRM, filas, agentes de IA, relatórios, campanhas e governança de dados. Para a Tolky, a meta é manter o histórico do cliente unificado, com a IA e os agentes humanos vendo o mesmo contato mesmo quando a conversa chega com telefone, BSUID ou username, e pedir dados adicionais só quando o processo exige. Para saber como isso funciona na sua operação, o caminho é falar com o time.

Quer revisar sua base e seus fluxos para contatos sem telefone? Fale com o time Tolky.

Perguntas frequentes

O que é o BSUID do WhatsApp?

O BSUID é o identificador de usuário escopado por negócio. Ele permite responder a alguém mesmo sem o telefone dessa pessoa. Veja o post sobre BSUID e usernames.

O BSUID substitui o telefone?

Não. No envio, se a mensagem tiver telefone e BSUID, o telefone tem precedência. O que muda é que o telefone deixou de ser uma garantia universal, então o cadastro precisa guardar os dois.

O que são mensagens estacionadas?

Segundo o comunicado da Gupshup, são mensagens retidas por até 30 dias quando o telefone por trás de um BSUID não está disponível. Esse detalhe não foi confirmado em documentação pública, então peça-o por escrito ao seu provedor.

Preciso ativar o feature toggle de BSUID?

Na documentação de parceiros da Gupshup, por padrão a plataforma entrega apenas o telefone. Ativar em ambiente controlado e cedo ajuda a capturar BSUIDs e a evitar contatos duplicados quando chegarem conversas sem telefone.

Como o CRM deve guardar contatos com BSUID e username?

Com identidade híbrida: telefone, BSUID, username e uma chave interna canônica que une os três. Isso evita duplicar contatos e permite reportar por pessoa, não por identificador. Veja a solução de CRM da Tolky.

Como pedir o telefone de um contato que só tem username?

A Meta oferece o botão REQUEST_CONTACT_INFO em templates utility ou marketing e a mensagem interativa request_contact_info. O telefone chega por webhook quando a pessoa toca. Em atendimento comum, o BSUID pode bastar.

O BSUID elimina o opt-in e os templates?

Não. Fora da janela de 24 horas, só vale template aprovado, e cada mensagem é cobrada. Veja a nova precificação do WhatsApp Business.

O que a Tolky faz com contatos sem telefone?

A meta da Tolky é manter o histórico do cliente unificado, com a IA e os agentes humanos vendo o mesmo contato, qualquer que seja o identificador. Para saber como isso funciona na sua operação, veja os planos ou fale com o time.


O telefone não desapareceu, mas deixou de ser uma garantia universal. Operações maduras tratam identidade como um conjunto: telefone, BSUID, username, consentimento e histórico. Quem esperar o primeiro lead sem telefone para descobrir o problema vai encontrar conversas reais presas a uma premissa antiga.

Compartilhar

Tags

Sobre o autor

Cofundador da Tolky

Marlos Carmo é empreendedor em IA e fundador da Tolky, a infraestrutura e AI CRM da era conversacional que unifica atendimento inteligente, multicanalidade (como WhatsApp e voz), CRM vivo e inteligência operacional em um único ecossistema. É finalista do SXSW Innovation Awards e integrante do Francesco's Economy, rede global de jovens empreendedores com foco em inovação e impacto social. Atua conectando Inteligência Artificial e transformação digital em projetos para grandes organizações.

Próximo passo

Quer levar isso para a sua operação?

A Tati, assistente de IA da Tolky, entende o seu cenário em poucas perguntas, sugere o melhor caminho e te conecta com uma pessoa do time levando todo o contexto.

Compartilhar

Leia também sobre a API e o preço do WhatsApp