Sim, dá para usar um bot do Telegram como canal de alertas sem escrever um servidor do zero. Neste tutorial, você vai criar o bot no BotFather, conectar o token ao n8n e montar um fluxo que envia uma mensagem quando um gatilho acontece — por horário, webhook ou outro serviço.
A ideia serve para avisar sobre novos pedidos, falhas em uma automação, vencimentos, monitoramento de site ou qualquer evento que já possa ser capturado pelo n8n. O ponto que costuma travar iniciantes não é o envio da mensagem, mas descobrir o chat ID correto e guardar o token como uma senha.
O que você precisa antes de começar
- Uma conta no Telegram;
- um bot criado pelo BotFather;
- uma instalação do n8n, na nuvem ou em um servidor próprio;
- um chat, grupo ou canal que receberá as mensagens;
- um evento para testar o fluxo.
Você não precisa de uma API paga para o exemplo básico. O bot usa a API HTTP do Telegram, enquanto o n8n fornece os nós visuais para autenticar e enviar a mensagem. Para tarefas mais avançadas, como responder comandos, receber arquivos ou editar mensagens, o nó do Telegram também oferece operações específicas.
1. Crie o bot no Telegram
Abra o Telegram, procure por @BotFather e envie o comando /newbot. O assistente pedirá um nome visível e um username. O username precisa terminar em bot, como avisos_empresa_bot; depois de criado, ele não pode ser alterado.
No final, o BotFather exibirá um token de acesso. Ele identifica e autoriza o bot perante a API. Copie o valor, mas não publique em código, captura de tela, planilha compartilhada ou mensagem de grupo. Se o token vazar, volte ao BotFather e gere outro.
O próprio Telegram trata esse token como uma credencial. A documentação oficial mostra que ele pode ser revogado e recomenda mantê-lo em local seguro. No n8n, ele será salvo na credencial do serviço, não no texto da mensagem.
2. Descubra para onde o bot deve enviar a mensagem
Para uma conversa privada, abra o link do seu bot, toque em Iniciar e envie uma mensagem, como /start. Isso cria uma interação que o n8n consegue usar para identificar o chat. Se a mensagem for para um grupo, adicione o bot ao grupo; em um canal, ele precisa ser adicionado como administrador com permissão para publicar.
O n8n recomenda usar o Telegram Trigger para capturar o chat ID. Crie temporariamente esse gatilho, execute o workflow, mande uma mensagem para o bot e examine o resultado. O identificador aparecerá nos dados recebidos pelo nó.
Em grupos, o chat ID normalmente é negativo. Não remova o sinal de menos ao copiá-lo. Em canais públicos, também é possível usar o username no formato @nomedocanal, mas grupos privados exigem o ID numérico.
3. Cadastre o token no n8n
No n8n, abra Credentials, crie uma credencial do tipo Telegram e cole o token no campo Access Token. Salve e, se a interface oferecer a opção, teste a credencial. O n8n usa essa mesma autenticação no nó Telegram e no Telegram Trigger.
Se você já trabalha com chaves em workflows, vale aplicar o mesmo cuidado usado para outras APIs: não coloque o token em um nó de código nem em uma variável exibida no resultado. Veja também o nosso guia sobre como proteger chaves de API no n8n sem expor seus segredos.
4. Monte o workflow de alerta
Para um teste simples, crie um novo workflow e adicione estes nós:
- Schedule Trigger: dispara o fluxo em um horário ou intervalo;
- Telegram: escolha a operação de envio de mensagem;
- opcionalmente, um nó anterior que produza os dados do alerta.
Conecte o gatilho ao nó Telegram. No campo Chat ID, informe o ID encontrado no passo anterior. Em Text, comece com uma mensagem fixa:
🔔 Alerta de teste
O workflow do n8n conseguiu enviar esta mensagem pelo Telegram.Execute o workflow manualmente. Se a mensagem chegar, a conexão básica está funcionando. Depois, troque o texto fixo por uma expressão que leia os dados do nó anterior. Um exemplo genérico é:
⚠️ Novo evento
Tipo: {$json.tipo}
Detalhes: {$json.detalhes}
Horário: {$now}Os nomes tipo e detalhes precisam existir na saída do seu nó anterior. Caso o evento venha de um webhook, por exemplo, você pode colocar o Webhook antes do Telegram; se vier de uma planilha, banco de dados ou sistema de vendas, use o nó correspondente e mapeie os campos no editor de expressões.
5. Remova a assinatura automática do n8n, se quiser
O nó Telegram do n8n pode acrescentar uma atribuição automática ao final da mensagem. Se isso não fizer sentido para o seu alerta, abra Additional Fields, adicione Append n8n attribution e desligue a opção. Faça isso apenas depois de confirmar que o fluxo está funcionando; durante o teste, a assinatura ajuda a lembrar de onde veio a mensagem.
Como testar e diagnosticar o erro
Faça o primeiro teste com uma conversa privada e uma mensagem curta. Depois confira nesta ordem:
- Unauthorized ou credencial inválida: o token foi copiado errado, revogado ou cadastrado na credencial errada;
- Chat not found: o chat ID não pertence ao bot ou está com formato incorreto;
- Forbidden em canal: o bot ainda não foi adicionado como administrador;
- mensagem que não chega em grupo: verifique se o bot está no grupo e se o modo de privacidade permite o tipo de atualização esperado;
- campos vazios: execute o nó anterior e confira o caminho real dos dados antes de montar a expressão.
Se o grupo tiver um ID com muitos dígitos, não tente adivinhar. Use o Telegram Trigger para capturar o valor ou consulte o método recomendado na documentação do n8n. Alterar um número por tentativa e erro só cria mensagens de erro mais confusas.
Limites que podem afetar seus alertas
Esse fluxo é ótimo para alertas operacionais, não para disparar mensagens em massa sem controle. A documentação do n8n informa um limite de aproximadamente 30 mensagens por segundo na API em determinados cenários. O FAQ do Telegram também recomenda não passar de uma mensagem por segundo no mesmo chat e de 20 mensagens por minuto em um grupo.
Se você precisa avisar muitas pessoas, coloque uma fila, agrupe eventos e use o Loop Over Items com pausas. Também evite mandar um alerta para cada pequena mudança: agregue ocorrências por alguns minutos e envie um resumo. Isso reduz ruído e ajuda a não transformar o Telegram em uma sirene que ninguém mais lê.
Vale a pena usar Telegram e n8n para alertas?
Para equipes pequenas, monitoramento, operações internas e protótipos, a combinação é prática porque o Telegram entrega a mensagem e o n8n conecta o evento às ferramentas que você já usa. O custo de implementação costuma ser menor do que criar um backend próprio só para notificações.
Há limites. O bot não substitui um sistema de chamados, não deve carregar segredos nas mensagens e depende de um workflow n8n disponível. Para atendimento ao cliente, informações sensíveis ou comunicação formal, avalie autenticação, retenção, permissões e o canal exigido pelo seu negócio antes de automatizar.
Perguntas frequentes
Preciso programar para conectar um bot do Telegram ao n8n?
Não para o fluxo básico. Você cria o bot, cadastra o token, escolhe o nó Telegram e preenche o chat ID. Expressões ou nós de código só entram quando a mensagem precisa tratar dados de forma mais específica.
Onde encontro o token do bot?
O token é fornecido pelo @BotFather depois do comando /newbot. Trate-o como senha e gere outro se houver suspeita de vazamento.
Por que o Telegram retorna “chat not found”?
Na maioria dos casos, o ID está errado, o bot ainda não iniciou uma conversa privada ou não foi adicionado ao grupo/canal. Use o Telegram Trigger para capturar o ID real.
Posso enviar alertas para um canal?
Sim. Adicione o bot ao canal como administrador e use o username público no formato @nomedocanal ou o ID adequado. Sem permissão de publicação, o Telegram recusará o envio.