Documentação · Funis e pagamentos

Como coletar o número de telefone num funil do Telegram

Um botão "Compartilhar número de telefone" abaixo de uma pergunta — a pessoa toca e o número chega sozinho, sem digitar.

Atualizado: 8 de outubro de 2026

Com o número de telefone, você pode ligar para um lead quente, encontrar a pessoa nos seus contatos e associá-la a um pagamento. As pessoas não gostam de digitar o número e muitas vezes erram. O Telegram consegue enviar o número com um botão — esta etapa ativa isso.

Como ativar#

  1. Adicione um bloco Pergunta ao funil e escreva o texto, por exemplo: "Deixe seu número — vamos ligar e escolher um programa para você".
  2. Marque "Pedir o número de telefone com um botão do Telegram".
  3. Mude o texto do botão se quiser (o padrão é "Compartilhar número de telefone").
  4. A variável da resposta já vem preenchida — phone. Você pode renomeá-la.

A pessoa vê a pergunta e um botão grande no lugar do teclado. Ela toca, o Telegram pergunta "Compartilhar seu número de telefone?", e o número chega no bot. O funil segue em frente, como depois de uma resposta comum.

Onde encontrar o número depois#

  • No card do contato, em Automações → Contatos, na linha "Telefone".
  • No texto de qualquer mensagem posterior — insira {{phone}} (ou o nome da sua variável).
  • Em condições — por exemplo "variável phone não está vazia", para mandar uma coisa para quem deixou o número e outra para os demais.
  • Numa notificação de lead — o número é enviado para você, um colega ou um grupo de trabalho: como receber leads no Telegram.

O número sempre chega no mesmo formato: +14155550123 — sinal de mais e só dígitos.

Bom saber#

  • Só no Telegram. O Instagram não tem esse botão — lá, peça o número com uma pergunta comum. O VK também não tem: a pessoa digita o número, e a Craft salva em phone e no card do contato se a mensagem inteira parecer um número de telefone (detalhes).
  • O botão aparece embaixo da tela, no lugar do teclado, não abaixo da mensagem. Ele some sozinho depois do toque.
  • Essa pergunta não pode ter botões próprios: o Telegram não mostra o botão de telefone e botões abaixo de uma mensagem ao mesmo tempo. Precisa de botões — coloque na mensagem seguinte.
  • Só vale o número da própria pessoa. Se alguém enviar o contato de outra pessoa pelo clipe, o número não é salvo.
  • A pessoa pode ignorar o botão e digitar uma resposta — o número à mão ou "não, obrigado". Essa resposta é salva na variável como está. Se você precisa exatamente de um número depois, verifique a variável com uma condição.
  • Os botões de mensagens anteriores continuam funcionando. Enquanto o bot espera o número, a pessoa pode tocar num botão acima — por exemplo, "Enviar o material". O funil segue o ramo desse botão e a pergunta do telefone é descartada. Os botões ficam ativos por 7 dias depois que o funil avança.
  • Nenhuma resposta — defina um tempo limite na pergunta e um ramo "Sem resposta" com um lembrete, senão a pessoa some em silêncio.
Não encontrou a resposta?Fale com a gente no Telegram ou em [email protected]: respondemos e completamos o artigo.
Falar no Telegram