Telegram no n8n: criar bot, credencial e enviar mensagem

Crie um bot no BotFather, configure a credencial do Telegram no n8n, monte o Telegram Trigger com Send Message e corrija os erros de webhook e HTTPS.

Por Redação Eleven Host · @robson.direitodigital · 29 de outubro de 2026 · 7 min de leitura

Telegram no n8n funciona com um bot: você cria o bot no BotFather, cola o token como credencial e usa o Telegram Trigger para receber mensagens e o nó Telegram para responder. Segundo a documentação do n8n, a mesma credencial serve aos dois nós.

Este guia leva você do zero ao primeiro fluxo: criar o bot, configurar a credencial, montar o gatilho e o envio e resolver os erros mais comuns. Os fatos vêm das páginas do n8n sobre a credencial do Telegram, o Telegram Trigger, o nó Telegram e os problemas comuns do gatilho, além da referência da API de bots do Telegram.

O que você precisa antes de começar

• Uma conta no Telegram, para falar com o BotFather.
• Um n8n funcionando, para criar o fluxo.
• Para o Telegram Trigger em produção, um endereço público com HTTPS, assunto que aparece na seção de erros.

Se você quer rodar o n8n por conta própria, a Eleven Host tem planos de n8n, e o guia de webhooks ajuda a entender como as chamadas chegam ao seu fluxo: Webhook no n8n: como criar, testar e colocar no ar.

Passo 1: criar o bot no BotFather

O BotFather é o bot oficial do Telegram para criar outros bots. A documentação do n8n descreve o caminho:

1. No Telegram, abra uma conversa com o BotFather.
2. Envie o comando /newbot.
3. Escolha o nome do bot. Ele aparece no contato e pode ser mudado depois.
4. Escolha o username, que tem de ter de 5 a 32 caracteres, com letras latinas, números e o sinal de sublinhado, e precisa terminar em "bot". Os exemplos da documentação são tetris_bot e TetrisBot. O username não muda depois.
5. Copie o token que o BotFather gera ao final.

Passo 2: criar a credencial no n8n

Com o token em mãos, volte ao n8n. A documentação manda colar o token como Access Token na credencial Telegram. Na prática:

1. Adicione um nó Telegram ou Telegram Trigger ao fluxo.
2. No campo de credencial do nó, crie uma credencial nova do tipo Telegram.
3. Cole o token no campo Access Token e salve.

Segundo a documentação, a mesma credencial serve para os nós Telegram e Telegram Trigger. Você cria uma vez e escolhe nos dois nós.

Se o token vazar, a documentação do n8n usada aqui não explica como trocá-lo, então consulte as instruções do BotFather ou da documentação do Telegram. Guarde o token num lugar seguro e nunca o coloque em prints ou textos públicos.

Passo 3: o Telegram Trigger recebe as mensagens

O Telegram Trigger é o gatilho que inicia o fluxo quando algo acontece com o bot. Você escolhe os eventos que o interessam. A documentação do n8n lista, entre eles:

• Message: uma nova mensagem de todo tipo, como texto, foto ou figurinha (sticker).
• Edited Message: uma mensagem que foi editada.
• Callback Query: outro evento da lista do nó.
• Channel Post: publicação em canal.
• Inline Query: consulta inline.
• Poll: enquete, e há outros eventos na lista do nó.

A opção "*" escolhe todos os eventos, com exceção de Chat Member, Message Reaction e Message Reaction Count. Para um primeiro bot de conversa, o evento Message resolve.

Opções do Telegram Trigger

O gatilho também tem opções que limitam ou ampliam o que ele recebe:

• Download Images/Files: baixa imagens e arquivos recebidos. Para imagens, há a opção Image Size.
• Restrict to Chat IDs: aceita mensagens só dos chats que você listar.
• Restrict to User IDs: aceita mensagens só dos usuários que você listar.

Nas duas últimas, a documentação diz que você pode informar vários IDs separados por vírgula.

Passo 4: responder com o nó Telegram

Para o bot responder, adicione o nó Telegram depois do gatilho. Escolha o recurso Message e a operação Send Message. Depois, informe o chat de destino e o texto. Os nomes dos campos podem variar conforme a versão, então siga o que o nó mostrar.

Para responder a quem escreveu, você precisa do id do chat. O Telegram Trigger mostra os dados da mensagem recebida na saída do nó, e é dali que você tira o id. No evento Message, o id do chat vem dentro de message.chat.id, estrutura da API de bots do Telegram, em que a mensagem tem um chat e o chat tem um id. Em uma expressão do n8n, isso fica assim:

{{ $json.message.chat.id }}

Com essa expressão no campo do chat, a resposta volta para a conversa de onde a mensagem veio.

Quer deixar seu bot do Telegram rodando num servidor, sem depender do seu computador? Veja o n8n Essencial a partir de R$ 19,90/mês e confira na loja o que cada plano inclui. Ver o n8n

O que mais o nó Telegram faz

Além de enviar texto, o nó Telegram reúne vários recursos, segundo a documentação:

• Chat: Get, Get Administrators, Get Member, Leave, Set Description e Set Title.
• Callback: Answer Query e Answer Inline Query.
• File: Get File.
• Message: Send Message, Send Photo, Send Document, Send Audio, Send Video, Send Location, Send Media Group, Send Animation, Send Sticker, Send Chat Action, Edit Message Text, Delete Chat Message e Pin ou Unpin Chat Message.

Para a maioria das operações em canal, o bot precisa estar no canal. Se a operação falha em um canal, confira primeiro se o bot foi adicionado a ele.

Quer dar inteligência ao bot? O guia n8n com ChatGPT: como usar a API da OpenAI nos fluxos mostra como ligar uma IA ao fluxo, e o resultado pode voltar ao chat pelo nó Telegram.

Erros comuns com o Telegram no n8n

A documentação do n8n tem uma página de problemas comuns do Telegram Trigger. Os três principais são estes.

1. O teste fica preso, ouvindo

Às vezes o gatilho fica esperando um evento e não sai disso. A orientação da documentação é sair do workflow e abrir de novo. Se o n8n está atrás de um proxy reverso, é preciso habilitar o websocket no proxy. A documentação cita Nginx, Caddy e Traefik. Para o Nginx, veja Nginx proxy reverso: como configurar na sua VPS.

2. "bad webhook: An HTTPS URL must be provided for webhook"

Essa mensagem aparece porque o Telegram exige HTTPS. A documentação indica dois ajustes:

• configurar a variável WEBHOOK_URL com a URL pública do n8n em HTTPS;
• ter a terminação TLS/SSL no proxy reverso.

3. Funciona só em teste ou só em produção

O Telegram "only allows you to register a single webhook per app", e por isso o teste e a produção disputam o mesmo bot. A documentação aponta duas saídas:

• usar bots separados, um para teste e outro para produção;
• despublicar o workflow durante o teste, o que interrompe a produção.

A primeira saída é a mais segura, porque você testa sem derrubar o bot que as pessoas usam.

Para ser avisado quando um fluxo falhar, veja Tratar erros no n8n: Error Trigger e alertas no fluxo.

Quer o n8n da Eleven Host para rodar seus bots num servidor? Compare os planos a partir de R$ 19,90/mês e confira na loja o que cada plano inclui. Escolher meu n8n

Perguntas frequentes

Como criar um bot do Telegram para usar no n8n?

Converse com o BotFather, envie /newbot, escolha nome e username e copie o token. Depois cole o token como Access Token na credencial Telegram do n8n.

O username do bot pode ser trocado depois?

Não. Segundo a documentação do n8n, o nome pode mudar depois, mas o username não. Ele tem de ter de 5 a 32 caracteres e terminar em "bot".

Uma credencial serve para o gatilho e para o envio?

Sim. A mesma credencial Telegram serve aos nós Telegram e Telegram Trigger.

Por que aparece "An HTTPS URL must be provided for webhook"?

Porque o Telegram exige HTTPS. Configure WEBHOOK_URL com a URL pública em HTTPS e use TLS/SSL no proxy reverso.

Por que o bot funciona no teste e não em produção?

O Telegram permite um único webhook por app. Use bots separados para teste e produção, ou despublique o workflow durante o teste, o que interrompe a produção.