Автоматизации
Запуск сценария завершён
automation.run.finishedСрабатывает один раз, когда запуск сценария впервые переходит в финальный статус: завершён, остановлен, передан в другой сценарий, отменён или упал. Тестовые запуски и пробные прогоны событие не отправляют. В событии только метаданные запуска: переменных сценария, текстов сообщений и текста ошибок в нём нет. Если нужны собранные данные (например, ответы клиента из блока «Спросить и сохранить»), отправьте их из сценария шагом «Отправить вебхук» на ветке «Собрано». Запуск без канала не доставляется интеграции, привязанной к списку каналов. Событие не транслируется по WebSocket. Платформа шлёт событие один раз на запуск, но доставка может повторяться (ретраи), поэтому ключом дедупликации на стороне получателя берите `data.run.id`.
HTTP-запрос
AISAR отправляет подписанный POST-запрос на ваш webhook_url:
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
{
"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.id | string | ID запуска. Используйте как ключ дедупликации |
run.automation_id | string | ID сценария |
run.automation_name | string|null | Название сценария на момент отправки события |
run.version_id | string|null | ID версии сценария, по которой шёл запуск |
run.status | string | Финальный статус запуска, например `success`, `goal_reached`, `cancelled`, `failed`, `error` |
run.outcome | string | Нормализованный итог: `completed` (штатное завершение), `goal_reached` (цель сценария достигнута), `stopped` (остановлен блоком «Остановить»), `handed_off` (передан в другой сценарий или перезапущен), `cancelled` (отменён, например сценарий выключили), `failed` (ошибка) |
run.exit_reason | string|null | Код причины выхода из запуска (например `stopped`, `handoff`, `restarted`), если есть |
run.error_code | string|null | Заполнено только при `outcome=failed`, значение из закрытого списка: `wake_failed` (не удалось продолжить запуск после ожидания), `flow_limit` (сработала защита от зацикливания), `handoff_dispatch_failed` (не удалось передать в другой сценарий), `no_version` (у сценария нет версии для запуска), `job_failed` (прочий сбой). Текста ошибки в событии нет |
run.contact_id | integer|null | ID контакта запуска |
run.conversation_id | integer|null | ID диалога, с которого начат запуск; `null`, если запуск не привязан к диалогу |
run.channel_id | integer|null | ID канала запуска; `null`, если канала нет |
run.started_at | string|null | Начало запуска (ISO 8601) |
run.finished_at | string|null | Завершение запуска (ISO 8601) |
run.duration_ms | integer|null | Длительность запуска в миллисекундах, включая ожидания |
run.next_run_id | string|null | ID следующего запуска при передаче в другой сценарий, иначе `null` |