> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Criando uma agenda > Preencha o formulário Nova agenda: destino, frequência, fuso horário, visibilidade e as entradas de cada execução Antes de começar, publique o Canvas, Workflow ou Agente que você quer executar. Agendas só executam versões publicadas, como explica a [visão geral](https://docs.tela.com/pt/schedules/overview.md#o-que-executa). ## Crie **1. Abra o formulário** Vá em **Agendas** na barra lateral esquerda e clique em **Nova agenda**. Você também pode abrir o menu `…` de um Canvas, Workflow ou Agente e escolher **Agendar**, que já preenche o destino. **2. Dê um nome** Em **Nome**, diga o que executa e quando, por exemplo *Roteamento de contratos, toda segunda às 9h*. O nome é o que você lê na lista, então seja específico. **3. Escolha o que executar** Em **O que executar**, digite o nome do destino ou cole o ID dele. A lista mostra o tipo (Canvas, Workflow ou Agente) e o Projeto. Só aparecem destinos publicados aos quais você tem acesso. Se você escolher outro destino depois de preencher as entradas, as entradas são limpas. **4. Defina quando executar** Em **Quando**, escolha uma frequência, um horário e o **Fuso horário**. O formulário mostra a próxima vez que vai executar, por exemplo *Próxima: 2 de nov. de 2026, 09:00*, para você conferir antes de salvar. **5. Escolha quem pode ver** Em **Quem pode ver esta agenda**, mantenha **Todo o workspace** ou escolha um dos seus times. Veja [Quem pode ver](#quem-pode-ver). **6. Preencha as entradas** A seção **Inputs** lista as variáveis da versão publicada. Preencha as obrigatórias e clique em **Criar agenda**. ![Diálogo Nova agenda com nome, Contract routing como destino, Semanalmente na segunda-feira às 09:00, fuso horário e a seção Inputs](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/new-dialog.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=e5340ae23972175816ffa7740d4c91b2) ## Frequências | Opção | Executa | Detalhes | | - | - | - | | **Todos os dias** | Uma vez por dia no horário definido | | | **Dias úteis** | De segunda a sexta no horário definido | | | **Semanalmente** | Uma vez por semana no dia escolhido | | | **Mensalmente** | Uma vez por mês no dia escolhido | Meses que não têm esse dia são ignorados. O dia 31 não executa em abril. | | **A cada X minutos** | A cada X minutos | Use um divisor de 60 (1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30) para as execuções ficarem igualmente espaçadas. | | **A cada hora** | Uma vez por hora no minuto definido | Minuto de 0 a 59. | | **Uma vez** | Uma única vez em uma data e hora | A data precisa estar no futuro. Depois de executar, a agenda fica **Encerrada** e somente para consulta. | | **Cron personalizado** | O que a expressão disser | Cinco campos: minuto, hora, dia do mês, mês e dia da semana. | Para cron personalizado, algumas formas comuns: | Expressão | Significado | | - | - | | `0 9 * * 1` | Toda segunda às 09:00 | | `30 8 * * 1-5` | Dias úteis às 08:30 | | `*/15 * * * *` | A cada 15 minutos | | `0 7 1 * *` | Dia 1º de cada mês às 07:00 | ## Fuso horário Os horários sempre valem no fuso que você escolhe no campo **Fuso horário**. Uma agenda às 09:00 em `America/Sao_Paulo` executa às 09:00 lá, qualquer que seja o fuso de quem a criou. O horário de verão pode fazer um horário não existir ou acontecer duas vezes. O formulário recusa esses horários e pede que você escolha outro. ## Entradas Toda execução de uma agenda usa os mesmos valores de entrada que você salvou. As entradas se comportam como as da experiência Criar: * Variáveis de texto recebem o texto que você digitar e, em Canvas e Workflow, também podem receber arquivos. * Variáveis de arquivo recebem os arquivos que você soltar no campo. Agentes recebem um arquivo por variável. * Uma entrada obrigatória precisa estar preenchida para **Criar agenda** ficar habilitado. > [!NOTE] > > Os valores são conferidos com a versão publicada quando você salva e de novo quando cada execução começa. Se você publicar uma versão que renomeia ou remove uma variável, a próxima execução pode falhar ao iniciar. Veja [o que fazer quando uma execução falha](https://docs.tela.com/pt/schedules/managing-schedules.md#quando-uma-execucao-falha). ## Quem pode ver * **Todo o workspace**: todas as pessoas do Workspace veem a agenda. * **Um time**: só os membros desse time veem. Quando o Projeto do destino é restrito a um time, a agenda mantém essa restrição e você não consegue ampliá-la. Se você faz parte de mais de um time que acessa o Projeto, o formulário pede que você escolha o time responsável. ## API A referência pública da API ainda não cobre agendas, então crie e gerencie pela página Agendas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.