Como criar um bot no Telegram e automatizar respostas com n8n

Você cria um bot do Telegram em duas etapas: primeiro registra a conta com o BotFather e recebe um token; depois conecta esse token a um programa ou a uma ferramenta de automação, como o n8n. O comando /newbot, sozinho, não cria respostas automáticas.

Neste guia, mostro o caminho mais simples para sair do zero, testar o bot e montar uma resposta automática sem escrever código. Também explico quando vale usar a API diretamente, o que muda em grupos e quais cuidados evitam que o token vire um problema de segurança.

O que é um bot do Telegram?

Um bot é uma conta controlada por software. Em vez de uma pessoa tocar na tela para responder, um programa recebe uma atualização do Telegram, toma uma decisão e chama a API para enviar a próxima mensagem. É como um atendente muito rápido, mas que só faz o que você ensinou.

O Telegram Bot Platform permite criar bots para atendimento, notificações, formulários, consulta de dados, pagamentos e integração com outros serviços. O ponto importante é não confundir registro com automação: o BotFather cria a identidade do bot; um backend, script ou plataforma como n8n dá a ele uma função.

O que você precisa antes de começar

• uma conta ativa no Telegram;
• acesso ao usuário oficial @BotFather;
• um objetivo pequeno para o primeiro teste, como responder “olá”;
• um ambiente para executar a automação: n8n hospedado, servidor próprio ou código local.

Se você só quer criar a conta para reservar o nome, os três primeiros itens bastam. Para ter um bot funcional, o próprio FAQ oficial do Telegram explica que é necessário conectá-lo a um servidor ou serviço por meio da API.

Como criar o bot no Telegram pelo BotFather

1. Abra o BotFather e envie /newbot

No aplicativo do Telegram, procure por @BotFather e confirme que está falando com o perfil oficial. Envie /newbot. O assistente pedirá duas informações:

1. Nome: o texto exibido nos detalhes do contato. Ele pode ser alterado depois.
2. Username: o identificador usado em buscas, menções e links t.me. Ele deve ter entre 5 e 32 caracteres, usar letras latinas, números ou sublinhado e terminar em bot, como atendimento_jsms_bot.

O username não pode ser alterado depois, de acordo com a documentação de credenciais do n8n. Portanto, escolha algo que não dependa de uma campanha passageira ou de um produto que pode mudar de nome.

2. Copie e proteja o token

Ao finalizar, o BotFather entregará um token parecido com 123456789:AA.... Ele autentica o bot na API — não é a senha da sua conta pessoal, mas deve ser tratado como uma senha. Não publique a chave em tutorial, repositório, planilha compartilhada ou captura de tela.

Se o token escapar, use o BotFather para revogá-lo e gerar outro. Depois, troque a credencial no n8n ou no seu código. Um atacante com essa chave pode agir como o seu bot dentro das permissões disponíveis.

3. Configure comandos úteis

Para melhorar a navegação, use o recurso de comandos do BotFather e cadastre opções como start, ajuda e horarios. Os comandos devem ser curtos e previsíveis. Uma lista enorme não transforma um bot ruim em um bom atendimento; apenas esconde a função principal.

Como automatizar respostas sem programar usando n8n

O n8n é uma opção visual: você conecta blocos em um fluxo e configura as ações em formulários. Ainda é preciso ter uma instância do n8n funcionando e entender a lógica do atendimento, mas não é necessário começar escrevendo um servidor em Python ou JavaScript.

1. Crie a credencial do Telegram

No n8n, crie uma credencial do tipo Telegram API e cole o token gerado pelo BotFather no campo Access Token. A documentação do n8n confirma que a mesma credencial pode autenticar os nós Telegram e Telegram Trigger.

2. Receba uma mensagem

Crie um workflow com o nó Telegram Trigger. No evento, selecione Message, que representa uma nova mensagem recebida. Para o primeiro teste, não baixe arquivos e não filtre por usuário: deixe o caminho mínimo funcionar antes de adicionar regras.

3. Envie a resposta

Adicione o nó Telegram e escolha a operação Send Message. No campo de destino, use o chat.id que veio no evento recebido pelo trigger; no texto, escreva algo como “Recebi sua mensagem. Em que posso ajudar?”. A documentação do n8n lista essa operação e também recursos para editar mensagens, enviar arquivos e consultar chats.

O fluxo básico fica assim:

Telegram Trigger (Message)
        ↓
Telegram (Send Message)
        ↓
resposta para o mesmo chat

Ative o workflow, abra o bot no Telegram, toque em Start ou envie uma mensagem e confira a execução no n8n. Se nada acontecer, verifique se o workflow está ativo, se o token foi colado sem espaços e se a instância do n8n consegue receber conexões externas. Para entender a lógica de entradas externas, veja também nosso guia sobre como criar um webhook no n8n para receber dados de um formulário.

Como fazer o primeiro teste pela API

Mesmo sem montar um bot completo, você pode confirmar se o token está válido pelo método getMe. No terminal, armazene a chave em uma variável de ambiente e rode:

curl "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe"

A API responde em JSON com dados do bot quando a autenticação funciona. A documentação do Telegram descreve o Bot API como uma interface HTTP e mostra esse teste no tutorial oficial. Evite substituir a variável pelo token diretamente em comandos salvos no histórico do shell.

Para responder mensagens de verdade, o programa precisa receber atualizações por long polling ou webhook. Esses modos são mutuamente exclusivos: o método getUpdates não funciona enquanto um webhook de saída estiver configurado. Em uma plataforma visual, deixe o próprio nó de trigger cuidar da conexão e consulte os logs quando a entrega falhar.

O que muda quando o bot entra em um grupo?

Em uma conversa privada, o bot recebe as mensagens enviadas diretamente a ele. Em grupos, o Privacy Mode limita o que ele enxerga. Com a privacidade ativada, o bot recebe comandos direcionados a ele, comandos gerais em situações específicas, mensagens enviadas por ele e respostas às suas mensagens. Um bot administrador ou com o modo desativado pode receber mais mensagens, exceto mensagens de outros bots.

Essa limitação é uma proteção, não um defeito. Desative a privacidade somente quando o bot realmente precisar ler o grupo inteiro, como em uma moderação, e avise os participantes. Bots também não devem conversar entre si: o Telegram impede que eles recebam mensagens de outros bots para evitar loops.

Erros comuns ao criar um bot do Telegram

• “O bot foi criado, mas não responde”: o registro não inclui um servidor. Conecte o token ao n8n, a um script ou a outra aplicação.
• Username rejeitado: confira se ele termina em bot, tem o tamanho permitido e ainda está disponível.
• O trigger repete mensagens: não mantenha dois sistemas consumindo atualizações do mesmo bot. Long polling e webhook não devem ser usados ao mesmo tempo.
• O bot não vê mensagens do grupo: revise o Privacy Mode e as permissões de administrador.
• Erro 429: reduza a frequência. O FAQ do Telegram recomenda não enviar mais de uma mensagem por segundo no mesmo chat; em grupos, há limite de 20 mensagens por minuto.

Vale a pena criar um bot no Telegram?

Para uma automação pequena, sim. O conjunto BotFather + n8n resolve notificações, triagem inicial, consulta de status e encaminhamento para uma equipe sem exigir um projeto inteiro. Para um atendimento crítico, porém, trate o fluxo como software: registre erros, limite permissões, proteja dados pessoais e mantenha uma rota para falar com uma pessoa.

A melhor primeira versão é deliberadamente sem graça: um comando, uma entrada e uma resposta. Depois que esse circuito estiver comprovado, adicione botões, banco de dados, IA ou integração com planilhas. Começar pelo “superbot” costuma produzir apenas um fluxo difícil de testar e fácil de quebrar.

Perguntas frequentes

Preciso saber programar para criar um bot no Telegram?

Para registrar a conta no BotFather, não. Para fazê-la responder, você precisa de código ou de uma plataforma visual, como o n8n, que ainda exige configuração de um workflow.

O token do bot pode ser compartilhado?

Não. Ele funciona como uma credencial de acesso à API. Guarde-o em variável de ambiente ou cofre de segredos e revogue-o no BotFather se houver suspeita de vazamento.

Posso usar o mesmo bot no n8n e em um programa próprio?

É possível integrar o bot a diferentes serviços, mas não é uma boa ideia manter dois consumidores de atualizações concorrendo. Escolha uma estratégia de recebimento e centralize o fluxo.

O bot consegue ler tudo em um grupo?

Depende do Privacy Mode, das permissões e do tipo de mensagem. Com a privacidade ativada, ele recebe somente eventos relacionados a ele; para ler mais, pode ser necessário desativar o modo ou torná-lo administrador.