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

# Automações

> Envie prompts para o agente de forma agendada, via app ou webhook

Automações permitem que o agente execute tarefas automaticamente, sem interação de um usuário. Você define um **prompt** (a instrução que o agente vai receber) e um **trigger** (o evento que dispara a execução).

## Como funciona

1. Você cria uma automação dentro do agente
2. Define o **prompt** — a mensagem/instrução que o agente vai processar
3. Escolhe o **trigger** — o que dispara a execução (agendamento, app, webhook ou manual)
4. O agente recebe o prompt automaticamente quando o trigger é ativado e executa como se fosse uma conversa

## Criando uma automação

Na seção **Automações** do agente, clique em **Criar** e preencha:

* **Nome** — Identificador da automação
* **Prompt** — A instrução que o agente vai receber quando a automação disparar (até 10.000 caracteres)
* **Descrição** — Opcional, para documentar o propósito
* **Modo HITL** — Como lidar com ações que requerem aprovação:
  * **Auto-approve** — Executa tudo sem esperar aprovação humana
  * **Pausar para aprovação** — Pausa e aguarda autorização antes de ações sensíveis

## Tipos de trigger

### Agendamento

Execute a automação em horários definidos. Configure a frequência:

| Frequência         | Exemplo                 |
| ------------------ | ----------------------- |
| **A cada X horas** | A cada 2 horas          |
| **Diário**         | Todo dia às 9:00        |
| **Dias úteis**     | Segunda a sexta às 8:00 |
| **Semanal**        | Toda segunda às 10:00   |
| **Mensal**         | Todo dia 1 às 9:00      |

Selecione também o **fuso horário** (ex: America/Sao\_Paulo).

### App Trigger

Dispare a automação quando algo acontece em um app conectado. Por exemplo: quando chega um e-mail no Gmail, quando uma mensagem é enviada no Slack, ou quando um registro é criado no CRM.

<Steps>
  <Step title="Selecione o app">
    Escolha entre os apps disponíveis (Slack, Gmail, Zapier, etc.).
  </Step>

  <Step title="Conecte sua conta">
    Autorize o acesso via OAuth.
  </Step>

  <Step title="Escolha o trigger">
    Selecione qual evento do app dispara a automação (ex: "Nova mensagem no Slack").
  </Step>

  <Step title="Configure os parâmetros">
    Preencha os campos específicos do trigger (ex: qual canal do Slack monitorar).
  </Step>
</Steps>

O payload do evento é enviado junto com o prompt para o agente, que pode usar essas informações na resposta.

### Webhook URL

O Gennia gera uma **URL única** que aceita requisições POST. Qualquer sistema externo pode disparar a automação enviando um request para essa URL.

```bash theme={null}
curl -X POST https://sua-url-webhook.gennia.com.br \
  -H "Content-Type: application/json" \
  -d '{"dados": "payload do seu sistema"}'
```

O payload enviado na requisição é incluído no contexto do agente junto com o prompt.

<Tip>
  Você pode copiar a URL e o exemplo de curl diretamente na interface. Se precisar gerar uma nova URL, use o botão de regenerar.
</Tip>

### Manual

Sem trigger automático. A automação só executa quando você clica no botão **Testar** na lista de automações. Útil para testes e execuções pontuais.

## Testando

Cada automação tem um botão de **Testar** que executa imediatamente, independente do trigger configurado. Após a execução, você pode ver:

* **Status** — Se completou com sucesso ou falhou
* **Quando executou** — Timestamp da última execução
* **Próxima execução** — Para automações agendadas

## Exemplos de uso

* **Relatório diário** — Agendado todo dia às 8h: "Gere um resumo das conversas de ontem e envie por e-mail"
* **Novo lead no CRM** — App trigger no HubSpot: "Analise o perfil do lead e envie uma mensagem de boas-vindas personalizada"
* **Deploy no GitHub** — Webhook: "Analise o changelog do deploy e notifique o time no Slack"
* **Pesquisa de satisfação** — Agendado semanalmente: "Envie follow-up para clientes que não responderam a pesquisa"

<Note>
  Quando o agente está publicado, mudanças nas automações entram em vigor imediatamente.
</Note>