Skip to main content

Automações e Scripts

Automações são regras com gatilho + condições + ações. Scripts são sequências de ações reutilizáveis. Os dois podem ser disparados pela API.

Listar automações

Resposta:

Disparar uma automação manualmente

Isso executa as ações da automação ignorando o gatilho. Útil para botões “Executar agora” em integrações.

Disparar via webhook

Automações podem ter o gatilho Webhook. Quando configuradas assim, recebem um webhook_id próprio:
Webhooks de automação não exigem autenticação — o webhook_id em si e o segredo. Trate-o como uma chave secreta e não o exponha publicamente.
O payload do body fica disponível para as ações da automação (templates {{ trigger.json.valor }}). Veja mais em Webhooks.

Habilitar / desabilitar automação

Histórico de execuções

Retorna as últimas execuções com status, duração e (opcionalmente) o trace passo-a-passo.

Scripts

Scripts seguem o mesmo padrão de listagem e disparo:
Scripts também podem ser chamados como serviço, útil quando você já tem o entity_id:

Quando usar cada um?

Em integrações multi-usuário, evite criar/editar automações pela API sem autorização explicita do usuário — automações mudam comportamento do ambiente físico dele.