Neurocourse

Seu primeiro workflow: um resumo matinal no Telegram

Vamos montar seu primeiro workflow que roda: toda manhã às 9:00 o n8n pega dados (clima ou e-mail) e te manda um resumo no Telegram. No caminho: o canvas, as configurações dos nodes, o Execute e a ativação.

O melhor primeiro workflow é aquele que já te serve amanhã de manhã. Vamos montar um “resumo matinal”.

Três nodes, é só isso

[Schedule: todo dia às 9:00]
   → [HTTP Request: buscar dados (clima/notícias/cotações)]
   → [Telegram: me mandar a mensagem]

Passo a passo

  1. Novo workflow → “+” → procure a node Schedule Trigger → coloque nas 9:00.
  2. Adicione uma node HTTP Request — o coringa do “vá até este endereço e traga os dados”. Para o clima, qualquer API aberta serve (open-meteo, por exemplo — sem chaves): cole a URL das notas da aula.
  3. Node Telegram → operação Send Message. Você vai precisar de uma conexão: um token de bot (o @BotFather te dá um em um minuto — se você fez o curso de bots, já tem) e o seu chat ID. O n8n guarda conexões assim em Credentials — configura uma vez, usa em todo workflow.
  4. O botão Execute Workflow — uma execução manual. A mensagem chegou? Funciona.
  5. O interruptor Active — agora o workflow vive por conta própria: toda manhã, sem você.

Duas coisas que esta aula te ensina

  • Execute antes de ativar. Rode sempre na mão e veja o que saiu de cada node (clicar numa node mostra o que passou por ela). Depurar no n8n é olhar os dados, e isso é mais fácil do que parece.
  • As credentials ficam separadas dos workflows. Tokens e senhas ficam num cofre seguro, não dentro das nodes — a velha ideia de “manter os segredos fora do código”.

O que HTTP Request é de verdade

A node HTTP Request é o bloco mais versátil do n8n: ela bate num endereço da internet e traz a resposta. Quase todo serviço do mundo entrega dados num endereço desses (é o que as pessoas chamam de API). Para o clima, o open-meteo cai bem — API aberta, sem chaves, sem cadastro. É assim que a requisição fica:

GET https://api.open-meteo.com/v1/forecast
    ?latitude=52.52&longitude=13.41¤t=temperature_2m

A resposta (um pedaço):
{ "current": { "temperature_2m": 3.4, "time": "2026-07-15T09:00" } }

Mais adiante, na node Telegram, você vai puxar temperature_2m dessa resposta e encaixar no seu texto — a gente vê exatamente como na próxima aula, sobre dados passando entre as nodes. Por ora basta saber: o HTTP Request trouxe um JSON, e JSON é só campo e valor.

O que costuma dar errado na primeira vez

  • “Bad credentials” no Telegram. O token foi copiado com um espaço a mais, ou é de outro bot. Refaça a conexão em Credentials e cole o token limpo, sem nada em volta.
  • Nenhuma mensagem, mas nenhum erro também. Você nunca escreveu para o bot primeiro. Um bot do Telegram não abre conversa — abra o chat, aperte Start, e só então ele pode te escrever.
  • Chat ID errado. O @userinfobot te diz o seu: encaminhe qualquer mensagem para ele e ele responde com um número. Esse número é o seu chat ID.
  • “Não roda no horário.” Confira o interruptor Active: sem ele, o Schedule Trigger só dorme. Um Execute manual sempre funciona; o horário só vale para um workflow ativo.

Por que os engenheiros dizem “primeiro Execute, depois Active” e nunca ao contrário? Pense: um workflow ativo dispara sozinho, sem ninguém olhando. Se tiver algo quebrado nele, você descobre quando um cliente recebe uma mensagem toda torta. Essa execução na mão é a sua única chance de olhar os dados antes de todo mundo.

Por que o Telegram é a saída perfeita para começar

A gente manda o resumo para o Telegram de propósito. Primeiro, um bot se monta em um minuto com o @BotFather e não pede servidor de e-mail nem conta paga. Segundo, a mensagem cai no seu bolso na hora — perfeito para ver que o workflow disparou. Terceiro, você vai usar essa mesma node Telegram em todas as aulas seguintes: avisar um vendedor sobre um lead, as respostas do seu bot RAG, aprovar conteúdo com botões.

Configure a conexão uma vez em Credentials e ela fica pronta para o resto do curso. Se você fez o curso de bots, já tem token e sabe o que é um chat ID; se não fez, esses dois minutos se pagam dez vezes.

Faça agora

Monte o workflow de três nodes: Schedule Trigger às 9:00 → HTTP Request para o open-meteo com as coordenadas da sua cidade → Telegram Send Message com qualquer texto, “Bom dia!” já vale. Aperte Execute Workflow e confira se a mensagem chega. Ainda sem a temperatura no texto — isso a gente encaixa na aula de dados. Quando funcionar, ligue o Active, e amanhã às 9:00 você recebe a primeira mensagem de um workflow que você mesmo montou.

Practice · 4 задачи

Short questions on the lesson — with an explanation for every answer.