> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertgroup.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Executar uma automação

> Como disparar, acompanhar e interpretar o status de uma execução

Quem pode: qualquer pessoa autenticada no Hub. Não é preciso ser administrador para rodar uma automação já cadastrada.

## Como disparar

1. Escolha a automação desejada no catálogo.
2. Preencha os dados que aquela automação pede para rodar. Cada automação define seus próprios campos, então o formulário muda conforme a automação escolhida.
3. Confirme. A execução é criada na hora: você não espera o processo terminar para receber a confirmação.

## Status de uma execução

Toda execução passa por um caminho linear de status, sem volta:

* **Pendente**: a execução foi criada e está na fila. A máquina dedicada daquela automação pode estar ligando.
* **Em execução**: a máquina pegou a execução e está processando.
* **Concluída**: terminou com sucesso. O resultado fica disponível na própria execução.
* **Falhou**: terminou com erro. A mensagem de erro fica registrada na própria execução.

Não existe status intermediário de progresso: a execução vai direto de "em execução" para um status final. Também não existe cancelamento: uma vez criada, a execução segue até completar ou falhar.

## Quando uma execução demora para sair de pendente

Três causas possíveis, e hoje não há como diferenciar olhando só a execução:

* A automação está em modo desenvolvimento (ver [Administrar o catálogo](/operations/catalogo)) e ainda não foi liberada para uso.
* A automação já está no limite de execuções simultâneas que ela suporta.
* A máquina dedicada daquela automação ainda está ligando.

Nos dois primeiros casos, o sistema tenta novamente automaticamente assim que a situação muda: a automação sai do modo desenvolvimento, ou uma vaga libera. Não é preciso recriar a execução.

## Se uma execução ficar presa em "em execução"

Hoje não existe um limite de tempo automático: se algo impedir a máquina de reportar o resultado, a execução pode ficar "em execução" indefinidamente. Se isso acontecer, avise quem administra aquela automação.

## Histórico

Toda execução fica registrada: o que foi disparado, quando, por quem e com qual resultado. Por padrão você só vê as próprias execuções; administradores veem todas.
