Skip to main content
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ênciaExemplo
A cada X horasA cada 2 horas
DiárioTodo dia às 9:00
Dias úteisSegunda a sexta às 8:00
SemanalToda segunda às 10:00
MensalTodo 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.
1

Selecione o app

Escolha entre os apps disponíveis (Slack, Gmail, Zapier, etc.).
2

Conecte sua conta

Autorize o acesso via OAuth.
3

Escolha o trigger

Selecione qual evento do app dispara a automação (ex: “Nova mensagem no Slack”).
4

Configure os parâmetros

Preencha os campos específicos do trigger (ex: qual canal do Slack monitorar).
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. 
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.
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.

​
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”
Quando o agente está publicado, mudanças nas automações entram em vigor imediatamente.