Перейти к содержимому
AISARAISAR
Автоматизации

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

Запуск сценария завершён

automation.run.finished

Срабатывает один раз, когда запуск сценария впервые переходит в финальный статус: завершён, остановлен, передан в другой сценарий, отменён или упал. Тестовые запуски и пробные прогоны событие не отправляют. В событии только метаданные запуска: переменных сценария, текстов сообщений и текста ошибок в нём нет. Если нужны собранные данные (например, ответы клиента из блока «Спросить и сохранить»), отправьте их из сценария шагом «Отправить вебхук» на ветке «Собрано». Запуск без канала не доставляется интеграции, привязанной к списку каналов. Событие не транслируется по WebSocket. Платформа шлёт событие один раз на запуск, но доставка может повторяться (ретраи), поэтому ключом дедупликации на стороне получателя берите `data.run.id`.

HTTP-запрос

AISAR отправляет подписанный POST-запрос на ваш webhook_url:

http
POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "automation.run.finished",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-11-15T10:05:12.000000Z",
  "company_id": 1,
  "data": {
    "run": {
      "id": "01JXXXXXXXXXXXXXXXXXXXXXXX",
      "automation_id": "5",
      "automation_name": "Сбор заявки",
      "version_id": "12",
      "status": "success",
      "outcome": "completed",
      "exit_reason": null,
      "error_code": null,
      "contact_id": 301,
      "conversation_id": 8841,
      "channel_id": 17,
      "started_at": "2026-11-15T10:00:03.000000Z",
      "finished_at": "2026-11-15T10:05:12.000000Z",
      "duration_ms": 309000,
      "next_run_id": null
    }
  }
}

Заголовок X-AISAR-Signature содержит HMAC-SHA256 подпись тела запроса — используйте её, чтобы убедиться, что запрос пришёл от AISAR.

Пример payload

json
{
  "event": "automation.run.finished",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-11-15T10:05:12.000000Z",
  "company_id": 1,
  "data": {
    "run": {
      "id": "01JXXXXXXXXXXXXXXXXXXXXXXX",
      "automation_id": "5",
      "automation_name": "Сбор заявки",
      "version_id": "12",
      "status": "success",
      "outcome": "completed",
      "exit_reason": null,
      "error_code": null,
      "contact_id": 301,
      "conversation_id": 8841,
      "channel_id": 17,
      "started_at": "2026-11-15T10:00:03.000000Z",
      "finished_at": "2026-11-15T10:05:12.000000Z",
      "duration_ms": 309000,
      "next_run_id": null
    }
  }
}

Поля payload

ПолеТипОписание
run.idstringID запуска. Используйте как ключ дедупликации
run.automation_idstringID сценария
run.automation_namestring|nullНазвание сценария на момент отправки события
run.version_idstring|nullID версии сценария, по которой шёл запуск
run.statusstringФинальный статус запуска, например `success`, `goal_reached`, `cancelled`, `failed`, `error`
run.outcomestringНормализованный итог: `completed` (штатное завершение), `goal_reached` (цель сценария достигнута), `stopped` (остановлен блоком «Остановить»), `handed_off` (передан в другой сценарий или перезапущен), `cancelled` (отменён, например сценарий выключили), `failed` (ошибка)
run.exit_reasonstring|nullКод причины выхода из запуска (например `stopped`, `handoff`, `restarted`), если есть
run.error_codestring|nullЗаполнено только при `outcome=failed`, значение из закрытого списка: `wake_failed` (не удалось продолжить запуск после ожидания), `flow_limit` (сработала защита от зацикливания), `handoff_dispatch_failed` (не удалось передать в другой сценарий), `no_version` (у сценария нет версии для запуска), `job_failed` (прочий сбой). Текста ошибки в событии нет
run.contact_idinteger|nullID контакта запуска
run.conversation_idinteger|nullID диалога, с которого начат запуск; `null`, если запуск не привязан к диалогу
run.channel_idinteger|nullID канала запуска; `null`, если канала нет
run.started_atstring|nullНачало запуска (ISO 8601)
run.finished_atstring|nullЗавершение запуска (ISO 8601)
run.duration_msinteger|nullДлительность запуска в миллисекундах, включая ожидания
run.next_run_idstring|nullID следующего запуска при передаче в другой сценарий, иначе `null`