Base de Conhecimento

Agendar fluxo no n8n: como usar o Schedule Trigger

  • n8n, schedule trigger, cron, agendamento, automação, tutorial
  • Usuários acharam útil: 0

Aprenda a agendar fluxo no n8n com o Schedule Trigger: escolha o intervalo ou o cron, ajuste o fuso horário, publique o fluxo e evite os erros comuns.

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

Arte da Eleven Host: janela de terminal com o título: Agendar fluxo no n8n: como usar o Schedule Trigger

Capa da Redação Eleven Host para o guia: Agendar fluxo no n8n: como usar o Schedule Trigger Arte: Eleven Host

Para agendar fluxo no n8n, use o nó Schedule Trigger: escolha o intervalo ou uma expressão cron, ajuste o fuso horário e publique o fluxo. Sem publicar, o agendamento não roda.

Este guia mostra o que o nó faz, os intervalos disponíveis, como escrever uma expressão cron, como acertar o fuso horário para o Brasil e o que muda quando você altera a agenda. No fim, exemplos de uso, os erros que confundem e os cuidados com intervalos curtos. Ele parte do n8n já funcionando, como o do guia Instalar n8n na VPS: passo a passo com Docker.

O que o nó Schedule Trigger faz

Segundo a documentação do n8n, o Schedule Trigger roda o fluxo em intervalos fixos ou em horários definidos, de um jeito parecido com o utilitário cron dos sistemas Unix. Se você já agendou tarefas na VPS, a ideia é a mesma do guia Como usar crontab: agende tarefas na VPS Linux, só que dentro do n8n.

O nome do nó aparece em inglês na documentação, e em telas em português ele pode aparecer como gatilho de agendamento. Procure por Schedule Trigger ao adicionar o primeiro nó do fluxo.

Um mesmo nó aceita várias regras (Trigger Rules), cada uma com a sua agenda. Assim, um fluxo pode rodar, por exemplo, de hora em hora em uma regra e uma vez por semana em outra.

Os intervalos disponíveis

Em cada regra, o campo Trigger Interval define a unidade de tempo. Cada opção traz os seus próprios campos:

  • Seconds: campo Seconds Between Triggers.
  • Minutes: campo Minutes Between Triggers.
  • Hours: campos Hours Between Triggers e Trigger at Minute (de 0 a 59).
  • Days: campos Days Between Triggers, Trigger at Hour e Trigger at Minute.
  • Weeks: campos Weeks Between Triggers, Trigger on Weekdays, Trigger at Hour e Trigger at Minute.
  • Months: campos Months Between Triggers, Trigger at Day of Month (de 1 a 31), Trigger at Hour e Trigger at Minute.
  • Custom (Cron): campo Expression, para escrever a agenda como expressão cron.

Um detalhe de Months: os meses que não têm o dia escolhido não disparam. Se você marcar o dia 31, por exemplo, o fluxo não roda nos meses que terminam antes dele.

Agendar com expressão cron

Quando os intervalos prontos não atendem, escolha Custom (Cron) e escreva a agenda no campo Expression. A ordem dos cinco campos é a mesma do crontab: minuto, hora, dia do mês, mês e dia da semana. Estes são os exemplos da documentação do n8n:

  • A cada 5 minutos: */5 * * * *
  • De hora em hora: 0 * * * *
  • Todo dia às 6h: 0 6 * * *
  • Toda segunda-feira ao meio-dia: 0 12 * * 1
  • No dia 1 de cada mês, à meia-noite: 0 0 1 * *
  • De segunda a sexta, às 9h: 0 9 * * 1-5
  • De hora em hora, das 9h às 17h: 0 9-17 * * *
  • A cada 10 segundos: */10 * * * * *

O último exemplo tem seis campos. Segundo a documentação, o campo extra é o dos segundos, e ele é opcional. Com cinco campos, a expressão funciona como no crontab.

Se você usar variáveis dentro da expressão, a documentação avisa que elas são lidas só na hora de publicar. Mudar o valor da variável depois não muda a agenda até você publicar o fluxo de novo.

Quer rodar os seus fluxos no n8n? Há planos a partir de R$ 19,90/mês no n8n Essencial; confira na loja o que cada plano inclui. Ver planos de n8n

Ajustar o fuso horário

Fluxo rodando na hora errada pode ser o fuso horário. Segundo a documentação, o Schedule Trigger usa o fuso horário do fluxo, se ele estiver definido. Se não estiver, usa o da instância. No n8n instalado no próprio servidor (self-hosted), o padrão da instância é America/New_York, o fuso de Nova York, se ninguém mudou.

Para o horário de Brasília, você tem dois caminhos:

  1. Por fluxo: abra o menu do fluxo, vá em Settings > Timezone, escolha o fuso e salve.
  2. Para a instância toda: defina a variável de ambiente GENERIC_TIMEZONE no n8n instalado no servidor.

No segundo caso, adicione esta linha ao arquivo de ambiente do Docker Compose, como no guia de instalação do n8n no Docker:

GENERIC_TIMEZONE=America/Sao_Paulo

Depois, recrie o contêiner para a variável valer. Dentro da pasta do Docker Compose, rode:

docker compose up -d

Depois de mudar o fuso, confira o horário do próximo disparo antes de confiar na agenda.

O agendamento só roda com o fluxo publicado. Depois de mudar o intervalo, publique uma versão nova do fluxo, porque a mudança só vale a partir daí.

Publicar o fluxo e entender as mudanças

Segundo a documentação, depois de montar o fluxo você precisa salvar e publicar (Publish). Um fluxo agendado e não publicado não dispara.

Se você mudar o intervalo de um fluxo já publicado, a mudança só vale depois de despublicar e publicar uma versão nova. A contagem do novo intervalo começa no momento da publicação. O exemplo da documentação: trocar de 1 em 1 hora para 2 em 2 horas às 11h30 faz a próxima execução ser às 13h30.

Há ainda uma mudança nas versões mais novas do n8n, a partir da 2.45.0. Os intervalos Seconds e Minutes passam a contar em intervalos iguais a partir da publicação, e não alinhados ao relógio. O Custom (Cron) continua igual.

Exemplos práticos de fluxo agendado

Estes exemplos usam nós que já aparecem nos nossos guias, sem nada além do que eles cobrem:

Nos três exemplos, o desenho é o mesmo: o Schedule Trigger vem primeiro e os outros nós seguem a partir dele.

Erros comuns

A documentação do n8n lista três situações comuns:

  • Expressão cron inválida: confira a sintaxe com os exemplos acima. A documentação sugere validar a expressão, sem a coluna de segundos, num validador de cron on-line.
  • Roda na hora errada: pode ser o fuso horário. Revise o fuso do fluxo e o da instância.
  • Não roda: o fluxo não foi publicado, ou a mudança não foi publicada.

Antes de procurar uma causa mais complicada, passe por esses três itens, nessa ordem.

Cuidados com intervalos curtos

Intervalos muito curtos, como segundos, geram muitas execuções e consomem recurso do servidor. Prefira o intervalo que o caso realmente pede. Um relatório diário não precisa de uma checagem por minuto,.

Se o servidor começar a ficar pesado depois de agendar vários fluxos, aumente o intervalo.

Checklist do agendamento

  • Adicionei o nó Schedule Trigger como primeiro nó do fluxo.
  • Escolhi o Trigger Interval, ou o Custom (Cron) com a expressão certa.
  • Conferi a ordem dos campos do cron: minuto, hora, dia do mês, mês e dia da semana.
  • Ajustei o fuso em Settings > Timezone ou com GENERIC_TIMEZONE.
  • Salvei e publiquei o fluxo (Publish).
  • Depois de mudar a agenda, publiquei uma versão nova.
  • Evitei intervalos curtos além do que o caso pede.

Prefere começar com um plano de n8n? O n8n Essencial custa a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

Qual nó uso para agendar um fluxo no n8n?

O Schedule Trigger. Ele roda o fluxo em intervalos fixos ou em horários definidos, de um jeito parecido com o cron dos sistemas Unix.

Por que o fluxo roda na hora errada?

Pode ser o fuso horário. O nó usa o fuso do fluxo, se definido, e senão o da instância, que no n8n instalado no servidor tem America/New_York como padrão, se ninguém mudou. Ajuste em Settings > Timezone ou com GENERIC_TIMEZONE.

O fluxo agendado não dispara. O que conferir?

Veja se o fluxo foi publicado. Segundo a documentação, sem publicar o agendamento não roda, e a mudança de intervalo só vale depois de publicar uma versão nova.

Posso agendar a cada poucos segundos?

Dá para usar o intervalo Seconds ou o cron com seis campos, em que o primeiro é o dos segundos. Intervalos assim geram muitas execuções e consomem recurso do servidor, então escolha o que o caso pede.

Esta resposta lhe foi útil?

Artigos Relacionados