Каталог событий MCN Telecom — ИИ-агент
0 просмотра
Создано 27.08.2026
Обновлено 27.08.2026ИИ-агент
События (вебхуки и триггеры), связанные с работой ИИ-агента.
Единый Envelope используется для всех событий: один channel соответствует одному event_type.
Содержание
Также см.:
«Каталог событий MCN Telecom — Виртуальная АТС (Звонки ВАТС, Переадресация и внутренние номера)»;
«Каталог событий MCN Telecom — Виртуальная АТС (Очереди, Другие события ВАТС)»;
«Каталог событий MCN Telecom — Работа с речью»;
Общий формат события
Все события используют общую обёртку Envelope:
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
account_id | integer | ✓ | ID аккаунта в системе |
event_type | string | ✓ | Тип события |
created_at | string (date-time) | ✓ | Момент события (UTC) |
idempotencyKey | string (uuid) | — | Ключ идемпотентности; одинаков при повторных доставках и используется для дедупликации |
data | object | ✓ | Данные, специфичные для event_type |
✓— обязательное поле;—— необязательное.
Для события приведены описание полей data и пример Payload.
Создание сессии
SessionCreated - ИИ Агент: Сессия создана
Описание: Событие создания новой сессии ИИ-агента.
Payload: allOf — общий Envelope + данные события.
Envelope
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
account_id | integer | ✓ | ID аккаунта в системе |
event_type | string | ✓ | Тип события — см. components/messages |
created_at | string (date-time) | ✓ | Момент события (UTC) |
idempotencyKey | string (uuid) | — | Ключ идемпотентности; используется для дедупликации повторных доставок |
data | object | ✓ | Данные, специфичные для event_type |
data
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
id | string | ✓ | Идентификатор события |
type | string | ✓ | Тип события |
eventTs | string | ✓ | Unix-время (мс) создания события на стороне сценарного движка |
eventName | string | ✓ | Имя события |
eventVersion | string | ✓ | Версия внутреннего формата события сценария |
agentId | string | ✓ | ID ИИ-агента |
accountId | string | ✓ | Номер лицевого счёта; дублирует account_id из Envelope |
sessionId | string | ✓ | ID сессии ИИ-агента |
linkedId | string | ✓ | ID связанного звонка |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 0,
"event_type": "string",
"created_at": "2019-08-24T14:15:22Z",
"idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
"data": {
"id": "string",
"type": "string",
"eventTs": "string",
"eventName": "string",
"eventVersion": "string",
"agentId": "string",
"accountId": "string",
"sessionId": "string",
"linkedId": "string"
}
}