PerpetuusPerpetuus Developers

Automações (BETA)

Workflows, publish, runs e logs — API avançada com risco de breaking change.

BETA — API avançada. Estes endpoints podem mudar sem major version e têm efeitos colaterais (publish, test com dryRun: false). Use sandbox e trate breaking changes.

Automações reagem a eventos do CRM (card.created, phase_changed, message.received…) e executam ações (task.create, http.request, channel.send_message…).

Fluxo seguro

  1. POST /automations — cria inactive (active: true é rejeitado no create)
  2. Edite o grafo / ações
  3. POST /automations/{id}/validate-graph — sem side-effect
  4. POST /automations/{id}/publish — cria versão publicada
  5. POST /automations/{id}/toggle — liga/desliga
  6. POST /automations/{id}/test com dryRun: true antes de qualquer teste real

Endpoints

MétodoPathNotas
GET/POST/automationsListar / criar
GET/PUT/DELETE/automations/{id}CRUD
POST/automations/{id}/publishEfeito colateral
POST/automations/{id}/testdryRun default true
POST/automations/{id}/toggleExige publish prévio para ativar
GET/automations/{id}/runsHistórico
GET/automation-logsLogs

Referência completa: API Reference → Automações.

On this page