Como trabalhar com contatos BSUID e solicitar números de telefone no WOZTELL
Índice
Talvez você já tenha percebido que alguns contatos agora chegam até você sem número de telefone. Isso acontece porque a Meta está lançando os nomes de usuário do WhatsApp como um recurso opcional, país por país.
Quando um usuário adota um nome de usuário, o WhatsApp passa a exibir esse nome no lugar do número de telefone. Ou seja, as empresas não podem mais contar com o número do usuário logo no primeiro contato.
Em vez disso, você vai identificá-lo pelo BSUID (Business-Scoped User ID), um identificador único que a Meta gera automaticamente para cada relação entre empresa e usuário.
Como o WOZTELL lida com isso
O WOZTELL adaptou a plataforma para dar suporte a essa mudança. Quando um contato envia uma mensagem, o WOZTELL recebe da Meta um ou mais identificadores, nesta ordem de prioridade:
- Número de telefone: o identificador principal, quando disponível
- BSUID: identifica o contato enquanto o número de telefone ainda não está disponível
- Nome de usuário: informação adicional exibida quando o contato tem um configurado
Se um contato começa apenas com um BSUID e depois compartilha o número de telefone, o WOZTELL vincula os dois identificadores e mantém a continuidade da conversa. A partir daí, o número de telefone passa a ser o identificador prioritário.
O que mudou no seu espaço de trabalho
Caixa de Entrada
Contatos sem número de telefone aparecem com o BSUID exibido como ID Externo. O nome de usuário aparece como informação adicional, quando disponível. Você também pode pesquisar conversas pelo BSUID.
Página Contatos
Uma nova coluna Nome de usuário mostra o nome de usuário do WhatsApp de cada contato (fica vazia se ele não tiver um). O BSUID aparece como ID Externo quando não há número de telefone. Você pode pesquisar e filtrar tanto por BSUID quanto por nome de usuário.
Como solicitar um número de telefone
Em muitos casos, ainda vale mais a pena ter o número de telefone do lead ou do cliente registrado. Por isso, no WOZTELL, a Solicitação de Número de Telefone fica disponível automaticamente para contatos que ainda não têm número de telefone.
Opção 1: mensagem interativa (sem modelo)
Envie diretamente ao contato uma mensagem interativa especial do WhatsApp: Solicitar Informações de Contato.
Essa mensagem usa o componente REQUEST_CONTACT_INFO do WhatsApp e não precisa de modelo. Use esta opção quando quiser pedir um número de telefone rapidamente, sem configurar modelos antes.
Você pode configurar essa mensagem como resposta automática no fluxo do seu chatbot, para que ela seja enviada sempre que um contato escrever e nenhum número de telefone for detectado.
Opção 2: mensagem de modelo (com modelos e Lista Branca)
Use modelos do WhatsApp que incluam o componente Solicitar Informações de Contato. Assim você tem mais controle sobre o conteúdo da mensagem e a identidade da marca.
Criar modelos com Solicitar Informações de Contato
Em Configurações, crie um novo modelo:
- Escolha a categoria Utilitário ou Marketing
- Inclua o componente especial Solicitar Informações de Contato
- Crie o modelo em vários idiomas, se precisar
- Envie para aprovação da Meta
Observação: modelos com esses componentes especiais podem levar um pouco mais de tempo para serem aprovados pela Meta.
Usar a Lista Branca de modelos
A Lista Branca em Configurações funciona como uma lista de favoritos para os seus modelos. Só os modelos que estão nela aparecem quando os agentes enviam uma Solicitação de Número de Telefone.
O fluxo é este:
- Crie o modelo com o componente Solicitar Informações de Contato
- A Meta aprova o modelo
- Adicione-o à Lista Branca em Configurações
- O modelo fica disponível para os agentes usarem ao solicitar números de telefone
Você controla quais modelos aparecem por meio da Lista Branca. Ter um modelo com o componente Solicitar Informações de Contato não o deixa disponível automaticamente para os agentes.
Ao configurar a Lista Branca, o WOZTELL filtra e mostra apenas os modelos que contêm o componente Solicitar Informações de Contato, o que facilita encontrá-los e adicioná-los.
Enviar uma Solicitação de Número de Telefone pela Caixa de Entrada
Quando um contato sem número de telefone envia uma mensagem, você pode iniciar uma Solicitação de Número de Telefone direto na conversa. É só escolher um dos modelos da Lista Branca e enviar.
Enviar uma Solicitação de Número de Telefone pelos Contatos
Você também pode iniciar uma Solicitação de Número de Telefone a partir do registro do contato na página Contatos. O WOZTELL vai redirecionar você para a Caixa de Entrada desse contato, onde é possível escolher e enviar um modelo da Lista Branca.
O que o contato decide?
Quando você envia uma mensagem Solicitar Informações de Contato, é o contato quem controla o que vai compartilhar. O WhatsApp pode oferecer a opção de compartilhar:
- Número de telefone
- Nome de usuário (se ele tiver um configurado)
Você não pode obrigar um contato a compartilhar o número de telefone. É ele quem decide quais informações fornecer.
Seja qual for a opção escolhida, o número de telefone precisa chegar pelo Solicitar Informações de Contato para que o WOZTELL possa vinculá-lo ao contato.
Boas práticas para solicitar um número de telefone
Pedir ao contato que digite o número de telefone no chat não é o mesmo que uma Solicitação de Número de Telefone.
Isto não funciona: pedir ao contato que “digite seu número de telefone no chat”
Um número de telefone recebido como mensagem de texto comum não pode ser associado corretamente à identidade do contato por meio deste recurso.
Use uma destas opções:
- Mensagem interativa: envie diretamente uma mensagem interativa Solicitar Informações de Contato
- Mensagem de modelo: use um modelo com o componente Solicitar Informações de Contato
Assim você garante que o número de telefone seja registrado corretamente e vinculado à identidade do contato no WOZTELL.
Por que usar o método certo faz diferença
Quando você usa o método Solicitar Informações de Contato, a Meta trata o número de telefone como dado estruturado ligado ao BSUID do contato. Isso significa que:
- O número de telefone fica corretamente associado à identidade do contato
- O WOZTELL pode mesclar automaticamente o número de telefone com o BSUID já existente
- O histórico da conversa é mantido
- Todas as conversas futuras usam o número de telefone como identificador prioritário
Quando o contato simplesmente digita um número no chat, nada dessa vinculação automática acontece.
A importação de contatos é diferente
A importação de contatos é um processo separado para adicionar contatos que você já tem, usando os IDs Externos compatíveis.
Você pode importar contatos usando:
- BSUID
- Número de telefone do WhatsApp
- Instagram ID
- Facebook PSID
Quando você importa um contato com número de telefone, o WOZTELL cria o registro na hora, usando esse número como identificador principal.
Para enviar sua primeira Solicitação de Número de Telefone, entre no WOZTELL e abra uma conversa com um contato que não tenha número de telefone. Se você ainda não usa o WOZTELL, pode começar grátis. Os guias completos estão na nossa Base de Conhecimento.


