# 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.

- **Versão em HTML:** https://tolky.to/blog/gupshup-bsuid-usernames-whatsapp-business-2026
- **Autor:** [Marlos Carmo](https://tolky.to/autor/marlos), Cofundador da Tolky
- **Publicado em:** 1 de julho de 2026
- **Revisado em:** 17 de novembro de 2026
- **Idioma:** pt-BR

## Resumo

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.

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids)): 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](https://tolky.to/blog/bsuid-whatsapp-meta-o-que-muda-2026): 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](https://partner-docs.gupshup.io/docs/api-to-enable-bsuid-flag-for-an-app)). 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](https://support.gupshup.io/hc/en-us/articles/55873677826713-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](https://tolky.to/blog/nova-precificacao-whatsapp-business-2026).

**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](https://tolky.to/blog/whatsapp-nao-e-crm-crm-para-whatsapp).

## 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](https://tolky.to/contato).

## 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](https://tolky.to/blog/bsuid-whatsapp-meta-o-que-muda-2026).

### 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](https://tolky.to/solucoes/crm).

### 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](https://tolky.to/blog/nova-precificacao-whatsapp-business-2026).

### 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](https://tolky.to/precos) 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.

---

Esta é a versão em Markdown da página. A versão completa, com imagens e navegação, está em https://tolky.to/blog/gupshup-bsuid-usernames-whatsapp-business-2026

Tolky: https://tolky.to
