Каталог событий MCN Telecom — Чат-боты
1 просмотра
Создано 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.
Создание пользователя
CreatedNewUser - Создание нового пользователя чат-ботов
Описание: Создание нового пользователя чат-ботов
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
temp_scenario_id | string | ✓ | ID временного сценария |
finished_at | null | ✓ | Момент завершения диалога чат-бота (null, если ещё не завершён) |
mcn_id | string | ✓ | Внутренний ID виджета чат-бота |
widget_browser | string | ✓ | User-Agent браузера пользователя виджета |
widget_system_language | string | ✓ | Язык системы пользователя виджета |
blocked_since | null | ✓ | Момент блокировки пользователя, если заблокирован |
eventType | string | ✓ | Дублирует event_type события |
contact_id | null | ✓ | ID контакта в адресной книге, связанного с пользователем виджета |
platform | string | ✓ | Платформа |
chat_id | string | ✓ | ID чата |
accountId | number | ✓ | ID аккаунта |
current_url | string | ✓ | URL страницы, на которой открыт виджет чат-бота |
account_id | string | ✓ | Номер ЛС |
chat_user_id | number | ✓ | ID чата в Telegram |
created_ts | string | ✓ | Время создания события |
widget_os | string | ✓ | Операционная система пользователя виджета |
queue_id | null | ✓ | ID очереди |
platform_user_id | string | ✓ | ID пользователя на платформе |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "CreatedNewUser",
"created_at": "2026-07-01T22:45:59.276Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"mcn_widget_city": "{\"geonameId\":499099,\"names\":{\"de\":\"Samara\",\"en\":\"Samara\",\"es\":\"Samara\",\"fr\":\"Samara\",\"ja\":\"サマーラ\",\"pt-BR\":\"Samara\",\"ru\":\"Самара\"}}",
"temp_scenario_id": "78235",
"finished_at": null,
"mcn_id": "62fcdeeaef0a4063",
"widget_browser": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/149.0.0.0 Mobile Safari/537.36",
"widget_system_language": "ru-RU",
"blocked_since": null,
"mcn_widget_country": "{\"geonameId\":2017370,\"isoCode\":\"RU\",\"names\":{\"de\":\"Russland\",\"en\":\"Russia\",\"es\":\"Rusia\",\"fr\":\"Russie\",\"ja\":\"ロシア\",\"pt-BR\":\"Rússia\",\"ru\":\"Россия\",\"zh-CN\":\"俄罗斯联邦\"}}",
"eventType": "CreatedNewUser",
"contact_id": null,
"platform": "mcn-widget",
"chat_id": "5608",
"accountId": 10001,
"current_url": "https://www.example.com",
"account_id": "10001",
"chat_user_id": 59154342,
"created_ts": "2026-07-01T19:45:58.553Z",
"widget_os": "Android",
"queue_id": null,
"platform_user_id": "62fcdeeaef0a4063",
"mcn_widget_ip": "203.0.113.10"
}
}