Reference

Schedule

O trigger Schedule executa um workflow em um timer, sozinho e sem entrada — em um intervalo simples ou em uma expressão cron.

Schedule

Escolha com que frequência ele roda:

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

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

  • 0 9 * * 1-5 — dias úteis às 9h
  • */15 * * * * — a cada 15 minutos
  • 0 0 1 * * — o dia 1 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 schedule está ligado ao deployment:

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

Um schedule só roda depois que o workflow está publicado. Configure o trigger e depois publique pela barra de ferramentas.

Desativação automática

Um schedule se desativa após 100 falhas consecutivas, para interromper erros em cascata. Um badge de aviso aparece no bloco e ele para de rodar; clique no badge para reativá-lo. O contador zera em qualquer execução bem-sucedida.

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

Common Questions

Sim. Schedules só são criados quando você publica o workflow. Undeploy remove o schedule, e redeploy o recria a partir da configuração atual.
O schedule é desativado automaticamente para evitar erros em cascata, e um badge de aviso aparece no bloco no editor. Clique no badge para reativá-lo. O contador de falhas zera em qualquer execução bem-sucedida.
Sim. A configuração inclui um fuso horário, e tanto expressões cron quanto intervalos simples são avaliados em relação a ele. O padrão é UTC.
Se uma execução bater em um rate limit (HTTP 429), o schedule tenta de novo após um atraso de 5 minutos em vez de contar como falha.
Sim. O deployment cria um registro de schedule separado para cada bloco de schedule, e cada um roda de forma independente com sua própria expressão e contador de falhas.
O workflow em execução conclui, mas nenhuma execução nova é disparada. Antes de cada disparo, o schedule verifica se o workflow ainda está publicado e se o registro do schedule ainda existe.

On this page