> ## 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.

# Gerenciando agendas e histórico

> Encontre uma agenda, pause, edite ou exclua, leia o histórico e resolva execuções que falharam

## A lista

A página **Agendas** lista as agendas agrupadas por destino, com as colunas **Destino**, **Agenda**, **Status**, **Resultado**, **Projeto**, **Frequência**, **Autor**, a última execução e a próxima execução.

![Lista de Agendas expandida para Contract routing, com uma agenda Encerrada com resultado Concluída e uma agenda semanal Ativa](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/list.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=8e93e2996b10ceaf5f6baaad786ebe4c)

Use a busca para encontrar um destino pelo nome, os filtros **Status**, **Projeto** e **Criação**, e as ordenações **Mais recentes**, **Nome** e **Próxima execução**. O contador **Precisam de atenção** mostra as agendas cuja última execução falhou ou não pôde ser iniciada.

## Status

| Status | Significado |
| - | - |
| **Ativa** | Vai executar no próximo horário previsto. |
| **Pausada** | Sem novas execuções. Execuções já preparadas ainda podem executar. |
| **Encerrada** | Uma agenda única que já executou. A configuração fica somente para consulta. |

## Abra uma agenda

Clique em uma linha para abrir os detalhes. O diálogo tem duas abas.

* **Histórico** lista todas as vezes que a agenda disparou.
* **Configuração** é o mesmo formulário que você usou para criar. Mude o que precisar e clique em **Salvar alterações**.

![Detalhes da agenda única encerrada, aba Histórico, com a execução Concluída e os links Ver no Uso e Ver no Debug](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/history.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=0889310801a2f107166cf30dba299bc6)

![Aba Configuração de uma agenda semanal ativa, com nome, destino, frequência, fuso horário e inputs](https://mintcdn.com/meistrari/M2w7BduKZAFA1Sbx/images/pt/schedules/configuration.png?fit=max\&auto=format\&n=M2w7BduKZAFA1Sbx\&q=85\&s=62111d6f81be3ecadd7bbe40005ed9f2)

### Histórico

Cada entrada mostra o horário agendado, o status e quando foi disparada. Nas execuções que começaram, os links **Ver no Uso** e **Ver no Debug** abrem a própria execução, onde você lê o resultado como em qualquer outra.

| Status | Significado |
| - | - |
| **Aguardando disparo** | O horário ainda não chegou. |
| **Disparada** | O Tela iniciou a execução. |
| **Aguardando execução**, **Pendente**, **Em execução** | A execução foi criada e está andando. |
| **Concluída** | A execução terminou. |
| **Falhou** | A execução começou e falhou. Abra em Usage ou Debug para ver o motivo. |
| **Falhou ao disparar** | A execução nunca começou. A entrada registra o motivo. |
| **Cancelada** | A execução foi cancelada, por exemplo porque a agenda foi excluída antes de disparar. |

## Pausar, retomar, editar e excluir

* **Pausar** interrompe novas execuções. Execuções já preparadas ainda podem executar.
* **Retomar** continua a partir do próximo horário previsto. Execuções perdidas durante a pausa não são refeitas.
* **Editar**, na aba Configuração, muda o nome, a frequência, o fuso horário, quem pode ver e as entradas. A mudança vale a partir da próxima execução. As entradas que você salva substituem as anteriores por inteiro.
* **Excluir** cancela as execuções que estavam aguardando. As que já foram disparadas continuam, e o histórico permanece em **Usage**.

## Quando uma execução falha

As falhas costumam ser de dois tipos, e cada um aparece de forma diferente no histórico.

**A execução nunca começou (Falhou ao disparar).** A agenda não conseguiu entregar a execução ao destino. As causas mais comuns são:

* As entradas não batem mais com a versão publicada, por exemplo uma variável foi renomeada ou passou a ser obrigatória.
* A pessoa responsável pela agenda perdeu acesso ao destino.
* Um serviço estava indisponível naquele momento.

Abra a aba **Configuração**, corrija as entradas e salve.

**A execução começou e falhou (Falhou).** É uma falha de execução comum. Abra com **Ver no Uso** ou **Ver no Debug** e investigue como faria com qualquer outra.

> [!WARNING]
>
> Uma agenda recorrente que continua falhando é pausada automaticamente e quem a criou é avisado. Depois de corrigir a causa, clique em **Retomar**.

## Checklist antes de agendar

* O destino está publicado e você testou a versão que está em Production (Agente: a versão publicada).
* As entradas salvas na agenda são as que você quer em toda execução.
* O fuso horário é o de quem espera o resultado.
* A frequência é a menor que o trabalho permite, porque cada execução gasta créditos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.