Nada quebra se você não fizer nada. A Treble resolve contatos, mantém as conversas conectadas e envia mensagens corretamente, seja o contato identificado por número de telefone, nome de usuário, ou só por BSUID. Esta página existe para você entender por que pode ver um contato sem número de telefone, e o que isso significa.
O que é um BSUID?
Um Business-Scoped User ID é um identificador único, gerado pelo Meta, para um usuário do WhatsApp, específico para o seu negócio. É o único identificador que o Meta sempre inclui em toda mensagem recebida ou status de mensagem, o usuário tendo um nome de usuário configurado ou não, e compartilhando o número ou não.- Tem a aparência de uma string com prefixo de código de país, por exemplo
US.13491208655302741918. - É limitado ao nível de portfólio de negócio — a mesma pessoa escrevendo para dois negócios diferentes recebe um BSUID diferente para cada um.
- Não pode ser usado para templates de autenticação (OTP) — esses continuam exigindo um número de telefone, já que dependem de verificação baseada em número.
O que é um nome de usuário do WhatsApp?
Um nome de usuário é um identificador opcional e legível (como@seunome) que um usuário do WhatsApp pode reservar para sua conta, semelhante a um nome de usuário em outros apps de mensagem ou redes sociais. Um usuário que tem um nome de usuário pode optar por esconder o número de telefone das empresas — nesse caso, você vai ver o nome de usuário dele (se ele escrever com um configurado) e o BSUID, mas não o número.
Um nome de usuário é opcional e controlado pelo usuário. O número de telefone também pode voltar a aparecer mais tarde — o Meta volta a mostrá-lo se houve uma interação recente (nos últimos 30 dias) ou se o contato existe na lista de contatos do seu negócio.
Por que isso está acontecendo
Até agora, o número de telefone era a âncora de tudo: como um contato era identificado, encontrado, e como se enviavam mensagens a ele. O Meta está desacoplando isso — o número de telefone passa a ser algo que um contato pode compartilhar, não algo com o que você sempre pode contar.1
Abril de 2026
Os BSUIDs começam a aparecer nos webhooks de entrada para todos os contatos, tenham ou não um nome de usuário configurado.
2
29 de junho de 2026
A reserva de nomes de usuário abre globalmente — tanto para usuários do WhatsApp quanto para negócios (veja as perguntas frequentes abaixo para saber como configurar um para o seu próprio número). Depois, a ativação vai sendo liberada por país nas semanas seguintes.
3
Julho de 2026 em diante
As APIs de envio passam a aceitar um BSUID diretamente (via o parâmetro
recipient) como alternativa a um número de telefone (to).Como a Treble identifica um contato
A Treble rastreia três identificadores para cada contato, em vez de só um:
Quando a Treble precisa encontrar ou criar um contato, ela verifica nesta ordem: primeiro número de telefone, depois BSUID, depois nome de usuário. Isso mantém o match dos contatos com telefone exatamente como sempre funcionou, e só recorre a BSUID/nome de usuário quando não há número disponível.
Mensagens recebidas
Quando chega uma mensagem sem número de telefone, a Treble:- Procura o contato pelo BSUID. Se já conhece esse BSUID (de uma mensagem anterior, ou porque o número de telefone foi recuperado antes), a conversa continua exatamente como com qualquer outro contato.
- Se é a primeira vez que vê esse BSUID, a Treble cria um novo contato ancorado a ele. O contato se comporta normalmente nos seus fluxos, relatórios e histórico de conversa — só que não vai ter um campo de número de telefone até que um esteja disponível.
- Se o contato compartilhar um número de telefone mais tarde (veja a seção Recuperando um número de telefone mais abaixo), a Treble vincula isso automaticamente ao contato já existente ancorado por BSUID — nenhum duplicado é criado, e o histórico da conversa se mantém intacto.
Mensagens enviadas
Enviar uma mensagem funciona da mesma forma, seja o contato identificado por número de telefone ou por BSUID — a Treble lida com essa diferença automaticamente. Campanhas, templates e automações não precisam de nenhuma alteração.Recuperando um número de telefone
Se você tem um contato sem número de telefone e realmente precisa dele (por exemplo, para enviar um template de autenticação, ou para sincronizar com um CRM que só faz match por telefone), a Treble oferece suporte ao botão do WhatsApp Request Contact Info.1
Envie o botão
Adicione uma mensagem com o botão Request Contact Info ao seu fluxo, direcionada ao contato que só tem BSUID.
2
O contato toca e consente
Se ele concordar, o WhatsApp compartilha o número de telefone com você — isso sempre depende de consentimento, o contato precisa concordar explicitamente.
3
A Treble salva automaticamente
O número de telefone é vinculado ao contato existente de forma automática. Sem trabalho manual, sem contato duplicado.
Esse botão ainda está em beta privado do lado do Meta e sendo lançado de forma gradual. Assim que estiver disponível de forma geral, nenhuma mudança será necessária do seu lado para começar a usá-lo.
Suporte no HubSpot
A integração da Treble com o HubSpot oferece suporte a contatos identificados por BSUID e nome de usuário.- Duas novas properties de contato são criadas automaticamente no HubSpot na primeira vez que sua integração sincroniza: WhatsApp Business Scope ID (
whatsapp_business_scope_id) e WhatsApp Username (whatsapp_username). - Quando a Treble procura um contato no HubSpot, ela verifica primeiro o número de telefone, e recorre a BSUID ou nome de usuário quando não há número para buscar.
- Contatos novos criados pela Treble incluem esses campos automaticamente, da mesma forma que acontece com
treble_createde outras properties gerenciadas pela Treble. - Contatos que já existiam no HubSpot vão sendo preenchidos com esses campos automaticamente conforme interagem — sem necessidade de backfill manual do seu lado.
E se eu já tiver uma property customizada com um desses nomes?
E se eu já tiver uma property customizada com um desses nomes?
É pouco provável, mas se tiver, não é um conflito do nosso lado — a Treble só lê esses campos para fazer o match dos contatos, então se você já está preenchendo algo útil ali, isso funciona a seu favor.
A única limitação real
Se um contato já existe no seu CRM porque ele te escreveu antes com o número de telefone, e essa mesma pessoa depois te manda uma mensagem nova sem compartilhar o número (só com nome de usuário/BSUID), a Treble não vai conseguir reconhecer que é a mesma pessoa — o contato antigo nunca foi marcado com o nome de usuário/BSUID dele, e essa é a única informação disponível nesse momento. Nesse caso específico, um contato novo e separado é criado no seu CRM em vez de fazer o match com o existente. Isso não é algo que possamos contornar — é uma consequência direta do Meta permitir que os usuários escondam o número de telefone depois do fato. Também é um caso bem pontual: só afeta contatos que primeiro escreveram com número de telefone e depois o esconderam, sem que tenha havido antes nenhuma interação que permitisse à Treble marcar o registro existente deles. Para integrações de CRM diferentes do HubSpot, o match apenas por número de telefone ainda é o comportamento atual — vamos estender esse mesmo suporte a BSUID/nome de usuário para as nossas outras integrações de CRM em breve.Perguntas frequentes
Preciso mudar algo nos meus fluxos ou templates?
Preciso mudar algo nos meus fluxos ou templates?
Não. O envio, as conversas, os relatórios e os templates continuam funcionando da mesma forma. Isso é resolvido pela Treble de forma transparente.
Meus relatórios e métricas são afetados?
Meus relatórios e métricas são afetados?
Não, nada muda em como os relatórios funcionam para você.
Ainda consigo falar com um contato que esconde o número de telefone?
Ainda consigo falar com um contato que esconde o número de telefone?
Sim — você envia a mensagem da mesma forma, a Treble resolve o destinatário correto (telefone, BSUID, ou nome de usuário) automaticamente.
O que acontece com templates de autenticação (OTP) para um contato que só tem BSUID?
O que acontece com templates de autenticação (OTP) para um contato que só tem BSUID?
Eles não podem ser enviados até que você tenha um número de telefone para esse contato. Use o botão Request Contact Info (seção Recuperando um número de telefone mais acima) para solicitá-lo, com o consentimento dele.
Isso é algo que eu preciso ativar?
Isso é algo que eu preciso ativar?
Não — é um recurso da Plataforma do WhatsApp Business que o Meta está implementando. A Treble oferece esse suporte automaticamente; não há nenhuma configuração para ligar.
Isso afeta meu Phone Number ID ou minhas conversas existentes?
Isso afeta meu Phone Number ID ou minhas conversas existentes?
Não. Seu Phone Number ID permanece o mesmo, e as conversas existentes não são impactadas.
Posso configurar um nome de usuário para o meu próprio número de negócio?
Posso configurar um nome de usuário para o meu próprio número de negócio?
Sim, se o seu WABA/número atender aos requisitos de elegibilidade do Meta (negócio verificado, nome de exibição aprovado). Isso é configurado diretamente no WhatsApp Manager do Meta (Account tools → Phone numbers → selecione o número → aba Profile → Username), ou via a Username API do Meta — a Treble não tem uma interface para reservá-lo, já que é uma configuração de conta do lado do Meta.
Estou em um país onde isso ainda não foi lançado — isso importa?
Estou em um país onde isso ainda não foi lançado — isso importa?
Não para o seu uso diário da Treble. O lançamento de reserva e ativação de nomes de usuário está acontecendo gradualmente por país, com o cronograma totalmente definido pelo Meta. Independentemente desse cronograma, o tratamento que a Treble dá a contatos só-BSUID está ativo em todos os lugares, então você já está coberto para quando isso chegar ao seu mercado. Confirme diretamente no WhatsApp Manager do Meta o status atual para um país específico — não podemos garantir isso do nosso lado.
Fontes
Para o detalhe técnico completo direto do Meta:Próximos passos
Integração com HubSpot
Veja tudo o que a Treble sincroniza com o HubSpot.
Meta e Treble
Entenda o panorama completo de como a Treble trabalha com o Meta.