Agendamento

Use um agendamento quando o bot precisa rodar sozinho em horários recorrentes, por exemplo todo dia útil às 9h (0 9 * * 1-5). O agendamento define quando (expressão Cron), qual bot e versão, e onde (agentes) ele será executado, sem intervenção manual. É ideal para rotinas de monitoramento, extração de dados ou automações periódicas.

Tabela de Dados

Filtros

Novo Agendamento

Segue abaixo a descrição dos campos necessários para configurar um agendamento.

Expressão Cron

• Descrição: Define a frequência e o horário de execução do bot. A expressão segue o formato padrão Cron, permitindo agendamentos flexíveis.
• Exemplo: * * * * * (Executa a cada minuto)
• Dica: Utilize o gerador visual de expressões Cron disponível na plataforma para facilitar a criação da expressão desejada.

Limites de Execução e Erros

Recursos opcionais para controlar o volume de execuções em fila e o comportamento do agendamento em caso de falhas. Todos vêm desabilitados por padrão e são ativados individualmente através de uma opção Habilitado/Desabilitado; ao habilitar, é solicitada a quantidade correspondente.

Limitar Execuções em Fila

• Valor padrão: Desabilitado
• Descrição: Restringe o número máximo de execuções que o agendamento pode manter na fila ao mesmo tempo. Enquanto o limite estiver atingido, novas execuções não são criadas até que uma delas seja concluída.
• Opções disponíveis: Habilitado, Desabilitado.
• Importante: Ao habilitar, é necessário informar o número máximo de execuções em fila.

Reexecutar Automaticamente em Caso de Erro

• Valor padrão: Desabilitado
• Descrição: Faz o agendamento tentar executar o bot novamente de forma automática sempre que uma execução terminar com erro.
• Opções disponíveis: Habilitado, Desabilitado.
• Importante: Ao habilitar, é necessário informar a quantidade de reexecuções automáticas permitidas.

Desabilitar Agendamento por Quantidade de Erros

• Valor padrão: Desabilitado
• Descrição: Desativa automaticamente o agendamento (Status muda para OFF) após ele atingir a quantidade de erros configurada.
• Opções disponíveis: Habilitado, Desabilitado.
• Importante: Ao habilitar, é necessário informar a quantidade de erros tolerada antes da desativação automática.

Gerador Cron

A plataforma oferece um gerador visual para facilitar a criação de expressões Cron. Abaixo estão as abas disponíveis para configuração: Permite definir a frequência de execução com base nos minutos.

Configurações Disponíveis

Minutos

• Descrição: Define os minutos em que o bot será executado.
• Opções disponíveis: A cada X minuto(s), Minuto específico, Intervalo de minutos.

Horas

• Descrição: Define as horas em que o bot será executado.
• Opções disponíveis: A cada X hora(s), Hora específica, Intervalo de horas

Dia

• Descrição: Define os dias do mês em que o bot será executado.
• Opções disponíveis: A cada X dia(s) iniciando no domingo, A cada x dias(s) iniciando no primeiro dia do mês, Dia do mês especifíco, Intervalo de dias

Mês

• Descrição: Define os meses em que o bot será executado.
• Opções disponíveis: A cada X mês(es), Mês específico, Intervalo de meses

Exemplo de Expressão Cron

• 0 9 * * 1-5: Executa o bot às 9h de segunda a sexta-feira.
• 30 14 * * 6,0: Executa o bot às 14h30 aos sábados e domingos.
• 0 */2 * * *: Executa o bot a cada 2 horas.
• 0 0 1 * *: Executa o bot à meia-noite do primeiro dia de cada mês.

Editar Agendamento

Para editar um agendamento existente, clique no ícone na coluna Editar.

Remover Agendamento

Para remover um agendamento, clique no ícone de lixeira na coluna Ações.

Desabilitar Agendamento

Para desativar ou ativar um agendamento, clique no toggle na coluna Status.