> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/setorizacao/agendamentos.md). # Agendamentos ## Agendamentos ### Visão Geral O módulo **Agendamentos** permite programar execuções automáticas de robôs em datas, horários e frequências específicas (uma vez, diariamente, semanalmente, quinzenalmente, etc.). Cada agendamento pode ser restrito a usuários/setores específicos ou tornado público para toda a empresa.

Tela de listagem de Agendamentos

*** ### Pré-requisitos * Robô publicado e disponível para execução * (Opcional) Runtime disponível para execução dedicada * (Opcional) Usuários cadastrados na empresa para configurar acesso *** ### Como usar #### Passo 1 — Acessar a tela de Agendamentos No menu principal do Orquestrador, acesse **Agendamentos**. A listagem de agendamentos existentes será exibida.

Listagem de agendamentos com os filtros Tipo de agendamento, Status da execução e Status do agendamento

#### Passo 2 — Criar um novo agendamento Clique no botão **ADICIONAR** no canto superior esquerdo da listagem. A tela **Adicionar Agendamentos** será aberta.

Tela Adicionar Agendamentos

#### Passo 3 — Configurar o agendamento Preencha os campos obrigatórios: * **Tipo de agendamento** — frequência de execução (ver lista abaixo) * **Inicia em** — data e hora da primeira execução * **Robô** — selecione o robô que será executado * **Selecionar a prioridade da execução** — prioridade na fila (padrão: `Média`) * **Runtime** — runtime específico (opcional) * **Ignorar agendamento caso o mesmo robô esteja em execução?** — marque para evitar execuções sobrepostas #### Passo 4 — Configurar acesso Na seção **Configurar acesso**, defina quem pode visualizar e gerenciar o agendamento: * **E-mail do Usuário** — adicione usuários individuais clicando no botão **+** * **Setor** — vincule o agendamento a um setor * **Público** — marcado por padrão; ao desmarcar, o agendamento ficará restrito aos usuários/setores vinculados #### Passo 5 — Salvar Clique em **SALVAR** para criar o agendamento. Ele passará a aparecer na listagem com status **Ativado** e **Pendente** (aguardando a primeira execução). *** ### Tipos de agendamento

Dropdown Tipo de agendamento com todas as opções

| Tipo | Quando executa | | ----------------------------- | ----------------------------------------------------------- | | Executar apenas uma vez | Uma única execução na data/hora configurada | | Repetir todo mês | Uma vez por mês, na data definida | | Quinzenal | A cada 15 dias | | Repetir toda semana | Uma vez por semana, no dia da semana definido | | Repetir de segunda a sexta | Em todos os dias úteis | | Repetir todo dia | Diariamente no horário configurado | | Repetir toda hora | A cada hora cheia | | Repetir a cada 30 minutos | A cada 30 minutos | | Repetir a cada 10 minutos | A cada 10 minutos | | Customizar minutos | Intervalo personalizado em minutos | | Todo primeiro dia útil do mês | Primeiro dia útil de cada mês | | Todo último dia útil do mês | Último dia útil de cada mês | | Toda segunda-feira | Toda segunda-feira (equivalente para demais dias da semana) | *** ### Campos e opções #### Formulário Adicionar Agendamentos | Campo | Descrição | Valores aceitos | | --------------------------------------------------------- | ------------------------------------------------------- | ---------------------------- | | Tipo de agendamento | Frequência de execução | Ver tabela de tipos acima | | Inicia em | Data e hora da primeira execução | Data/hora | | Robô | Robô que será executado | Robô publicado na empresa | | Selecionar a prioridade da execução | Prioridade na fila de execução | Urgente, Alta, Média, Baixa | | Runtime | Runtime específico onde o robô deve rodar | Runtime cadastrado | | Ignorar agendamento caso o mesmo robô esteja em execução? | Evita execuções sobrepostas do mesmo robô | Marcado / Desmarcado | | E-mail do Usuário | Adiciona um usuário específico ao acesso do agendamento | E-mail cadastrado na empresa | | Setor | Vincula o agendamento a um setor | Setor cadastrado | | Público | Define o agendamento como público para toda a empresa | Marcado / Desmarcado | > 💡 **Sobre o campo Runtime:** Se nenhum runtime for escolhido, a execução usará o primeiro disponível. Se runtimes forem escolhidos, a execução usará apenas os disponíveis entre eles. #### Colunas da listagem de Agendamentos | Coluna | Descrição | | --------------------- | ---------------------------------------------------------- | | Status do agendamento | Indica se o agendamento está **Ativado** ou **Desativado** | | Tipo | Frequência configurada | | Janela de Execução | Faixa de horário permitido para execução (se configurada) | | Nome do Robô | Robô vinculado ao agendamento | | Status da execução | Estado da última execução | | Runtime | Runtime vinculado | | Próxima execução | Data/hora da próxima execução programada | #### Filtros disponíveis na listagem | Filtro | Opções | | --------------------- | ------------------------------------- | | Tipo de agendamento | Todas as frequências listadas acima | | Status da execução | Pendente, Executado, Erro, Finalizado | | Status do agendamento | Ativado, Desativado |

Caixa de seleção Status da execução

Dropdown Status do agendamento

*** ### Configurar acesso A seção **Configurar acesso** define quem pode visualizar e gerenciar o agendamento.

Seção Configurar acesso com os campos de Usuários, Setor e Público (print pendente)

#### Regras de acesso * **Usuários** só serão salvos se forem válidos (ou seja, se estiverem cadastrados na empresa). * Ao **desmarcar a opção "Público"**, o usuário que está configurando as permissões sempre manterá a visualização do agendamento. * É possível **salvar sem adicionar nenhum usuário ou setor** — nesse caso a permissão ficará **privada para o usuário que criou o agendamento**. *** ### Observações e dicas * 💡 Marque **Ignorar agendamento caso o mesmo robô esteja em execução?** em robôs longos que podem ter execuções sobrepostas — isso evita conflitos e duplicação de trabalho. * 💡 Use a opção **Customizar minutos** quando nenhum dos intervalos pré-definidos atender à sua necessidade. * 💡 Para agendamentos que só devem rodar em um runtime específico (ex: um servidor dedicado), selecione-o no campo **Runtime**. Caso contrário, deixe em branco para usar o primeiro disponível. * ⚠️ Só é possível adicionar **usuários já cadastrados na empresa** — e-mails externos serão rejeitados no momento do salvamento. * ⚠️ Desmarcar **Público** sem adicionar nenhum usuário ou setor deixa o agendamento acessível **somente para quem o criou**.