Каталог событий MCN Telecom - часть 4
3 просмотра
Создано 17.08.2026
Обновлено 20.08.2026События (вебхуки и триггеры), которые платформа MCN Telecom отправляет на адрес (URL) клиента. Единый envelope для всех событий, один channel = один event_type.
Часть 4
Часть 1 смотрите здесь;
Часть 2 смотрите здесь;
Часть 3 смотрите здесь;
Часть 5 смотрите здесь;
Часть 6 смотрите здесь
Operations
DIDFwCallEnd - Завершение переадресованного звонка в телефонии
Завершение переадресованного звонка
Событие: Завершение переадресованного звонка в телефонии
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
dest | string | ✓ | Номер/направление, куда звонили |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
timestamp | number | ✓ | Время создания события |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
answered | string | ✓ | Был ли отвечен звонок: 0 или 1 |
callerNumber | string | ✓ | Номер звонящего абонента |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
did | string | ✓ | Номер телефона |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "DIDFwCallEnd",
"created_at": "2026-06-30T11:49:03.784Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"connectedLineNum": "79000000005",
"userEventType": "DIDFwCallEnd",
"channel": "SIP/sip-node1-000cff48",
"privilege": "user,all",
"dest": "79000000006",
"exten": "s",
"channelState": 5,
"callerIdNum": "s",
"systemName": "123",
"dateReceived": "Jun 30, 2026, 11:49:03 AM",
"context": "did-signal-fw-call-hangup-handler",
"callerID": "79000000005",
"event": "DIDFwCallEnd",
"timestamp": 1782809343,
"callId": "123-1782809342.9422691",
"linkedId": "123-1782809342.9422691",
"answered": "0",
"callerNumber": "79000000005",
"connectedLineName": "79000000005",
"dateReceivedAtUTC": "2026-06-30 08:49:03.534590",
"eventType": "DIDFwCallEnd",
"priority": 4,
"accountId": 10001,
"channelStateDesc": "Ringing",
"did": "79000000007",
"uniqueId": "123-1782809342.9422694"
}
}
OutgoingAnswer - Ответ на исходящий звонок телефонии
Исходящий звонок отвечен
Событие: Ответ на исходящий звонок телефонии
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
record | string | ✓ | Наличие записи разговора: 1 — есть, 0 — нет |
context | string | ✓ | Контекст события |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
calledNumber | string | ✓ | Кто звонит |
timestamp | number | ✓ | Время создания события |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего абонента |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
did | string | ✓ | Номер телефона |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "OutgoingAnswer",
"created_at": "2026-06-30T10:27:25.556Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"connectedLineNum": "79000000019",
"userEventType": "OutgoingAnswer",
"channel": "SIP/sip-node1-00375e92",
"privilege": "user,all",
"exten": "s",
"channelState": 6,
"callerIdNum": "79000000020",
"systemName": "122",
"dateReceived": "Jun 30, 2026, 10:27:25 AM",
"record": "0",
"context": "signal-outgoing-bridge",
"event": "OutgoingAnswer",
"calledNumber": "79000000020",
"timestamp": 1782804445,
"callId": "122-1782804436.45988052",
"linkedId": "122-1782804436.45988052",
"callerNumber": null,
"connectedLineName": "79000000019",
"dateReceivedAtUTC": "2026-06-30 07:27:25.333723",
"eventType": "OutgoingAnswer",
"priority": 28,
"accountId": 10001,
"channelStateDesc": "Up",
"did": "79000000019",
"uniqueId": "122-1782804436.45988055"
}
}
InboundCallStart - Начало входящего звонка телефонии
Начало входящего звонка
Событие: Начало входящего звонка телефонии
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
objectType | string | ✓ | Тип объекта (например did) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
objectId | string | ✓ | ID объекта |
timestamp | number | ✓ | Время создания события |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего абонента |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
callerIdName | string | ✓ | Имя вызывающего абонента, если передано АТС/оператором |
did | string | ✓ | Номер телефона |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "InboundCallStart",
"created_at": "2026-07-01T20:25:11.177Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"userEventType": "InboundCallStart",
"channel": "SIP/sip-node3-000056be",
"privilege": "user,all",
"exten": "s",
"objectType": "did",
"channelState": 4,
"callerIdNum": "79000000014",
"systemName": "207",
"dateReceived": "Jul 1, 2026, 5:25:11 PM",
"context": "signal-did-inbound-call",
"callerID": "79000000014",
"event": "InboundCallStart",
"objectId": "559985",
"timestamp": 1782926711,
"callId": "207-1782926711.179818",
"linkedId": "207-1782926711.179818",
"callerNumber": "79000000014",
"dateReceivedAtUTC": "2026-07-01 17:25:11.044072",
"eventType": "InboundCallStart",
"priority": 2,
"accountId": 10001,
"channelStateDesc": "Ring",
"callerIdName": "79000000014",
"did": "79000000015",
"uniqueId": "207-1782926711.179818"
}
}
OutgoingStart - Начало исходящего звонка
Начало исходящего звонка
Событие: Начало звонка
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего абонента |
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
eventType | string | ✓ | Тип события |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
accountId | number | ✓ | Номер ЛС |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
calledNumber | string | ✓ | Кто звонит |
did | string | ✓ | Номер телефона |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
timestamp | number | ✓ | Время создания события |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "OutgoingStart",
"created_at": "2026-07-01T13:15:49.141Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"callId": "206-1782900948.347401",
"linkedId": "206-1782900948.347401",
"callerNumber": null,
"connectedLineNum": "79000000021",
"userEventType": "OutgoingStart",
"connectedLineName": "79000000021",
"dateReceivedAtUTC": "2026-07-01 10:15:48.989278",
"channel": "SIP/sip-node1-00009a8f",
"privilege": "user,all",
"eventType": "OutgoingStart",
"priority": 11,
"exten": "s",
"channelState": 0,
"accountId": 10001,
"callerIdNum": "s",
"systemName": "206",
"dateReceived": "Jul 1, 2026, 10:15:48 AM",
"context": "signal-outgoing-call",
"channelStateDesc": "Down",
"event": "OutgoingStart",
"calledNumber": "79000000022",
"did": "79000000021",
"uniqueId": "206-1782900948.347404",
"timestamp": 1782900948
}
}
DIDFwCallStart - Начало переадресованного звонка в телефонии
Начало переадресованного звонка в телефонии
Событие: Начало переадресованного звонка в телефонии
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
dest | string | ✓ | Номер/направление, куда звонили |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
timestamp | number | ✓ | Время создания события |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего абонента |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
did | string | ✓ | Номер телефона |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "DIDFwCallStart",
"created_at": "2026-06-30T11:49:02.572Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"connectedLineNum": "79000000005",
"userEventType": "DIDFwCallStart",
"channel": "SIP/sip-node1-000cff48",
"privilege": "user,all",
"dest": "79000000006",
"exten": "s",
"channelState": 0,
"callerIdNum": "s",
"systemName": "123",
"dateReceived": "Jun 30, 2026, 11:49:02 AM",
"context": "did-signal-fw-call",
"callerID": "79000000005",
"event": "DIDFwCallStart",
"timestamp": 1782809342,
"callId": "123-1782809342.9422691",
"linkedId": "123-1782809342.9422691",
"callerNumber": "79000000005",
"connectedLineName": "79000000005",
"dateReceivedAtUTC": "2026-06-30 08:49:02.357062",
"eventType": "DIDFwCallStart",
"priority": 3,
"accountId": 10001,
"channelStateDesc": "Down",
"did": "79000000007",
"uniqueId": "123-1782809342.9422694"
}
}
PhoneCallEnd - ВАТС: Завершение звонка на внутренний номер
ВАТС: Завершение звонка на внутренний номер
Событие: Конец звонка на внутренний номер ВАТС
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
externalNumber | string | ✓ | Внешний номер |
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
dateReceivedQueueCA | number | ✓ | Unix-время (мс) постановки звонка в очередь |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
isIncoming | boolean | ✓ | true — входящий звонок, false — исходящий |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
duration | number | ✓ | Общая продолжительность звонка |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
file | string | ✓ | Название файла записи разговора, если запись сохранена |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
from | string | ✓ | Номер звонящего с внутренним номером оператора |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
calledNumber | string | ✓ | Номер, на который звонят |
billsec | string | ✓ | Длительность разговора после ответа |
timestamp | number | ✓ | Время создания события |
dateReceivedAgCall | number | ✓ | Unix-время (мс) ответа агента на звонок из очереди |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
answered | string | ✓ | Был ли отвечен звонок: 0 или 1 |
callerNumber | string | ✓ | Номер звонящего |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
internalNumber | string | ✓ | Внутренний номер оператора |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
durationWaiting | number | ✓ | Время ожидания ответа |
to | string | ✓ | Номер назначения с внутренним номером оператора |
coreUserId | string | ✓ | Внутренний ID пользователя/сотрудника (агента) ВАТС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
callerIdName | string | ✓ | Имя вызывающего абонента, если передано АТС/оператором |
did | string | ✓ | Номер оператора |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
vpbxId | string | ✓ | Номер Виртуальной АТС |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "PhoneCallEnd",
"created_at": "2026-07-01T19:32:51.377Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"externalNumber": "79000000027",
"connectedLineNum": "79000000027",
"dateReceivedQueueCA": 1782934370000,
"userEventType": "PhoneCallEnd",
"channel": "SIP/70711398-000fa1cf",
"privilege": "user,all",
"exten": "s",
"isIncoming": true,
"channelState": 0,
"duration": 1782934370,
"callerIdNum": "9414",
"file": "",
"systemName": "125",
"dateReceived": "Jul 1, 2026, 7:32:50 PM",
"context": "signal-phone-call-hangup-handler",
"from": "79000000027",
"callerID": "79000000027",
"event": "PhoneCallEnd",
"calledNumber": "",
"billsec": "0",
"timestamp": 1782923570,
"dateReceivedAgCall": 0,
"callId": "125-1782923545.12183739",
"linkedId": "125-1782923545.12183739",
"answered": "0",
"callerNumber": "79000000027",
"connectedLineName": "79000000027",
"dateReceivedAtUTC": "2026-07-01 16:32:51.045416",
"eventType": "PhoneCallEnd",
"internalNumber": "9414",
"priority": 11,
"accountId": 10001,
"durationWaiting": 0,
"to": "9414",
"coreUserId": "100992",
"channelStateDesc": "Down",
"callerIdName": "Petrov Ivan KRD FMC",
"did": "",
"uniqueId": "125-1782923570.12183837",
"vpbxId": "280"
}
}
PhoneCallAnswer - Ответ на звонок
Ответ на звонок
Событие: Ответ на звонок
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
externalNumber | string | ✓ | Внешний номер |
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
dateReceivedQueueCA | number | ✓ | Unix-время (мс) постановки звонка в очередь |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
isIncoming | boolean | ✓ | true — входящий звонок, false — исходящий |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
record | string | ✓ | Наличие записи разговора: 1 — есть, 0 — нет |
context | string | ✓ | Контекст события |
from | string | ✓ | Номер звонящего с внутренним номером оператора |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
calledNumber | string | ✓ | Номер, на который звонят |
timestamp | number | ✓ | Время создания события |
dateReceivedAgCall | number | ✓ | Unix-время (мс) ответа агента на звонок из очереди |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Тип события |
internalNumber | string | ✓ | Внутренний номер оператора |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер ЛС |
durationWaiting | number | ✓ | Время ожидания ответа |
to | string | ✓ | Номер назначения с внутренним номером оператора |
coreUserId | string | ✓ | Внутренний ID пользователя/сотрудника (агента) ВАТС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
callerIdName | string | — | Имя вызывающего абонента, если передано АТС/оператором |
did | string | ✓ | Номер оператора |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
vpbxId | string | ✓ | Номер Виртуальной АТС |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "PhoneCallAnswer",
"created_at": "2026-07-01T18:40:24.541Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"externalNumber": "79000000025",
"connectedLineNum": "79000000025*F1;cpc=MT_FMC",
"dateReceivedQueueCA": 1782931224000,
"userEventType": "PhoneCallAnswer",
"channel": "SIP/sip-node1-000f9d4a",
"privilege": "user,all",
"exten": "s",
"isIncoming": true,
"channelState": 6,
"callerIdNum": "4000",
"systemName": "125",
"dateReceived": "Jul 1, 2026, 6:40:24 PM",
"record": "1",
"context": "signal-phone-call-bridge",
"from": "79000000025",
"callerID": "79000000025",
"event": "PhoneCallAnswer",
"calledNumber": "79000000026",
"timestamp": 1782920424,
"dateReceivedAgCall": 1782931217000,
"callId": "125-1782920417.12169668",
"linkedId": "125-1782920417.12169668",
"callerNumber": "79000000025",
"connectedLineName": "79000000025*F1",
"dateReceivedAtUTC": "2026-07-01 15:40:24.235305",
"eventType": "PhoneCallAnswer",
"internalNumber": "4000",
"priority": 24,
"accountId": 10001,
"durationWaiting": 7,
"to": "4000",
"coreUserId": "154759",
"channelStateDesc": "Up",
"did": "79000000026",
"uniqueId": "125-1782920417.12169673",
"vpbxId": "280"
}
}
GuestRegionCall - Звонок из гостевого региона
Звонок из гостевого региона
Событие: Звонок гостевого региона
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
eventType | string | ✓ | Тип события |
accountId | number | ✓ | Номер ЛС |
after | string | ✓ | Информация о событии |
ts_ms | number | ✓ | Время создания события в миллисекундах |
callId | string | ✓ | Идентификатор звонка |
numA | string | ✓ | Номер A |
numB | string | ✓ | Номер B |
dst_number | string | ✓ | Номер оператора |
src_number | string | ✓ | Номер абонента |
connect_time | string | ✓ | Время соединения |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 0,
"event_type": "string",
"created_at": "2019-08-24T14:15:22Z",
"idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
"data": {
"eventType": "string",
"accountId": 0,
"after": "string",
"ts_ms": 0,
"callId": "string",
"numA": "string",
"numB": "string",
"dst_number": "string",
"src_number": "string",
}
}
PhoneFwStart - ВАТС: Переадресация на внутренний номер
ВАТС: Переадресация на внутренний номер
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
connectedLineNum | string | ✓ | Номер собеседника (Connected Line); может содержать доп. параметры через * |
userEventType | string | ✓ | Дублирует event_type — тип события AMI UserEvent |
channel | string | ✓ | Имя канала Asterisk (SIP/PJSIP, Local и др.) |
forwardedBy | string | ✓ | Внутренний номер, с которого выполнена переадресация |
privilege | string | ✓ | Уровень логирования/видимости события в Asterisk AMI |
exten | string | ✓ | Extension диалплана, где сработало событие (для входящих обычно s) |
channelState | number | ✓ | Код состояния Asterisk-канала (см. channelStateDesc) |
callerIdNum | string | ✓ | Номер вызывающего абонента (Caller ID number) |
systemName | string | ✓ | ID Asterisk-сервера (номер хаба) |
dateReceived | string | ✓ | Момент получения события (локальное время сервера) |
context | string | ✓ | Контекст события |
callerID | string | ✓ | ID звонящего (номер телефона) |
event | string | ✓ | Дублирует event_type — служебное поле Asterisk UserEvent |
calledNumber | string | ✓ | Номер, на который был совершён звонок |
timestamp | number | ✓ | Время события |
callId | string | ✓ | Идентификатор звонка |
linkedId | string | ✓ | ID связанного звонка |
callerNumber | string | ✓ | Номер звонящего абонента |
connectedLineName | string | ✓ | Имя/номер собеседника в Connected Line (см. connectedLineNum) |
dateReceivedAtUTC | string | ✓ | Время получения Kafka-коннектором в UTC, до микросекунд; дублирует dateReceived |
eventType | string | ✓ | Дублирует event_type |
internalNumber | string | ✓ | Внутренний номер |
priority | number | ✓ | Приоритет текущего шага диалплана Asterisk |
accountId | number | ✓ | Номер лицевого счёта |
coreUserId | string | ✓ | Внутренний ID пользователя/сотрудника (агента) ВАТС |
channelStateDesc | string | ✓ | Расшифровка channelState (например Up, Ring, Down) |
did | string | ✓ | Номер, на который звонили |
uniqueId | string | ✓ | Уникальный ID call-leg, формат {systemName}-{timestamp}.{seq} |
vpbxId | string | ✓ | Номер ВАТС |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "PhoneFwStart",
"created_at": "2026-07-01T15:31:39.424Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"connectedLineNum": "79000000030*F1",
"userEventType": "PhoneFwStart",
"channel": "Local/s@fmc-phone-0002e136;1",
"forwardedBy": "416",
"privilege": "user,all",
"exten": "s",
"channelState": 0,
"callerIdNum": "s",
"systemName": "125",
"dateReceived": "Jul 1, 2026, 3:31:39 PM",
"context": "signal-phone-call",
"callerID": "79000000030",
"event": "PhoneFwStart",
"calledNumber": "",
"timestamp": 1782909099,
"callId": "125-1782909057.12103742",
"linkedId": "125-1782909057.12103742",
"callerNumber": "7846",
"connectedLineName": "79000000030*F1",
"dateReceivedAtUTC": "2026-07-01 12:31:39.238031",
"eventType": "PhoneFwStart",
"internalNumber": "9416",
"priority": 5,
"accountId": 10001,
"coreUserId": "169479",
"channelStateDesc": "Down",
"did": "7846",
"uniqueId": "125-1782909099.12104435",
"vpbxId": "280"
}
}
Integration_update_contact_bulk - Добавление контакта в корзину
Добавление контакта в корзину
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
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
accountId | number | ✓ | Номер лицевого счёта |
eventType | string | ✓ | Тип события |
id | string | ✓ | Уникальный технический идентификатор события (UUID) |
type | string | ✓ | Источник изменения контакта (external_event — контакт изменён во внешней системе) |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 0,
"event_type": "string",
"created_at": "2019-08-24T14:15:22Z",
"idempotencyKey": "0c14c6a6-6f50-4d1e-b0c4-b46ff43ba6a1",
"data": {
"accountId": 0,
"eventType": "string",
"id": "string",
"type": "string"
}
}
Также см.:
Каталог событий MCN Telecom - часть 1;
Каталог событий MCN Telecom - часть 2;
Каталог событий MCN Telecom - часть 3;
Каталог событий MCN Telecom - часть 5;
Каталог событий MCN Telecom - часть 6