Sim. Você pode criar alertas no Telegram com n8n sem desenvolver um servidor do zero: o n8n recebe o evento que interessa, monta a mensagem e usa um bot para entregá-la em uma conversa, grupo ou canal. É útil para avisos de novos pedidos, falhas em serviços, tarefas vencendo e mudanças em planilhas.
Neste guia, vou montar o caminho mais simples: um disparador de agenda enviando uma mensagem pelo Telegram. Depois, o mesmo bloco pode ser ligado a um formulário, webhook, banco de dados ou ferramenta de monitoramento. O bot não “adivinha” o que deve avisar; ele apenas executa o fluxo que você definiu.
O que você vai montar
O fluxo terá duas partes:
- Schedule Trigger: inicia o workflow em um horário ou intervalo definido;
- Telegram: envia o texto para o chat escolhido.
Para testar, basta uma conta no Telegram e uma instalação do n8n Cloud ou uma instância própria. O n8n tem nós nativos para iniciar workflows com eventos do Telegram e para executar operações como Send Message. A documentação também lista envio de fotos, arquivos, localização e edição de mensagens.
1. Crie o bot no Telegram
- Abra o Telegram e procure por @BotFather.
- Envie o comando
/newbote siga as instruções. - Escolha um nome de exibição e um username terminado em
bot. - Copie o token fornecido e guarde-o como uma senha.
O token permite controlar o bot pela API. Não publique esse valor em screenshots, repositórios ou mensagens. Se ele vazar, volte ao BotFather e gere um novo token antes de continuar.
2. Crie a credencial do Telegram no n8n
- Abra Credentials no n8n e crie uma credencial do tipo Telegram.
- Cole o token do BotFather no campo solicitado.
- Salve e use a opção de teste, quando ela estiver disponível.
A credencial é a ponte entre o n8n e a Bot API. Ela não substitui a permissão do chat: para conversar em privado, abra o bot e toque em Start; para um grupo ou canal, adicione o bot e conceda somente os privilégios necessários.
3. Descubra o chat ID
O Telegram precisa saber para onde enviar a mensagem. A forma mais fácil de descobrir o identificador é usar o nó Telegram Trigger:
- Crie um workflow novo e adicione Telegram Trigger.
- Selecione a credencial criada e escolha o evento Message.
- Execute o nó em modo de teste.
- Abra o bot no Telegram e envie
/startou uma mensagem curta. - No resultado do nó, procure o campo de chat dentro da atualização recebida, normalmente em
message.chat.id.
Copie esse número para usar no nó de envio. Em grupos e canais, o identificador pode ser negativo; não remova o sinal. Se você quiser entender melhor como um evento chega ao n8n, veja também o nosso guia sobre como criar um webhook no n8n e conectar um formulário a uma automação.
4. Monte o alerta no n8n
- Crie outro workflow e adicione o nó Schedule Trigger.
- Defina um intervalo simples, como a cada hora, ou um horário diário.
- Conecte o Schedule Trigger ao nó Telegram.
- Na operação do Telegram, escolha Message > Send Message.
- Selecione a credencial, informe o Chat ID e escreva o texto.
- Salve, execute uma vez e confira a mensagem no Telegram.
Para o primeiro teste, use um texto fixo:
🔔 Lembrete automático
O workflow do n8n executou corretamente.Quando o teste funcionar, troque o texto fixo por dados de outros nós. Por exemplo, um workflow que consulta uma planilha pode enviar o nome do cliente e o número do pedido; um monitoramento pode incluir o serviço afetado e o horário da falha. Use expressões do n8n para inserir esses campos, mas valide o resultado com uma mensagem de teste antes de ativar o fluxo.
5. Transforme o teste em uma automação útil
O Schedule Trigger é só a porta de entrada. Você pode substituí-lo ou combiná-lo com:
- um webhook que recebe eventos de um site ou sistema;
- um nó de Google Sheets para avisar quando uma linha nova aparecer;
- um monitoramento que dispara quando um serviço retorna erro;
- um calendário que envia lembretes de compromissos;
- um banco de dados que procura registros pendentes.
Para notificações operacionais, escreva mensagens curtas e inclua contexto: o que aconteceu, quando aconteceu e qual ação é esperada. Um alerta que só diz “erro” economiza pouco tempo, porque obriga alguém a investigar tudo do zero.
Problemas comuns
O bot não envia mensagem
Confira se você abriu a conversa privada e pressionou Start, se o Chat ID está correto e se a credencial usada no nó é a mesma que recebeu a mensagem. Em grupos e canais, confirme se o bot ainda está presente e se tem permissão para publicar.
O workflow recebe mensagens, mas não envia alertas
Verifique a conexão entre os nós e execute o nó Telegram isoladamente. Também confira se o workflow está ativo: executar um teste manual não é a mesma coisa que deixá-lo publicado para rodar pela agenda.
Há mensagens duplicadas
O Telegram oferece duas formas mutuamente exclusivas de receber atualizações: getUpdates e webhook. Não configure as duas para o mesmo bot. No n8n, prefira deixar o nó cuidar da integração e remova configurações antigas feitas manualmente se elas estiverem interferindo.
Limites e cuidados
Um bot não é um sistema completo de atendimento nem um substituto para controle de acesso. O fluxo pode falhar, a mensagem pode chegar atrasada e um erro de lógica pode gerar dezenas de alertas. Comece com uma conversa de teste, registre as execuções e inclua uma condição para evitar repetição.
Também vale separar alertas informativos de alertas críticos. Para um incidente importante, use pelo menos dois canais de acompanhamento; depender de uma única mensagem no Telegram cria um ponto único de falha. E nunca coloque senha, token, CPF ou outros dados sensíveis no texto sem necessidade.
FAQ
Preciso programar para criar um alerta no Telegram com n8n?
Não para o fluxo básico. Você configura os nós visualmente e pode usar expressões prontas para inserir dados. Programação só se torna necessária quando a regra ou a transformação dos dados é mais específica.
Posso enviar alertas para um grupo ou canal?
Sim. Adicione o bot ao destino e informe o Chat ID correto. Em canais e algumas operações de grupo, o bot precisa ser administrador ou receber a permissão exigida pelo Telegram.
Posso usar o mesmo bot para receber e enviar mensagens?
Sim. O Telegram Trigger pode iniciar o workflow quando chega uma mensagem e o nó Telegram pode responder ou enviar outra mensagem. Separe os fluxos quando isso facilitar o controle e a manutenção.
O n8n substitui a API do Telegram?
Não. O n8n funciona como uma camada visual de automação sobre serviços e APIs. Neste caso, ele usa a Bot API do Telegram sem exigir que você escreva todas as requisições HTTP manualmente.