NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Automatizar

Gatilho agendado

Execute um workflow automaticamente a cada tantos minutos, horas, dias, semanas ou meses, ou por expressão cron, no seu fuso horário. Ative com uma chave.

O nó Gatilho agendado executa um workflow automaticamente conforme um agendamento, como a cada 20 minutos, todo dia às 9h00 ou em dias úteis às 18h30. Um agendamento é uma lista de regras lidas no fuso horário que você escolhe, e o workflow é executado sempre que qualquer regra coincide. O gatilho é gratuito e só é executado enquanto a chave dele está ativada.

Quando usar

  • Publicar conteúdo gerado todo dia, como uma imagem diária, um resumo de notícias ou um vídeo com uma citação.
  • Verificar uma fonte em intervalos programados, com o Extrair da web ou o Feed de canal do Telegram.
  • Preparar um relatório semanal ou mensal sem abrir o editor.
  • Executar o mesmo workflow com agendamento e sob demanda, junto com um Gatilho de webhook.

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Automatizar › Gatilhos › Gatilho agendado. Um Gatilho agendado novo é executado todo dia às 9h00 UTC e começa pausado.

Definir o agendamento

Abra o painel de configurações. Clique em uma predefinição, como Dias úteis às 9h, ou edite a regra em Regras de disparo. Escolha o seu Fuso horário. Quando é executado mostra as próximas execuções antes de você salvar.

Decidir o que ele executa

Para executar só uma parte do workflow, conecte o gatilho ao primeiro nó dessa parte. Um gatilho que não está conectado a nada executa o workflow inteiro.

Ativar o agendamento

Ative a chave no topo do painel de configurações ou clique no botão de agendamento na barra superior do editor. O nó mostra Ativo, e o agendamento é executado a partir do próximo minuto que coincidir.

promptGatilho agendadoDias úteis às 9hExtrair da webGoogle SearchGerar texto - qualquer LLMEscreve um post curtoPublicar nas redes
O Gatilho agendado não está conectado a nada, então cada execução às 9h00 nos dias úteis abrange o workflow inteiro: pesquisar, escrever, publicar.
O painel de configurações do Gatilho agendado com o agendamento pausado, as predefinições, a barra de 24 horas das execuções do dia, o botão Adicionar regra de disparo e o fuso horário.O painel de configurações do Gatilho agendado com o agendamento pausado, as predefinições, a barra de 24 horas das execuções do dia, o botão Adicionar regra de disparo e o fuso horário.

Ativar o agendamento

Um agendamento só é executado enquanto a chave dele está ativada. Colocar o nó e salvar o workflow registra o agendamento, mas não o inicia. Até você ativá-lo, o nó mostra Pausado.

  • No painel de configurações, use a chave no topo. Ela mostra Agendamento ativado ou Agendamento pausado.
  • Na barra superior do editor, o botão de agendamento aparece quando o workflow tem um Gatilho agendado. Ele mostra Agendamento ativado, Agendamento desativado ou, por exemplo, 1/2 agendamentos ativados. Um clique ativa todos os agendamentos do workflow, ou os desativa quando todos já estão ativados, e salva o workflow.

Desativar a chave pausa o agendamento da mesma forma. Um workflow importado ou um template sempre começa com os agendamentos pausados. Um agendamento gravado pela API, pelo SDK ou pelo MCP só fica ativado quando o campo active do nó é true.

Para testar o ramo agora sem ativar o agendamento, clique em Executar a partir daqui, na parte de baixo do painel de configurações. Um gatilho que não está conectado a nada não tem um ramo a partir do qual executar, então execute o workflow inteiro.

Configurações

ConfiguraçãoO que faz
PredefiniçõesA cada 5 min, De hora em hora, Todo dia às 9h e Dias úteis às 9h. Um clique grava a regra correspondente. Uma predefinição fica destacada quando o agendamento é exatamente aquela regra.
Regras de disparoUma ou mais regras. O workflow é executado sempre que qualquer regra coincide. Adicionar regra de disparo adiciona uma, e Remover regra remove uma. A última regra não pode ser removida.
Fuso horárioO relógio em que as regras são lidas. Pesquise na lista de todos os fusos horários, com o seu aparecendo primeiro. Quando ele não está definido, as regras usam UTC.
Máximo de execuçõesInterrompe o agendamento depois desse número de execuções. Deixe vazio para execuções ilimitadas.
Repetir em caso de falhaExecuta de novo, mais tarde, uma execução agendada que falhou. Desativado por padrão. Veja Repetir em caso de falha.

Regras

Cada regra tem um Intervalo de disparo e os campos que o acompanham.

Intervalo de disparoCamposExecuta
MinutosA cada 1 a 59 minutosNo minuto 0, N, 2N e assim por diante de cada hora
HorasA cada 1 a 23 horas, Minuto do disparoNa hora 0, N, 2N e assim por diante de cada dia, nesse minuto
DiasA cada 1 a 31 dias, Hora do disparo, Minuto do disparoA cada N dias corridos, nesse horário
SemanasA cada 1 a 52 semanas, Dias da semana, hora e minutoNesses dias da semana, a cada N semanas. As semanas começam na segunda-feira.
MesesA cada 1 a 12 meses, Dia do mês de 1 a 31, hora e minutoNesse dia, a cada N meses, ou no último dia de um mês mais curto
Personalizado (cron)Uma Expressão cron de 5 camposSempre que a expressão coincidir
  • Fase fixa. “A cada N dias, semanas ou meses” conta a partir de um ponto fixo do calendário. Salvar o workflow de novo nunca desloca os dias em que ele é executado.
  • Formato cron. Os campos são minuto, hora, dia do mês, mês e dia da semana. Todos os campos precisam coincidir, inclusive o dia do mês e o dia da semana juntos, enquanto algumas ferramentas de cron aceitam que só um dos dois coincida. Tanto 0 quanto 7 significam domingo.

Quando é executado

Antes de você salvar, Quando é executado, no painel de configurações, mostra o que as regras significam:

  • O agendamento por extenso e o número de execuções por dia.
  • As execuções de hoje em uma barra de 24 horas.
  • As próximas três execuções, com quanto tempo falta para cada uma.

O nó mostra o mesmo resumo, a próxima execução e se o agendamento está Ativo ou Pausado. A prévia usa o mesmo cálculo que o servidor, então mostra o que vai acontecer.

Como funciona uma execução agendada

  • Uma vez por minuto. O Nodaro confere os agendamentos a cada minuto e inicia uma execução quando uma regra coincide com aquele minuto. O mesmo minuto nunca é executado duas vezes, nem depois de uma reinicialização nem quando os relógios são atrasados. Um minuto que os relógios pulam ao serem adiantados é pulado naquele dia.
  • Uma execução por vez. Se a execução anterior do workflow ainda estiver em andamento, aquele minuto é pulado.
  • Uma execução que nunca começou. Uma execução pode ser criada e nunca começar, por exemplo quando o servidor reinicia naquele momento ou quando a execução não pode entrar na fila. Essa execução não trava o agendamento. Uma execução que a fila recusou é marcada como falha na hora. Uma execução que nunca chegou à fila é marcada como falha quando completa 4 horas. O tempo de espera por uma vaga de execução livre não conta nessas 4 horas, e uma execução que ainda espera a vez dela na fila continua esperando para começar. Quando duas instalações compartilham um banco de dados, uma execução que outra instalação criou e que nunca começou também é marcada como falha quando completa 8 horas, pela instalação cujo RUNTIME_ENV é production. Assim, uma instalação que parou também não trava o agendamento. Nos dois casos, o agendamento é executado de novo no próximo horário que coincidir. Com Repetir em caso de falha ativado, a execução que falhou é repetida como qualquer outra, a menos que tenha sido criada mais de dois dias antes.
  • Em um servidor auto-hospedado, uma execução que travou assim antes da atualização do servidor pode continuar pendente. Cancele-a pelo histórico de execuções do workflow, ou com POST /v1/workflow-executions/:id/cancel, e o agendamento é executado de novo no próximo horário que coincidir.
  • Máximo de execuções. Depois desse número de execuções, o agendamento para. Ele continua registrado, então aumente ou limpe o limite para continuar.
  • Repetições. Com Repetir em caso de falha ativado, a mesma verificação a cada minuto também inicia uma repetição cuja espera já passou. Uma execução que falhou nunca é repetida duas vezes para a mesma tentativa, mesmo com dois servidores.
  • Saída. A saída, Payload, leva o horário da execução.

Repetir em caso de falha

Ninguém acompanha uma execução agendada. Uma falha que passaria sozinha, como um serviço de modelo fora do ar por algum tempo, faria você perder essa execução até o próximo horário agendado. Com Repetir em caso de falha ativado, uma execução agendada que falha é executada de novo mais tarde. Uma execução que o servidor interrompeu porque demorou demais conta como falha. Uma execução que você cancelou nunca é repetida.

ConfiguraçãoO que faz
Repetir após (minutos)Quanto tempo depois da falha a repetição pode começar, de 5 a 1.440 minutos. O padrão é 30.
Tentativas (no máximo)Quantas repetições uma execução que falhou pode ter, de 1 a 5. O padrão é 3. A execução original não conta como tentativa.
Somente rotas econômicasAtivado por padrão. Uma chamada de modelo na execução agendada não passa para o serviço direto do fabricante do modelo quando a primeira rota dela falha. A chamada falha, e a repetição a executa de novo mais tarde.
  • A mesma execução de novo. Uma repetição executa o mesmo ramo do agendamento, com o mesmo horário da execução anterior, então {{trigger.last_triggered_at}} lê o mesmo valor que a execução que falhou leu. O histórico de execuções a mostra com um selo Repetição 1 de 3 ao lado do selo Agendamento.
  • Até dar certo. Uma repetição que falha é repetida de novo, até o limite de Tentativas (no máximo). Uma repetição bem-sucedida encerra a sequência.
  • Só a execução mais recente. Depois que o agendamento é executado de novo, uma falha mais antiga não é repetida. Uma falha com mais de dois dias também não é repetida.
  • Uma execução por vez. Uma repetição espera enquanto outra execução sua do mesmo workflow ainda está em andamento.
  • Máximo de execuções. As repetições não contam para o Máximo de execuções.
  • Desative quando quiser. As configurações de repetição são lidas do nó como ele está agora. Desative Repetir em caso de falha e salve para interromper uma sequência na hora.
  • Cada repetição é cobrada. Os créditos da execução que falhou foram reembolsados quando ela falhou. Cada repetição reserva e cobra o ramo de novo, como qualquer execução. Uma execução que falha três vezes e depois dá certo paga pelos nós concluídos em cada tentativa, mais a execução bem-sucedida.

Somente rotas econômicas se aplica às chamadas de modelo de Gerar texto - qualquer LLM, Descrever imagem, Gerar roteiro e Gráficos animados com o mecanismo Lottie. Não muda o que você paga. Uma chamada que precisa ser executada diretamente no fabricante do modelo por causa das próprias configurações, como o Modo avançado ou um modelo Claude com um esforço de raciocínio, continua sendo executada assim. As chamadas de modelo de outros tipos de nó mantêm o fallback de sempre.

O que uma execução agendada executa

Um gatilho conectado a nós executa só o próprio ramo: os nós depois do gatilho e todos os nós de que eles precisam como entrada. Os nós fora do ramo ficam como estão. Um gatilho que não está conectado a nada executa o workflow inteiro. Assim, um workflow pode ter vários gatilhos, cada um iniciando o próprio ramo.

Um nó conta como conectado por uma conexão desenhada, por estar dentro de um Grupo que o gatilho alimenta ou por um mapeamento de campo. O painel de configurações diz qual é o caso: “Conectado — uma execução abrange apenas o ramo depois deste gatilho” ou “Não conectado a nada — uma execução abrange o workflow inteiro”. Os gatilhos só limitam as execuções que eles iniciam. Uma execução manual no editor, uma execução pela API e uma execução de um app publicado nunca ficam limitadas ao ramo de um gatilho.

Solução de problemas

  • O nó mostra Pausado. A chave está desativada. Ative-a no painel de configurações ou com o botão de agendamento na barra superior.
  • O nó mostra Não será executado. Uma regra não pode ser executada, como uma regra cron sem expressão ou uma regra semanal sem dia da semana. Ou o fuso horário não é um que o servidor conheça. Corrija e salve de novo.
  • As execuções acontecem no horário errado. Confira o Fuso horário. Quando ele está vazio, as regras usam UTC.
  • Uma execução foi pulada. A execução anterior do workflow ainda estava em andamento naquele minuto.
  • Um agendamento mais antigo parou de ser executado. Um agendamento salvo antes de as regras existirem abre com o agendamento reescrito como regras e começa pausado. Ative-o. Agora as execuções dele seguem o relógio, então “a cada 5 minutos” significa :00, :05, :10 e assim por diante.

Pela API

GET /v1/workflows/<id>/triggers lista os gatilhos de um workflow. A configuração de um agendamento usa as mesmas regras do nó, com kind, every, hour, minute, weekdays (0 é domingo, 6 é sábado), dayOfMonth e cron. Ela também aceita os campos opcionais timezone, maxExecutions e a política retry: { afterMinutes, maxAttempts, cheapLanesOnly }, cada um opcional, com os padrões acima. Em um PATCH, "retry": null desativa as repetições. GET /v1/workflows/<id>/executions lista uma repetição com retry: { attempt, maxAttempts, retryOf }. Use a chave do nó para pausar um agendamento: uma pausa enviada com PATCH /v1/workflow-triggers/<id> só dura até o próximo salvamento do workflow. Um agendamento criado diretamente pela API não pertence a nenhum nó e, quando um workflow tem dois Gatilhos agendados, esse agendamento executa o workflow inteiro. Veja Webhooks.

Perguntas frequentes

Como executo um workflow do Nodaro todo dia?

Adicione um “Gatilho agendado”, clique na predefinição “Todo dia às 9h” ou defina a sua própria regra, escolha o seu fuso horário e ative o agendamento com a chave no topo do painel de configurações. O workflow passa a ser executado todo dia nesse horário.

Por que o meu agendamento não é executado?

Um agendamento só é executado enquanto a chave dele está ativada. Um “Gatilho agendado” novo ou importado começa pausado, e o nó mostra “Pausado”. Ative-o no painel de configurações ou com o botão de agendamento na barra superior do editor. Um nó que mostra “Não será executado” tem uma regra ou um fuso horário para corrigir.

Qual fuso horário o “Gatilho agendado” usa?

O fuso horário que você escolhe no painel de configurações, onde o seu próprio fuso aparece primeiro. Quando nenhum fuso horário está definido, as regras são lidas em UTC.

O “Gatilho agendado” custa créditos?

Não. O gatilho em si é gratuito. Cada execução paga pelos nós que executa, então confira o custo de uma execução antes de escolher um intervalo curto.

Posso testar um agendamento sem esperar por ele?

Sim. Clique em “Executar a partir daqui”, na parte de baixo do painel de configurações, para executar agora o ramo depois do gatilho. Se o gatilho não estiver conectado a nada, execute o workflow inteiro.

Um workflow pode ter vários agendamentos?

Sim. Um “Gatilho agendado” pode ter várias regras, e o workflow é executado sempre que qualquer regra coincide. Um workflow também pode ter vários gatilhos, cada um conectado ao próprio ramo.

Última atualização

Nesta página