> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwsintegration.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agendamento
> Escolha quando suas integrações executam
Você define quando uma integração executa na seção **Geral e Agendamento**, ao criar ou editar a integração. Escolha a frequência de execução e preencha os detalhes, como o horário do dia, e pronto. Não é preciso escrever nenhuma expressão especial.
Defina com que frequência a integração executa
Controle total com expressões rate e cron
## Escolhendo uma frequência
Escolha com que frequência a integração deve executar. Dependendo da sua escolha, o formulário mostra as opções correspondentes:
| Frequência | O que você escolhe |
| ----------- | --------------------------------------- |
| A cada hora | O intervalo de horas entre as execuções |
| Diária | O horário do dia |
| Semanal | O dia da semana e o horário |
| Mensal | O dia do mês e o horário |
### O campo de horário
Digite o horário apenas com números e o campo formata para você:
* Os dois-pontos são inseridos automaticamente.
* Horas com um único dígito ganham o zero à esquerda: digitar `9` vira `09:`.
* Valores colados funcionam com ou sem separador (`0930` e `09:30` são aceitos).
* Dígitos que não formam um horário válido simplesmente não são aceitos.
Se um horário ou intervalo for inválido, uma mensagem de erro aparece em vez de o valor voltar silenciosamente ao que era antes.
### Trocando de frequência
Suas escolhas são lembradas enquanto você edita. Se você escolher um horário em Diária, trocar para A cada hora para comparar e voltar para Diária, o horário continua lá. O mesmo vale para dias selecionados e intervalos.
Todos os agendamentos usam o fuso horário **UTC**. Converta seu horário local para UTC ao escolher o horário.
## Expressões avançadas
Se as opções de frequência não expressam o agendamento que você precisa, clique em **Mostrar avançado** para digitar a expressão de agendamento diretamente. Dois formatos são suportados.
Enquanto você digita, o campo valida a expressão e mostra uma mensagem de erro clara quando algo está errado. O erro mais comum é até corrigido automaticamente: `rate(1 days)` se corrige para `rate(1 day)`, e `rate(5 day)` para `rate(5 days)`. A validação existe para ajudar: ela nunca impede o salvamento.
Ao editar uma integração cujo agendamento foi escrito como expressão avançada, a seção avançada abre automaticamente para que o agendamento fique visível de imediato.
### Expressões rate
Expressões rate definem com que frequência uma integração deve ser executada usando intervalos de tempo simples, no formato `rate(value unit)`.
**Exemplos:**
* `rate(1 day)` - Executar uma vez por dia
* `rate(7 days)` - Executar uma vez por semana
### Expressões cron
Expressões cron fornecem controle preciso sobre quando as integrações são executadas, permitindo especificar horários exatos, dias da semana ou datas usando a expressão cron do AWS EventBridge. A expressão tem seis campos: minuto, hora, dia-do-mês, mês, dia-da-semana e ano.
**Formato:**
`cron(minute hour day-of-month month day-of-week year)`
**Exemplo:**
`cron(15 3 ? * * *)`: executa todos os dias às 3:15 AM.
Para um guia completo sobre a sintaxe e diferenças entre a expressão cron normal e a expressão cron do AWS EventBridge, consulte a [documentação de cron do AWS EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html).
## Executar agora
Além do agendamento, você pode disparar uma execução a qualquer momento.
### Pela página de edição
Abra a integração e clique em **Executar agora**, ao lado do botão **Salvar**. Um diálogo de confirmação sempre aparece antes de qualquer execução. Isso funciona mesmo se a integração estiver desabilitada (útil para testar sem ligar o agendamento).
* Se houver alterações não salvas, o diálogo avisa e a ação vira **Salvar e executar**: suas alterações são salvas primeiro e então a execução começa. Se o salvamento falhar, nada é executado.
* Para integrações webhook, o diálogo pede o payload JSON que o webhook receberia. Ele vem preenchido com o corpo de exemplo do preview (se você tiver informado um) ou com o último payload usado nessa integração.
* Em caso de sucesso, você verá a mensagem **Execução iniciada**; se a execução não puder ser iniciada, o motivo é mostrado dentro do diálogo.
### Pela página de status da integração
Em workspaces com a [página de status da integração](/pt-br/features/monitoring-debug/monitoring#página-de-status-da-integração), o botão **Executar agora** também está disponível lá. Como essa página é somente leitura, não há nada para salvar: após a confirmação, a execução sempre começa diretamente.