- O token do bot sai do BotFather, o bot oficial do próprio Telegram — leva menos de dois minutos.
- No n8n, o par é sempre o mesmo: Telegram Trigger para receber e Telegram (Send Message) para responder.
- A credencial guarda o token uma vez só e serve para todos os nodes de Telegram do fluxo.
- Para um bot que responde sozinho, encaixe um node de IA (AI Agent / OpenAI) entre o gatilho e a resposta.
- Funciona igual no n8n Cloud e no self-hosted; a diferença é só onde o webhook está hospedado.
1. Crie o bot no BotFather e pegue o token
Abra o Telegram e procure por @BotFather (o verificado, com selo azul). Envie /newbot, escolha um nome de exibição e um username que termine em 'bot' (ex.: minhaempresa_bot). O BotFather devolve um token — uma sequência longa tipo 123456:ABC-DEF... Copie e guarde: é a chave que dá ao n8n permissão para agir como esse bot.
2. Cadastre a credencial do Telegram no n8n
No n8n, vá em Credentials > New e escolha 'Telegram API'. Cole o token no campo Access Token e salve. Essa credencial fica reutilizável: qualquer node de Telegram no seu fluxo vai apontar para ela, sem precisar colar o token de novo.
3. Adicione o gatilho Telegram Trigger
Crie um novo workflow e adicione o node 'Telegram Trigger'. Selecione a credencial do passo anterior e, em Updates, marque 'message' para o bot reagir a mensagens recebidas. O n8n gera um webhook e registra ele no Telegram automaticamente — é por esse endereço que as mensagens chegam.
4. Adicione o node de resposta (Send Message)
Conecte um node 'Telegram' na saída do gatilho e escolha a operação 'Send Message'. No campo Chat ID use a expressão {{ $json.message.chat.id }} para responder a quem escreveu, e em Text escreva a mensagem. Assim o bot devolve a resposta no mesmo chat de onde veio a pergunta.
5. Teste e ative o workflow
Clique em 'Test workflow', mande uma mensagem para o seu bot no Telegram e veja a execução acender no canvas. Funcionou? Ative o workflow no botão do topo. Enquanto estiver ativo, o bot responde 24 horas por dia sem você precisar deixar nada aberto.
6. (Opcional) Faça o bot responder com IA
Para sair das respostas fixas, coloque um node de IA — o AI Agent ou o node da OpenAI — entre o gatilho e o Send Message. O texto que chega ({{ $json.message.text }}) vira o prompt, e a resposta do modelo alimenta o campo Text do node de Telegram. Pronto: um assistente conversacional sem uma linha de código.
Por que usar o n8n para um bot de Telegram
Dá para programar um bot de Telegram na unha, com Python e a Bot API. Mas para a maioria dos casos — avisar sobre um pedido novo, responder dúvidas, disparar um lembrete — isso é trabalho demais para um resultado que o n8n entrega arrastando blocos.
A vantagem prática é o que vem depois do 'olá, mundo'. Assim que a mensagem entra pelo gatilho, ela está dentro do n8n, onde você pluga Google Sheets, um CRM, um banco de dados ou um modelo de IA na mesma tela. O Telegram deixa de ser só um chat e vira a porta de entrada de uma automação inteira.
Chat ID: o detalhe que trava quem está começando
O erro mais comum de quem monta o primeiro bot é o node de resposta não saber para onde mandar a mensagem. O Telegram identifica cada conversa por um Chat ID, e ele vem embutido na mensagem recebida.
Por isso a expressão {{ $json.message.chat.id }} no campo Chat ID resolve quase tudo: ela pega o ID de quem acabou de escrever e responde exatamente naquela conversa. Se você digitar um número fixo ali, o bot só vai conseguir falar com um único chat — útil para notificações internas, atrapalhado para atendimento.
Cloud ou self-hosted: muda alguma coisa?
O passo a passo é idêntico nos dois. O que muda é onde mora o webhook que recebe as mensagens. No n8n Cloud, ele já nasce com um endereço público e o registro no Telegram é automático.
No self-hosted, o bot só funciona se o seu n8n estiver acessível pela internet com HTTPS — em VPS com domínio e certificado, por exemplo. Rodando na sua máquina em localhost, o Telegram não consegue entregar as mensagens no webhook, e o gatilho fica mudo. É a pegadinha número um de quem instala em casa para testar.
Perguntas frequentes
Preciso saber programar para criar um bot de Telegram com n8n?
Criar o bot no Telegram é gratuito?
Meu bot pode responder com inteligência artificial?
Por que meu bot não responde no n8n self-hosted?
Leia também
O que é n8n? Guia completo para iniciantes em 2026
Entenda o que é n8n, como a ferramenta de automação funciona, quanto custa, se é difícil de aprender e como criar seu primeiro workflow sem saber programar.
Ler →
Como automatizar respostas no WhatsApp com n8n (passo a passo)
Como automatizar o WhatsApp com n8n e a Evolution API: receber a mensagem por webhook, responder sozinho e plugar IA. Passo a passo em português, sem tomar ban e sem custo de API oficial.
Ler →
Como criar um chatbot de WhatsApp com IA usando n8n e Z-API
Monte um chatbot de WhatsApp com IA de verdade no n8n com a Z-API: conecte por QR Code, aponte o webhook, use o nó AI Agent com memória e responda sozinho. Passo a passo com custos e anti-ban.
Ler →
Como integrar o n8n com a OpenAI (ChatGPT): guia prático 2026
Guia direto para conectar o n8n à OpenAI: gerar a API key, configurar a credencial, escolher o modelo certo e montar o primeiro fluxo com ChatGPT. Com custos reais e erros comuns.
Ler →
Como criar um agente de IA com n8n sem saber programar
Crie um agente de IA com n8n sem escrever código: conecte a OpenAI, dê memória de conversa ao nó AI Agent, ligue ferramentas e coloque no WhatsApp. Passo a passo em português, do zero.
Ler →