Solicitar dados de contato é uma ação do WhatsApp que pede ao usuário que compartilhe seu número de telefone dentro da conversa. Com a chegada dos nomes de usuário (username) do WhatsApp, cada vez mais pessoas podem escrever para o seu negócio sem compartilhar seu número: nesses casos, a variável ${whatsappNumber} chega vazia e você conta apenas com o BSUID. Essa ação permite solicitar esse dado quando sua operação realmente precisa dele.

Você pode:

• Pedir o número de telefone aos usuários que entram em contato sem compartilhá-lo.
• Inserir a ação em qualquer ponto do seu fluxo.
• Deixar que a ação seja ignorada automaticamente quando o usuário já compartilhou seu número.
• Condicionar o pedido conforme a variável ${whatsappNumber} para não solicitá-lo desnecessariamente.
• Executar um caminho específico ("Contato compartilhado") na primeira vez que o usuário compartilha seu número.

Antes de começar, tenha em conta que essa ação faz sentido à medida que seus usuários ativam seu username do WhatsApp e começam a entrar em contato sem compartilhar seu número. Para entender o contexto completo dessa mudança (BSUID, usernames e variáveis), recomendamos ler primeiro o artigo relacionado que indicamos no final.

Conceitos-chave

Solicitar dados de contato: ação do WhatsApp que envia ao usuário um pedido para que compartilhe seu número de telefone dentro da conversa.

${whatsappNumber}: variável que contém o número de telefone apenas quando o usuário o compartilhou explicitamente. Se nunca o compartilhou, permanece vazia.

BSUID (Business Scoped User ID): identificador único e anônimo que a Meta gera para cada combinação de usuário e empresa quando o usuário não compartilha seu número de telefone.

Contato compartilhado: evento que é executado apenas na primeira vez que o usuário compartilha seu número, e que permite definir um caminho específico no fluxo.

Pedido não bloqueante: o fluxo sempre continua para baixo, compartilhe ou não o usuário seu número. A ação não interrompe nem bloqueia a conversa.

Como solicitar o número de telefone

Passo 1: Adicione a ação ao seu fluxo

No editor de fluxos, adicione uma nova ação e selecione Ação → Canais → WhatsApp → Solicitar dados de contato.

Você pode posicionar essa ação em qualquer ponto do fluxo onde precise ter o número de telefone do usuário.

Passo 2: Entenda como a ação se comporta

A ação foi projetada para resolver o pedido por conta própria:

• Se o usuário já compartilhou seu número (a variável ${whatsappNumber} tem valor), a ação é ignorada e o fluxo continua para baixo sem pedir nada.
• Se o usuário não tem número associado, a ação envia a ele a mensagem para que compartilhe seu contato e o fluxo continua normalmente.

Por isso a ação tem duas saídas e esse formato específico no diagrama: um ramo para quando o número já existe e outro para o momento em que o usuário o compartilha.

Passo 3 (opcional): Condicione o pedido com a variável

Se você quiser controlar com mais precisão quando o número é solicitado, pode anteceder uma condição que avalie a variável ${whatsappNumber}:

• Se a variável tem valor, o usuário já compartilhou seu número e não é preciso pedi-lo novamente.
• Se a variável está vazia, direcione o fluxo para a ação Solicitar dados de contato.

Nota: condicionar o pedido evita voltar a solicitar o número a quem já o compartilhou. Sem a condição, a ação volta a mostrar a mensagem toda vez que o usuário retoma a conversa sem ter compartilhado seu número.

Passo 4: Como o usuário vê no WhatsApp

Quando a ação é executada, o usuário recebe o pedido para compartilhar seu contato (por exemplo, junto a um botão Compartilhar informações de contato) e a conversa fica aguardando sua resposta.

Ao tocar no botão, o WhatsApp mostra a ele quais dados vai compartilhar (número de telefone e username) antes de confirmar o envio.

Passo 5: O que acontece quando o usuário compartilha (ou não) seu número

Quando o usuário compartilha o contato, o número fica disponível na variável ${whatsappNumber} e, apenas na primeira vez, o fluxo executa o caminho Contato compartilhado, onde você pode definir os passos que quiser (por exemplo, uma mensagem de confirmação).

Se o usuário prefere não compartilhar seu número, o fluxo continua para baixo do mesmo jeito: o pedido não é bloqueante e não existe um botão de "prefiro não compartilhar". Por isso, qualquer parte do seu fluxo que dependa do número de telefone deve considerar que uma parcela dos usuários não o compartilhará, resolvendo isso com a condição do Passo 3.

Nota sobre testes: por enquanto não há uma forma direta de testar esse fluxo a partir da sua conta. Para vê-lo funcionar, você precisa entrar em contato pela primeira vez a partir de uma linha do WhatsApp que tenha o username habilitado sem compartilhar o número de telefone, algo que depende de a Meta habilitar o rollout dos usernames.

Para conhecer o contexto completo dos nomes de usuário, do BSUID e das variáveis do WhatsApp, compartilhamos o artigo "WhatsApp implementa nomes de usuário e um novo identificador de contas (BSUID)".

Lembre-se de visitar nossa Central de Ajuda para obter mais informações.