v2.0
Docs › Configurações › Agendamento

Agendamento

Execute processos automaticamente em horários programados: recorrência diária, semanal, mensal, por hora ou expressão Cron customizada.

📍No Menu, na opção Meus Insights → aba Control Room → aba Agendamentos → botão + Novo Agendamento.
Nesta página

Como funciona

O Agendador (Job Scheduler) dispara execuções dos seus processos automaticamente na periodicidade configurada, sem intervenção manual. O agendamento roda no servidor da plataforma, então o disparo acontece mesmo com o seu navegador fechado, desde que o Ambiente Runtime de destino esteja online no horário.

Apenas processos próprios Somente processos dos quais você é dono podem ser agendados. Processos compartilhados com você não aparecem na lista de seleção.

Criar um agendamento

Modal Novo Agendamento
Novo Agendamento: agente, nome, runtime de execução, parâmetros de inicialização, recorrência e horário, com a prévia da recorrência por extenso e das próximas execuções.
  1. Em Meus Insights → Control Room, abra a aba Agendamentos e clique em + Novo Agendamento.
  2. Selecione o Agente. A lista traz cada agente com o processo que ele executa; um agente com vários processos aparece como um grupo, e você escolhe qual deles. Abaixo do seletor aparece quem foi escolhido (avatar, agente e processo).
  3. Informe um Nome descritivo. Ex.: Execução diária às 8h.
  4. Em Runtime de Execução, escolha em qual Ambiente este agendamento deve rodar. Deixando usar o ambiente do agente, vale o ambiente cadastrado no próprio processo.
  5. Se o processo tiver variáveis da Matrix, elas aparecem em Parâmetros de Inicialização, cada uma com o tipo ao lado do nome, para preenchimento opcional: deixe em branco para manter o valor padrão configurado no processo, ou informe um valor específico para esse agendamento.
  6. Escolha a Recorrência e o Horário (fuso de Brasília).
  7. Confira a prévia: a recorrência por extenso (ex.: De segunda a sexta às 08:00), a expressão Cron gerada (ex.: 0 8 * * 1-5) e as três próximas execuções, com a data e quanto falta. Uma expressão que o agendador não aceita aparece em vermelho, com o motivo, e não pode ser salva. Isso inclui um dia que não existe no mês escolhido, como 31 de fevereiro.
  8. Clique em Salvar. Campo obrigatório em branco é apontado embaixo do próprio campo.
Parâmetro do tipo Secreto não entra no agendamento O registro de um agendamento fica guardado, então um segredo não pode ser gravado nele: o campo do parâmetro Secreto aparece bloqueado na tela e o servidor recusa o valor. Para uma execução agendada que precisa de credencial, use o Cofre nos campos da etapa ({vault.CHAVE}), ou dispare a execução por API, onde o valor é enviado a cada chamada. Veja Dados Sensíveis.

Se você mudar um parâmetro que já tinha valor em agendamentos para o tipo Secreto, esses agendamentos continuam com o valor que tinham gravado. Abra cada um e salve de novo: o campo aparece bloqueado e o valor antigo é apagado do registro.
Mesmo fluxo da execução manual A execução agendada passa pelo mesmo caminho de uma execução disparada manualmente (Router → fila → Matrix). Os parâmetros informados no agendamento substituem os valores padrão do processo só naquele disparo, sem alterar o cadastro do processo.
Escolher o runtime é exclusivo do agendamento A escolha de ambiente vale só para aquele agendamento e não altera o cadastro do processo: a execução manual, o modo de teste do editor e o webhook continuam sempre usando o ambiente cadastrado no agente. Isso deixa você rodar o mesmo processo em máquinas diferentes por horário. Por exemplo, o lote da madrugada num servidor dedicado e o disparo do meio-dia na máquina do time.

A lista mostra os seus ambientes e os que a sua empresa compartilhou, com a marcação LIVE ou OFFLINE no momento da escolha. Um ambiente offline continua selecionável, porque o que decide o que acontece no horário do disparo é o estado dele naquele momento, não agora.

Tipos de recorrência

RecorrênciaComportamentoExemplo de Cron
DiárioTodos os dias no horário escolhido0 8 * * * (8h da manhã)
SemanalNos dias da semana selecionados0 8 * * 1-5 (dias úteis, 8h)
MensalEm um dia fixo do mês0 8 1 * * (todo dia 1º, 8h)
Por horaA cada N horas0 */2 * * * (a cada 2 horas)
CustomExpressão Cron livre para casos avançados30 6,18 * * 1-5 (6h30 e 18h30, dias úteis)
Lendo uma expressão Cron Os cinco campos são: minuto hora dia-do-mês mês dia-da-semana. O preview no modal sempre mostra a próxima execução calculada. Confira antes de salvar.

Gerenciar agendamentos

Aba Agendamentos do Control Room
Agendamentos agrupados pelo agente que executa, cada um com a recorrência por extenso, a expressão Cron e a próxima execução. O agendamento Faturamento, de Trinity, está desligado.

A aba Agendamentos lista os agendamentos agrupados pelo agente que executa (avatar, nome do agente e processo), cada um com a recorrência por extenso, a expressão Cron, a próxima execução com a data e quanto falta, o runtime (quando o agendamento tem um escolhido) e a chave de ligar e desligar. Um agendamento desligado mostra Desligado: não dispara; um com expressão que o agendador não aceita aparece marcado como inválido, para ser editado. De lá você pode editar ou remover cada agendamento. Um agendamento novo nasce ligado; editar e salvar não liga nem desliga, ele continua como estava (ligar e desligar é só pela chave do card). Ao editar, a recorrência reabre no tipo que a descreve (Diário, Semanal com os dias marcados, Mensal, Por hora), e o que não cabe nesses tipos abre em Custom. O dono do processo recebe um e-mail quando o agendamento é ativado e quando é desativado (detalhes em Mensageria Padrão).

O agendamento também pode ser ativado, desativado e consultado programaticamente via API.

Quando o dono do processo perde o acesso

Se o dono do processo for bloqueado pelo administrador da empresa, ou ficar sem acesso ativo porque o plano não comporta mais aquela quantidade de usuários, o agendamento deixa de disparar. Ele não é desativado nem apagado: continua ligado na tela, apenas pula cada horário enquanto durar a situação, e volta a executar sozinho no momento em que o acesso for restabelecido, sem precisar desligar e religar. O mesmo vale para o plano da empresa: perdendo a funcionalidade de agendamento, os disparos param, e voltam com o upgrade.

Boas práticas