Schedule

O trigger Schedule executa um workflow em um temporizador, por conta própria e sem nenhuma entrada — em um intervalo simples ou por uma expressão cron.

Agendamento

Escolha a frequência de execução:

  • Every X minutes — um intervalo em minutos (1–1440)
  • Hourly — um minuto fixo de cada hora
  • Daily — um horário fixo de cada dia
  • Weekly — um dia e horário fixos de cada semana
  • Monthly — um dia e horário fixos de cada mês

Para um controle mais fino, use uma expressão cron:

  • 0 9 * * 1-5 — dias de semana às 9h
  • */15 * * * * — a cada 15 minutos
  • 0 0 1 * * — no primeiro dia de cada mês

Expressões cron e intervalos são avaliados no fuso horário configurado, que por padrão é UTC.

Ativação

Um agendamento está vinculado ao deployment:

  • Deploy — o agendamento fica ativo e começa a executar
  • Undeploy — o agendamento é removido
  • Redeploy — o agendamento é recriado a partir da configuração atual

Um agendamento só executa depois que o workflow recebe deploy. Configure o trigger e então faça o deploy pela barra de ferramentas.

Desativação automática

Um agendamento se desativa depois de 100 falhas consecutivas, para conter erros em cascata. Um selo de aviso aparece no block e ele para de executar; clique no selo para reativá-lo. O contador volta a zero em qualquer execução bem-sucedida.

Um trigger Schedule é apenas um ponto de entrada — ele não pode receber conexões de entrada.

Common Questions

Sim. Agendamentos são criados somente quando você faz o deploy do workflow. Remover o deploy apaga o agendamento, e um novo deploy o recria a partir da configuração atual.
O agendamento é desativado automaticamente para evitar erros em cascata, e um selo de aviso aparece no block dentro do editor. Clique no selo para reativá-lo. O contador de falhas volta a zero em qualquer execução bem-sucedida.
Sim. A configuração inclui um fuso horário, e tanto as expressões cron quanto os intervalos simples são avaliados em relação a ele. O padrão é UTC.
Se uma execução atingir um limite de taxa (HTTP 429), o agendamento tenta de novo depois de 5 minutos, em vez de contar isso como falha.
Sim. O deployment cria um registro de agendamento separado para cada block de schedule, e cada um executa de forma independente, com sua própria expressão e seu próprio contador de falhas.
O workflow em andamento termina, mas nenhuma nova execução é disparada. Antes de cada disparo, o agendamento verifica se o workflow ainda está com deploy ativo e se o registro do agendamento ainda existe.