## Mensagens recebidas ```mermaid theme={null} flowchart LR A[Contato envia uma mensagem no WhatsApp] --> B{Número de telefone incluído?} B -- Sim --> C[Match/criação de contato por telefone] B -- Não --> D{BSUID já conhecido?} D -- Sim --> E[Match com contato existente por BSUID] D -- Não --> F[Cria novo contato só com BSUID] C --> G[Conversa continua normalmente] E --> G F --> G ``` Quando chega uma mensagem sem número de telefone, a Treble: 1. 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. 2. 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. 3. 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. **Templates de autenticação (OTP) sempre exigem um número de telefone.** Se um contato só tem BSUID e você precisa enviar um template de autenticação para ele, você vai precisar do número de telefone primeiro — veja a próxima seçã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**. Adicione uma mensagem com o botão **Request Contact Info** ao seu fluxo, direcionada ao contato que só tem BSUID. Se ele concordar, o WhatsApp compartilha o número de telefone com você — isso sempre depende de consentimento, o contato precisa concordar explicitamente. 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](/pt/docs/integrations/hubspot/welcome) 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_created` e 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. É 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 Não. O envio, as conversas, os relatórios e os templates continuam funcionando da mesma forma. Isso é resolvido pela Treble de forma transparente. Não, nada muda em como os relatórios funcionam para você. Sim — você envia a mensagem da mesma forma, a Treble resolve o destinatário correto (telefone, BSUID, ou nome de usuário) automaticamente. 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. 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. Não. Seu Phone Number ID permanece o mesmo, e as conversas existentes não são impactadas. 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. 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: * [Meta for Developers — Business-Scoped User IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) ## Próximos passos Veja tudo o que a Treble sincroniza com o HubSpot. Entenda o panorama completo de como a Treble trabalha com o Meta.