## 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

1. Abra a conversa individual de WhatsApp.
2. No compositor, clique em **Pedir telefone**. Quando o telefone do contato é desconhecido, o botão
   aparece em destaque.
3. 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.
4. Clique em **Enviar pedido**. O cliente recebe o texto com o botão para compartilhar o contato.

### Com a janela de 24 horas fechada

1. No compositor, clique em **Pedir telefone**.
2. 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.
3. Clique em **Usar modelo**. O compositor de modelos do WhatsApp abre com o modelo já escolhido.
4. 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.

## Veja também

- [Caixa híbrida do WhatsApp: Coexistência (Cloud) + WhatsApp Web](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-pt-br)
- [WhatsApp Inbox Suite: Templates, Flows e Chamadas](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-pt-br)
- [Coexistence do WhatsApp Cloud](/hc/ajuda/articles/inboxes-channels-whatsapp-coexistence-pt-br)
- [Flow Builder](/hc/ajuda/articles/automation-flows-flow-builder-pt-br)
- [Modo Apresentação](/hc/ajuda/articles/administration-modo-apresentacao-pt-br)