> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Agendamentos do contexto

> Automatize a reconciliação definindo quando o motor do Matcher deve executar o matching de um contexto sem intervenção manual.

Use a seção **Agendamentos** na página de detalhes do contexto para automatizar a execução da reconciliação. Cada agendamento define quando o motor do Matcher deve executar automaticamente o matching para o contexto selecionado.

## Acessando os agendamentos

***

Os agendamentos são gerenciados a partir da página de detalhes do contexto:

1. Navegue até **Reconciliação > Contextos** na barra lateral esquerda.
2. Clique em um contexto para abrir sua página de detalhes.
3. Role até a seção **Agendamentos**.

<Note>
  A seção de Agendamentos só está disponível após o contexto ter sido salvo. Para novos contextos, salve o contexto primeiro para habilitar a configuração de agendamentos.
</Note>

## Lista de agendamentos

***

A tabela exibe todos os agendamentos configurados para o contexto:

| Coluna               | Descrição                                                |
| -------------------- | -------------------------------------------------------- |
| **Expressão Cron**   | A expressão cron que define a frequência de execução     |
| **Status**           | Se o agendamento está **Habilitado** ou **Desabilitado** |
| **Última execução**  | Data e hora da última execução automática                |
| **Próxima execução** | Data e hora da próxima execução agendada                 |
| **Ações**            | Editar ou excluir o agendamento                          |

## Criando um agendamento

***

Clique no botão **Novo agendamento** no cabeçalho da seção de Agendamentos. Um painel lateral será aberto com o formulário de agendamento.

### Predefinições de frequência

Selecione uma frequência para configurar o agendamento usando um formulário guiado:

| Frequência               | Configuração                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------ |
| **A cada hora**          | Selecione o minuto da hora (0–59)                                                    |
| **Diário**               | Selecione hora e minuto                                                              |
| **Semanal**              | Selecione hora, minuto e um ou mais dias da semana                                   |
| **Mensal**               | Selecione hora, minuto e dia do mês (1–31)                                           |
| **Personalizado (cron)** | Insira uma expressão cron diretamente no formato `minuto hora dia mês dia_da_semana` |

<Accordion title="Como escrever uma expressão cron">
  Uma **expressão cron** usa cinco campos separados por espaços: `minuto hora dia_do_mês mês dia_da_semana`.

  | Campo         | Intervalo           |
  | ------------- | ------------------- |
  | Minuto        | `0–59`              |
  | Hora          | `0–23`              |
  | Dia do mês    | `1–31`              |
  | Mês           | `1–12`              |
  | Dia da semana | `0–6` (0 = domingo) |

  Caracteres especiais mais usados:

  * `*` — qualquer valor
  * `,` — lista de valores (ex.: `1,15,30`)
  * `-` — intervalo (ex.: `9-17`)
  * `/` — passo (ex.: `*/15` para cada 15 unidades)

  Exemplos:

  * `0 6 * * *` — todo dia às 06:00
  * `*/15 * * * *` — a cada 15 minutos
  * `0 9 * * 1-5` — às 09:00 em dias úteis

  Precisa validar uma expressão? Use o [crontab.guru](https://crontab.guru) para visualizar quando ela será executada.
</Accordion>

### Toggle de habilitação

Use o toggle **Habilitado** para ativar ou desativar o agendamento. Agendamentos desabilitados permanecem configurados, mas não disparam execuções automáticas.

### Pré-visualização da expressão

Abaixo dos campos do formulário, uma caixa de pré-visualização exibe:

* Uma descrição legível do agendamento (ex: "Todos os dias às 06:00")
* A expressão cron gerada

### Substituição avançada

Para frequências predefinidas (Por hora, Diário, Semanal, Mensal), uma seção expansível **Avançado** permite substituir a expressão cron gerada por um valor personalizado.

## Editando um agendamento

***

Clique no menu **Ações** (⋮) na linha do agendamento e selecione **Editar**. O painel lateral será aberto com os valores atuais do agendamento preenchidos.

Ao editar, o painel também exibe os timestamps de **Última execução** e **Próxima execução** se disponíveis.

## Excluindo um agendamento

***

Clique no menu **Ações** (⋮) na linha do agendamento e selecione **Excluir**. Um diálogo de confirmação aparece antes do agendamento ser permanentemente removido.

<Warning>
  Excluir um agendamento é irreversível. O agendamento parará de executar imediatamente.
</Warning>