Visão geral
O WhatsApp está lançando nomes de usuário ao longo de 2026. Um cliente que adota um nome de usuário
pode ocultar o número de telefone. Nesse caso, a conversa chega identificada só por um ID comercial
(BSUID, o ID de escopo comercial, por exemplo BR.123…) e pelo nome de usuário, sem número. No WhatsApp
Web, o equivalente é um identificador @lid.
O pedido de telefone é o caminho oficial para o cliente compartilhar o número com você:
- O cliente recebe uma mensagem com um botão nativo do WhatsApp para compartilhar o contato.
- Se ele tocar no botão, o número chega na conversa como "Telefone compartilhado" e é gravado no contato.
- A partir daí, a plataforma passa a enviar ao telefone, como a Meta recomenda.
O cliente sempre decide se compartilha. Se ele recusar ou ignorar o pedido, nada acontece: a conversa continua pelo ID comercial.
Pré-requisitos
- Uma conversa individual em uma caixa de entrada de WhatsApp. Grupos, comunidades e canais não aceitam o pedido.
- Permissão para responder na conversa.
- Para pedir com a janela de 24 horas fechada: um modelo aprovado da categoria Utilidade ou Marketing que tenha o botão Compartilhar contato.
- Em uma caixa só de WhatsApp Web: o serviço de WhatsApp Web (gateway) atualizado pelo operador da plataforma. Veja a tabela em Configurações & opções.
Passo a passo
Com a janela de 24 horas aberta
- Abra a conversa individual de WhatsApp.
- No compositor, clique em Pedir telefone. Quando o telefone do contato é desconhecido, o botão aparece em destaque.
- Na aba Mensagem, revise o texto que o cliente lê acima do botão. Ele é editável e aceita até 1024 caracteres. Explique para que o número será usado.
- Clique em Enviar pedido. O cliente recebe o texto com o botão para compartilhar o contato.
Com a janela de 24 horas fechada
- No compositor, clique em Pedir telefone.
- Na aba Modelo aprovado, escolha um modelo da categoria Utilidade ou Marketing que tenha o botão Compartilhar contato. O botão não leva parâmetro no envio.
- Clique em Usar modelo. O compositor de modelos do WhatsApp abre com o modelo já escolhido.
- Preencha as variáveis, se houver, confira a prévia e o custo e clique em Enviar.
Se não houver modelo aprovado com esse botão, o diálogo explica como criar um em Configurações → Caixas de entrada → (sua caixa de WhatsApp) → Modelos.
Quando o cliente compartilha
- O número aparece na conversa como "Telefone compartilhado" e é gravado no contato.
- Os próximos envios passam a usar o telefone.
- Se o cliente compartilhar o cartão de outra pessoa, ele continua sendo um cartão de contato comum e não muda o contato da conversa.
- No WhatsApp Web, o cliente responde enviando o próprio cartão de contato. A plataforma só grava o número quando o WhatsApp comprova que o cartão é do próprio cliente, numa conversa individual. Como o WhatsApp Web não liga a resposta ao pedido, um cartão próprio enviado sem pedido também é aceito.
- Se o número já pertence a outro contato, a plataforma não mescla os contatos sozinha. A bolha avisa e oferece Abrir contato, para você usar o fluxo de mesclagem que já existe.
- Se o contato já tinha outro telefone salvo, a bolha avisa e oferece Revisar contato, para você conferir qual número deve ficar no contato.
- Em um aviso de conflito, a bolha também oferece Dispensar aviso. Ele marca o conflito como revisado sem mesclar nada, e a bolha passa a mostrar Aviso dispensado. Quem decide é o agente: a plataforma nunca mescla os contatos sozinha.
Configurações & opções
Onde o botão aparece
- No compositor de uma conversa individual de WhatsApp, com o nome Pedir telefone.
- Em destaque quando o telefone do contato é desconhecido.
- Em grupos, comunidades, canais, caixas sem suporte ou para quem não pode responder, o botão não aparece ou fica desabilitado, com o motivo.
- O rótulo do botão que o cliente vê é fixo e aparece no idioma do app dele. Não é possível personalizá-lo.
Por tipo de caixa de entrada
| Caixa de entrada | Como o pedido é enviado |
|---|---|
| WhatsApp oficial (Cloud) e coexistência | Pelo WhatsApp oficial. |
| Caixa híbrida (oficial + WhatsApp Web, unificada ou não) | Numa conversa da caixa oficial, sempre pelo canal oficial. O pedido nunca é repetido pelo WhatsApp Web. |
| Só WhatsApp Web | Depende de uma atualização do serviço de WhatsApp Web (gateway). A plataforma verifica sozinha o gateway de cada caixa: enquanto ele não estiver atualizado, Pedir telefone fica desabilitado e a dica do botão explica o motivo ("verificando" enquanto a plataforma ainda não confirmou o gateway); depois que o operador atualizar, o botão volta a funcionar sozinho em até cerca de uma hora. A resposta do cliente chega como o cartão de contato dele e é gravada no contato da mesma forma. |
Fluxos (Flow Builder)
O nó de mensagem tem o tipo Solicitar contato, que faz o mesmo pedido de telefone no WhatsApp oficial.
Agenda de contatos da Meta
A agenda de contatos (contact book) é um recurso da Meta, por portfólio comercial, que guarda o telefone de quem interagiu com o número e o usa para preencher os webhooks seguintes.
- Um telefone compartilhado pelo botão entra nela automaticamente.
- Ela só registra interações a partir do lançamento do recurso.
- Ela pode ser desativada no Meta Business Suite → Configurações do negócio → Informações do negócio. Desativar a agenda apaga o conteúdo dela.
Casos de uso
- Confirmar uma entrega ou um agendamento com um cliente que aparece só pelo nome de usuário.
- Pedir o telefone depois que a janela de 24 horas fechou, com um modelo aprovado que tenha o botão Compartilhar contato.
- Pedir o telefone dentro de um fluxo automatizado, com o tipo Solicitar contato.
Dicas, limites e boas práticas
- Peça o telefone só quando houver motivo e explique no texto para que o número será usado.
- Se o cliente recusar ou ignorar, não insista em sequência. A conversa continua pelo ID comercial, e a Meta pode aplicar limites de qualidade a mensagens indesejadas.
- O texto livre aceita até 1024 caracteres.
- Modelos de Autenticação não aceitam o botão Compartilhar contato, e um modelo só pode ter um botão desses.
- O rótulo do botão é definido pelo WhatsApp e não pode ser personalizado.
Privacidade e LGPD
- O cliente decide se compartilha o número.
- O telefone compartilhado passa a ser dado pessoal do contato e fica mascarado no Modo Apresentação.
- Para pedidos de exclusão de dados, use o processo de privacidade da plataforma.
Solução de problemas
Nenhuma falha reenvia o pedido de telefone sozinha. Assim, o cliente nunca recebe o mesmo pedido duas vezes. Tente de novo quando a mensagem disser que nada chegou ao contato.
- "O pedido de telefone não foi enviado porque a janela de atendimento de 24 horas do WhatsApp está fechada.": envie um modelo aprovado de Utilidade ou Marketing com o botão Compartilhar contato.
- "O pedido de telefone não foi enviado porque está sem texto." ou "…porque o texto passa de 1024 caracteres.": escreva o texto que o cliente lê acima do botão, com até 1024 caracteres.
- "A Meta não aceita este tipo de mensagem para um contato conhecido só pelo nome de usuário do WhatsApp…" (código 131062): acontece com modelos de Autenticação. Peça o telefone antes de enviar esse tipo de modelo.
- "Esta caixa de WhatsApp Web ainda não consegue pedir o telefone…": o serviço de WhatsApp Web da caixa precisa de uma atualização. Peça ao operador da plataforma para atualizar o gateway ou envie o pedido pelo canal oficial do WhatsApp.
- "A sessão de WhatsApp Web desta caixa está desconectada, então o pedido de telefone não foi enviado.": reconecte a caixa e tente de novo.
- "O serviço de WhatsApp Web recusou este pedido de telefone, então nada foi enviado.": tente de novo. Se continuar falhando, acione o operador da plataforma.
- "O WhatsApp Web não conseguiu usar o telefone deste contato.": confira o número salvo no contato e tente de novo.
- "O WhatsApp não enviou o pedido de telefone. Nada chegou ao contato, então você pode tentar de novo.": envie o pedido outra vez.
- "O WhatsApp não confirmou se o pedido de telefone chegou ao contato.": o pedido não é reenviado automaticamente, para o contato nunca recebê-lo duas vezes. Antes de pedir de novo, lembre que o cliente pode já ter recebido o pedido.
- Não há modelo com o botão para escolher: crie um em Configurações → Caixas de entrada → (sua caixa de WhatsApp) → Modelos, na categoria Utilidade ou Marketing, e aguarde a aprovação da Meta.
- O cliente compartilhou, mas o número já pertence a outro contato: a bolha mostra o aviso e oferece Abrir contato, para usar o fluxo de mesclagem de contatos, e Dispensar aviso, para marcar o conflito como revisado sem mesclar nada. Depois de dispensado, a bolha mostra Aviso dispensado. Quem decide é o agente: a plataforma nunca mescla os contatos sozinha.
- O contato já tinha outro telefone salvo: a bolha mostra o aviso e oferece Revisar contato. Confira qual número deve ficar no contato.
- O botão Pedir telefone está desabilitado: confira o motivo exibido. O pedido não vale para grupos, comunidades, canais, caixas sem suporte ou para quem não pode responder na conversa.