Pular para o conteúdo
JSMS
Automação

Como criar alertas no Telegram com n8n: passo a passo para automatizar notificações

· 6 min de leitura

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.

Primeiro modelo de iPhone exibido em uma tela, imagem ilustrativa de celular e notificações
O alerta pode chegar ao celular a partir de um fluxo automático. Imagem: Wikimedia Commons.

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

  1. Abra o Telegram e procure por @BotFather.
  2. Envie o comando /newbot e siga as instruções.
  3. Escolha um nome de exibição e um username terminado em bot.
  4. 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

  1. Abra Credentials no n8n e crie uma credencial do tipo Telegram.
  2. Cole o token do BotFather no campo solicitado.
  3. 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:

  1. Crie um workflow novo e adicione Telegram Trigger.
  2. Selecione a credencial criada e escolha o evento Message.
  3. Execute o nó em modo de teste.
  4. Abra o bot no Telegram e envie /start ou uma mensagem curta.
  5. 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

  1. Crie outro workflow e adicione o nó Schedule Trigger.
  2. Defina um intervalo simples, como a cada hora, ou um horário diário.
  3. Conecte o Schedule Trigger ao nó Telegram.
  4. Na operação do Telegram, escolha Message > Send Message.
  5. Selecione a credencial, informe o Chat ID e escreva o texto.
  6. 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.

Fontes consultadas