Como criar um bot no Telegram pelo BotFather e testar sem programar

Sim, você consegue criar um bot no Telegram sem programar. O cadastro é feito pelo próprio BotFather, a conta oficial usada para registrar e configurar bots. Em poucos minutos, você terá um bot com nome, usuário e um token de acesso para testar a API.

O ponto importante é não confundir “criar” com “automatizar”. Criar o bot não exige código; fazer o robô responder sozinho exige uma aplicação, um fluxo no n8n/Make ou outro serviço conectado à API. Abaixo, mostro o caminho mais simples para criar, configurar e testar o bot sem expor sua credencial.

O que é um bot do Telegram?

Um bot é uma conta especial que executa respostas e tarefas automaticamente dentro do Telegram. Ele pode receber textos, arquivos, localização, comandos e botões. Também pode enviar mensagens, consultar outros sistemas, registrar pedidos e funcionar como porta de entrada para um atendimento.

Por trás da conversa está a Bot API do Telegram. Ela recebe requisições HTTPS e devolve respostas em JSON, um formato de dados que aplicações conseguem ler. Na prática, o bot é a interface no Telegram; a lógica pode ficar em um script, no n8n, no Make ou em um servidor próprio.

Para quem está começando, a diferença fica assim:

• BotFather: cria e configura a conta do bot.
• Token: senha técnica que autoriza chamadas à API.
• Automação: decide o que fazer quando chega uma mensagem.
• Bot API: transporta as mensagens entre o Telegram e a automação.

Como criar um bot no Telegram pelo BotFather

1. Abra o BotFather

No aplicativo do Telegram, pesquise por @BotFather e confirme se é a conta oficial. Abra a conversa e toque em Start. Esse é o painel de administração dos bots, não um chatbot que atenderá seus clientes.

2. Use o comando /newbot

Envie /newbot. O BotFather pedirá duas informações:

1. Nome de exibição: é o nome que as pessoas verão no perfil e na conversa. Pode conter espaços e letras maiúsculas.
2. Username: é o identificador único do bot e precisa terminar em bot. Por exemplo, agenda_loja_bot. Se o nome já estiver ocupado, tente outra combinação.

Ao final, o BotFather mostrará um token parecido com 123456789:AAExemplo.... Não publique esse código em tutorial, GitHub, grupo ou print. Quem tiver o token pode controlar as chamadas feitas em nome do bot.

Como configurar nome, descrição e comandos

Depois de criar o bot, use /mybots no BotFather, selecione a conta e abra Edit Bot. Os nomes dos menus podem mudar um pouco conforme o idioma do aplicativo, mas as funções são as mesmas.

Nome e descrição

Em Edit Name, altere o nome de exibição quando necessário. Em Edit Description, escreva uma explicação curta para quem abrir o perfil pela primeira vez. Use uma frase útil, como “Consulta o status do pedido e informa o horário da loja”.

Também vale configurar a descrição curta do perfil. Ela aparece em áreas menores do Telegram, então não desperdice o espaço com frases genéricas como “o melhor bot do mundo”. Diga o que o bot resolve.

Lista de comandos

Abra Edit Commands e informe um comando por linha, seguido de uma descrição. Um exemplo para uma loja seria:

start - Inicia o atendimento
horarios - Mostra o horário da loja
pedido - Consulta um pedido
ajuda - Exibe as opções disponíveis

Os comandos começam com barra quando o usuário os envia, como /horarios. Segundo a documentação do Telegram, eles podem ter até 32 caracteres e usar letras latinas, números e sublinhado. Prefira palavras curtas e específicas: /novo_pedido é mais claro do que /novo seguido de várias perguntas.

Como testar o bot sem escrever código

Antes de montar uma automação, faça dois testes básicos. Primeiro, abra o perfil do seu bot pelo username e toque em Start. Sem essa primeira conversa, o bot não terá uma interação privada para responder.

Depois, valide o token com o método getMe. No navegador, substitua o trecho entre chaves pelo token real:

https://api.telegram.org/bot{SEU_TOKEN}/getMe

Se o token estiver correto, a API retornará um JSON com ok: true e os dados básicos do bot. Se aparecer erro, confira se você copiou o token inteiro, sem espaços ou quebras de linha. Não cole a URL completa em um lugar público: ela contém sua credencial.

Esse teste confirma que o cadastro funciona, mas ainda não cria uma resposta automática. Para isso, é preciso escolher como o bot receberá mensagens.

Como o bot recebe mensagens: getUpdates ou webhook

A API oferece dois caminhos que não devem ser usados ao mesmo tempo:

• getUpdates: sua aplicação consulta o Telegram e busca as mensagens pendentes. É simples para testes locais.
• webhook: o Telegram envia cada atualização para uma URL HTTPS do seu sistema. É mais adequado para um fluxo publicado.

As atualizações ficam armazenadas no servidor até serem recebidas, mas a documentação informa que elas não são mantidas por mais de 24 horas. Em um teste rápido, getUpdates ajuda a enxergar o que chegou. Em produção, um webhook costuma deixar o fluxo mais direto, desde que você tenha uma URL HTTPS funcionando.

Se a ideia for conectar o bot a uma automação visual, o tutorial do JSMS sobre webhooks no n8n ajuda a entender o conceito de receber dados em um fluxo. A configuração específica do Telegram ainda depende do nó ou da integração escolhida.

Como automatizar respostas depois do cadastro

Você pode seguir três caminhos:

Automação visual

n8n, Make e plataformas parecidas permitem receber uma atualização, verificar o texto e devolver uma resposta sem montar toda a infraestrutura de um bot. É o caminho mais amigável para um FAQ, uma triagem ou um aviso interno. A limitação é que recursos avançados podem exigir plano pago, hospedagem e cuidado com os dados enviados a terceiros.

Script próprio

Um programa em Python, JavaScript, Go ou outra linguagem chama a API e implementa as regras do atendimento. Dá mais controle, mas você terá de cuidar de hospedagem, logs, falhas, segurança e atualização do código.

Integração com um sistema existente

Um bot pode consultar estoque, agenda, CRM ou banco de dados. Nesse cenário, o Telegram é apenas a tela de conversa. A parte mais importante passa a ser a autorização: não revele dados de um cliente só porque alguém enviou um número de pedido.

Em qualquer opção, guarde o token em variável de ambiente ou em um gerenciador de segredos. Se ele vazar, volte ao BotFather, gere um novo token e retire o antigo da aplicação. Não dependa apenas de apagar a mensagem que continha a credencial.

Limitações que aparecem logo no primeiro projeto

O bot não inicia uma conversa privada com qualquer pessoa por conta própria. Em regra, o usuário precisa abrir o chat e falar com ele primeiro. Além disso, um token válido não dá permissão automática para acessar grupos, canais, contas ou sistemas externos.

Em grupos, o comportamento também depende das permissões e do modo de privacidade. O bot pode não receber todas as mensagens do grupo, especialmente quando a privacidade está ativada. Por isso, um teste em conversa privada não garante que o mesmo fluxo funcionará dentro de um grupo.

Outro cuidado é tratar toda mensagem como dado não confiável. Valide comandos, limite o que cada usuário pode fazer, não execute texto recebido como código e registre o mínimo necessário. Um bot que consulta pedidos ou agenda pode lidar com informações pessoais, então a conveniência não elimina a responsabilidade de proteger os dados.

Checklist rápido para colocar o bot em funcionamento

• Crie o bot com /newbot.
• Guarde o token fora do código e de arquivos públicos.
• Configure nome, descrição e comandos.
• Abra o bot e toque em Start.
• Teste o token com getMe.
• Escolha getUpdates para experimentar ou webhook para um fluxo publicado.
• Teste mensagens inválidas, permissões e perda de conexão.
• Revogue o token se ele aparecer em um print, repositório ou conversa.

Perguntas frequentes

É possível criar um bot no Telegram pelo celular?

Sim. O cadastro pelo BotFather e a configuração básica podem ser feitos no aplicativo. Para respostas automáticas mais complexas, você ainda precisará de uma automação ou aplicação acessível pela internet.

O bot do Telegram é gratuito?

A criação do bot e o uso básico da Bot API não exigem uma taxa de cadastro. Porém, hospedagem, automações pagas, banco de dados e serviços externos podem gerar custos.

Por que meu bot não responde?

Confira se você tocou em Start, se o token está correto e se existe uma aplicação ou fluxo rodando para processar as mensagens. Se estiver usando webhook, verifique também a URL HTTPS e os logs do serviço.

Posso colocar o token do bot no código?

Funcionar, pode; é uma má prática. Use variável de ambiente ou um cofre de segredos. Se o token for exposto, revogue-o no BotFather e gere outro.