Trigger: Agendamento

Quando usar

Use o agendamento quando precisar que o workflow execute automaticamente em momentos especificos. Exemplos comuns:

• Enviar um relatorio por e-mail todos os dias as 8h da manha


• Verificar atualizacoes em um sistema externo a cada 30 minutos


• Executar uma limpeza de dados toda segunda-feira


• Disparar um lembrete unico em uma data e hora especifica

---

Como funciona

Ao adicionar este gatilho, voce escolhe quando o workflow deve executar. O Brife oferece quatro modos de agendamento, desde o mais simples (intervalo fixo) ate o mais avancado (expressao cron). O sistema cuida de disparar o fluxo automaticamente nos horarios configurados.

---

Configuracoes

Tipo de Agendamento

Define a estrategia de disparo. Selecione uma das opcoes abaixo:

| Tipo | Descricao |
|------|-----------|
| Intervalo Fixo | Executa repetidamente a cada X minutos, horas, dias ou semanas. |
| Data/Hora Especifica | Executa uma unica vez em um momento exato definido por voce. |
| Recorrente (Semanal) | Executa em dias da semana e horario especificos, toda semana. |
| Expressao Cron | Para usuarios avancados. Permite definir agendamentos complexos usando sintaxe crontab. |

---

Intervalo Fixo

Aparece quando o tipo e Intervalo Fixo.

| Campo | Descricao |
|-------|-----------|
| A cada | Numero inteiro que define o intervalo entre execucoes. Valor padrao: `15`. |
| Unidade* | Unidade de tempo do intervalo: **Minutos**, **Horas**, **Dias** ou *Semanas. |

Exemplo: configurando "A cada 30 Minutos", o workflow executara a cada meia hora, ininterruptamente.

---

Data/Hora Especifica

Aparece quando o tipo e Data/Hora Especifica.

| Campo | Descricao |
|-------|-----------|
| Data | Selecione a data no calendario. Clique no campo para abrir o seletor. |
| Hora | Defina o horario no formato HH:mm. |

O workflow executara uma unica vez no momento definido. Apos a execucao, o gatilho nao dispara novamente.

---

Recorrente (Semanal)

Aparece quando o tipo e Recorrente (Semanal).

| Campo | Descricao |
|-------|-----------|
| Dias da Semana* | Clique nos dias desejados para ativa-los. Os botoes ficam destacados quando selecionados: **Seg**, **Ter**, **Qua**, **Qui**, **Sex**, **Sab**, *Dom. |
| Horario de Execucao | Defina o horario em que o workflow deve executar nos dias selecionados, no formato HH:mm. |

Exemplo: selecionando Seg*, **Qua** e **Sex** as *09:00, o workflow executara toda segunda, quarta e sexta as 9h.

---

Expressao Cron

Aparece quando o tipo e Expressao Cron.

| Campo | Descricao |
|-------|-----------|
| Expressao Cron | Expressao no formato crontab padrao com 5 campos: `minuto hora dia-do-mes mes dia-da-semana`. |

Exemplos de expressoes cron:

| Expressao | Significado |
|-----------|-------------|
| `0 0 * ` | Todo dia a meia-noite |
| `/15 * * * ` | A cada 15 minutos |
| `0 9 1-5` | De segunda a sexta as 9h |
| `0 8,12,18 * ` | Todos os dias as 8h, 12h e 18h |

---

Dados de saida

Os nodes seguintes no fluxo podem acessar os dados gerados pelo agendamento:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `timestamp` | Data | Data e hora exatas em que o workflow foi executado |
| `executionId` | Texto | Identificador unico desta execucao |
| `scheduleId` | Texto | Identificador do agendamento configurado |
| `scheduleType` | Texto | Tipo de agendamento que disparou a execucao (`interval`, `specific`, `recurring` ou `cron`) |

---

Dicas

• Para tarefas criticas, prefira o modo Recorrente (Semanal) em vez de Intervalo Fixo. Intervalos podem acumular se o sistema ficar indisponivel e retomar depois.


• O modo Data/Hora Especifica e ideal para acoes unicas, como enviar uma notificacao sobre um evento futuro.


• Se voce nao tem familiaridade com expressoes cron, use os modos visuais (Intervalo, Semanal). Eles cobrem a maioria dos cenarios.


• Combine o agendamento com nodes de condicao (Se/Senao) para criar logica do tipo "toda segunda, mas so se houver dados novos".