Como criar bot no Telegram: do BotFather ao primeiro fluxo

Como criar bot no Telegram é a parte fácil: leva poucos minutos no BotFather. O que quase nenhum tutorial conta é o que vem depois, porque a maioria para no token ou pula direto para o Python. Aqui você cria o bot, guarda o token direito e sai com um primeiro fluxo de boas-vindas no ar, sem programar.

Um aviso: este blog é da Flow4You, e a parte final usa o nosso editor. A criação no BotFather é igual para qualquer ferramenta.

Como criar bot no Telegram com o BotFather

O @BotFather é o bot oficial do Telegram para criar e administrar bots. Tudo acontece numa conversa com ele, no celular ou no computador.

1. Abra a conversa. Busque por @BotFather no Telegram e confira se o username é exatamente esse. O token vai sair dali, então não vale conversar com um nome parecido.
2. Envie /newbot. Ele responde pedindo o nome do bot.
3. Escolha o nome. É o que aparece na conversa e no perfil, por exemplo “Foto no Celular”. Pode ter espaço e dá para mudar depois com /setname.
4. Escolha o username. É o endereço do bot, e o link dele fica t.me/username. As regras do Telegram: de 5 a 32 caracteres, só letras latinas, números e underline, terminando em “bot”, como fotonocelular_bot.
5. Copie o token. O BotFather responde com uma sequência no formato número, dois-pontos e um texto aleatório. É a chave do seu bot.

Pense bem no username antes de confirmar. Diferente do nome, a documentação diz que ele não pode ser alterado depois. Ele vai aparecer em anúncio, bio e material, então escolha algo que você aceite ver por muito tempo.

Guarde o token como se fosse senha

Quem tem o token controla o bot. A recomendação do Telegram é simples: guarde em lugar seguro e não compartilhe.

Na prática:

• Não mande o token em grupo, print ou e-mail.
• Não publique em repositório de código.
• Vazou? Use /token no BotFather para gerar um novo. Depois, troque o token em toda ferramenta conectada àquele bot.

Deixe o perfil apresentável

Antes de levar gente para o bot, gaste cinco minutos no perfil. Tudo fica no BotFather:

• /setuserpic: a foto do bot.
• /setdescription: até 512 caracteres, aparece em “What can this bot do?”, na tela de quem ainda não apertou Start. É a sua primeira frase de venda.
• /setabouttext: até 120 caracteres, aparece na página de perfil.
• /setcommands: a lista de comandos que aparece quando a pessoa digita /.
• /mybots: a interface para editar tudo isso sem decorar comando.

Criou no BotFather. E agora?

Aqui a maioria dos tutoriais acaba, e é aqui que você percebe um detalhe: se você abrir o bot e mandar uma mensagem, nada acontece. O BotFather só registra o bot. Ele não responde sozinho. O Telegram explica que os bots são conectados ao servidor do dono, que processa cada mensagem. Alguém precisa fazer esse papel.

Você tem três caminhos:

• Programar. Python, Node ou outra linguagem, falando com a Bot API. Liberdade total. Em troca, você cuida de servidor, banco de dados, fila de envio e tela de atendimento. Faz sentido se tem alguém técnico que vai continuar mantendo.
• Ferramenta de integração, como o n8n. Boa para ligar o Telegram a outros sistemas. Exige montar e manter a lógica de conversa nó a nó, e o chat para sua equipe fica por sua conta.
• Editor visual de bots. Você cola o token e desenha a conversa em blocos. Mais rápido de mudar e fácil de passar para quem não programa. O limite são os blocos que a ferramenta oferece.

Se o objetivo é vender ou atender, o terceiro caminho costuma ser o mais curto. Comparamos as opções em melhores plataformas de bot para Telegram. Daqui em diante, o exemplo é na Flow4You, em que a conversa desenhada se chama fluxo.

Conecte o token

1. Tenha uma conta. Na Flow4You, você assina primeiro e depois cria a conta. A assinatura custa a partir de R$ 99/mês, e não existe plano grátis nem teste grátis.
2. Vá em “Adicionar Novo Bot”.
3. Cole o token no campo “Token do bot do Telegram”. Nome e @username vêm do próprio Telegram.

Pronto: o bot está ligado, mas ainda sem conversa. O próximo passo é dar a ele o que dizer.

Monte o primeiro fluxo de boas-vindas

Abra o menu “Fluxos” e crie um fluxo. Comece pequeno. Este exemplo é de um perfil fictício de dicas de foto, então troque os textos pelos seus:

Quando…

Lead aperta Start no bot (toggle "Iniciar também com /start" ligado)

Enviar Mensagem

Oi, {{lead.first_name}}! Aqui é o Pedro, do Foto no Celular. Mando uma dica curta por dia e aviso quando abre turma nova. Quer a primeira dica agora?Quero a dicaSó estou olhando

Ação: adicionar tag

Tag "quer-dicas" entra para quem clicou em Quero a dica

Enviar Mensagem

Dica 1: limpe a lente antes de fotografar. Parece bobo, mas é o que mais muda a foto.

Atraso Inteligente: 1 dia

Enviar Mensagem

Conseguiu testar? A turma nova abre esta semana.Ver a turmaPrefiro só as dicas

Bloco a bloco, sem pressa:

1. Gatilho “Quando…”. Ligue o toggle “Iniciar também com /start”. Assim, esse fluxo é o que roda quando alguém abre o bot direto. Só um fluxo por bot pode ter isso ligado. O gatilho também mostra o link próprio do fluxo, um deep link que você pode usar em anúncio, bio ou post.
2. Primeira mensagem. Diga quem é, o que a pessoa ganha ali e dê um próximo passo em botões inline. Tem mais modelos no guia de mensagem de boas-vindas do bot.
3. Tag. Com a Ação de adicionar tag, você separa quem pediu a dica. Essa tag serve depois para um disparo só para esse grupo.
4. Entrega. Entregue o prometido antes de oferecer qualquer coisa.
5. Atraso Inteligente. Espera um dia antes de voltar.
6. Segunda mensagem. “Ver a turma” é um botão com link para a sua página ou checkout. O pagamento acontece lá, não no fluxo.

Agora teste:

1. Rode a simulação do Telegram dentro do editor.
2. Clique em “Publicar”. Só fluxo publicado abre.
3. Abra o seu bot no seu próprio Telegram e aperte Start. Confira texto, botões e, na “Base de leads”, a tag no seu contato.

Para ir além, o guia completo está em bot de vendas no Telegram.

E os Managed Bots?

Desde a Bot API 9.6, de 3 de abril de 2026, o Telegram tem os Managed Bots: um bot pode criar e gerenciar outros bots para os donos deles. Quem opera o bot gerente ativa o “Bot Management Mode” no Mini App do BotFather e compartilha um link t.me/newbot/…, por onde a pessoa cria o próprio bot. É um recurso da API para quem programa um bot gerente, não um editor de conversa. Para o caminho deste guia, nada muda: BotFather, token, fluxo.

O que costuma dar errado

• O bot não responde ao Start. Quase sempre é uma destas: o fluxo não foi publicado ou o toggle “Iniciar também com /start” está desligado. Sem nenhum fluxo com o toggle, o /start puro não abre nada.
• Só um link funciona. Se o link do fluxo abre e o bot direto não, é o mesmo toggle.
• Testar sempre com o mesmo fluxo enorme. Comece com quatro ou cinco blocos. Um fluxo pequeno no ar ensina mais que um grande no rascunho.
• Levar gente para o canal esperando o bot falar com ela. Membro de canal que nunca falou com o bot não é lead dele.
• Username improvisado. Como ele fica, um nome de teste vira problema quando o bot começa a circular.

Próximo passo

Com o fluxo de boas-vindas no ar, o trabalho muda: levar gente até o link e acompanhar o que acontece na conversa. O caminho natural é ir de boas-vindas para oferta, e o funil de vendas no Telegram mostra como montar essa sequência.