Автоматизации

Визуальные workflow-автоматизации: триггер (событие/канал/условия) запускает граф из узлов (nodes) и связей (edges) — отправка сообщений, смена стадии сделки, HTTP-вызовы, ветвления по условиям. Метаданные автоматизации (`name`, `status`) обновляются через `PATCH /automations/{id}`, а сам граф — отдельным эндпоинтом `PATCH /automations/{id}/builder`. Каждый запуск автоматизации логируется как `run` с пошаговой трассировкой.

Эндпоинты

Метод	Путь	Описание
GET	`/v1/automations/bootstrap` Bootstrap-данные для визуального редактора	Bootstrap-данные для визуального редактора
GET	`/v1/automations` Список автоматизаций	Список автоматизаций
GET	`/v1/automations/{automation}` Получение автоматизации	Получение автоматизации
POST	`/v1/automations` Создание автоматизации	Создание автоматизации
PATCH	`/v1/automations/{automation}` Обновление метаданных автоматизации	Обновление метаданных автоматизации
PATCH	`/v1/automations/{automation}/builder` Сохранение визуального графа (nodes, edges, triggers)	Сохранение визуального графа (nodes, edges, triggers)
DELETE	`/v1/automations/{automation}` Удаление автоматизации	Удаление автоматизации
GET	`/v1/automations/{automation}/runs` Список запусков автоматизации	Список запусков автоматизации
GET	`/v1/automations/{automation}/runs/{run}` Получение конкретного запуска с шагами	Получение конкретного запуска с шагами

Примеры

Создание автоматизации

Запрос

bash

curl -X POST https://api.aisar.app/v1/automations \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome automation",
    "description": "Sends a greeting on the first inbound message",
    "status": "draft"
  }'

Ответ

json

{
  "data": {
    "id": "b4a8e0d2-7f2f-4fef-9d53-c525f31b1930",
    "companyId": "1",
    "name": "Welcome automation",
    "description": "Sends a greeting on the first inbound message",
    "status": "draft",
    "healthStatus": "ok",
    "activeVersionId": null,
    "latestVersionId": null,
    "templateId": null,
    "executionsCount": 0,
    "lastRunAt": null,
    "createdAt": "2026-03-15T10:00:00.000000Z",
    "updatedAt": "2026-03-15T10:00:00.000000Z",
    "createdBy": "5",
    "updatedBy": "5"
  }
}

Получение запуска автоматизации

Запрос

bash

curl https://api.aisar.app/v1/automations/b4a8e0d2-7f2f-4fef-9d53-c525f31b1930/runs/9001 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

json

{
  "data": {
    "id": 9001,
    "automation_id": "b4a8e0d2-7f2f-4fef-9d53-c525f31b1930",
    "version_id": "v3",
    "status": "completed",
    "trigger_payload": { "event": "message.created", "channel_id": 7 },
    "started_at": "2026-03-15T10:00:00+00:00",
    "finished_at": "2026-03-15T10:00:02+00:00",
    "duration_ms": 1840,
    "pii_redacted": false,
    "total_cost_usd": 0.000412,
    "total_tokens": 210,
    "steps": []
  }
}