Каталог событий MCN Telecom — Телефония
28 просмотра
Создано 17.08.2026
Обновлено 06.10.2026Телефония
События (вебхуки и триггеры), связанные с входящими и исходящими звонками, переадресацией и звонками из гостевого региона.
Единый Envelope используется для всех событий: один channel соответствует одному event_type.
Содержание
Также см.:
«Каталог событий MCN Telecom — Виртуальная АТС (Звонки ВАТС, Переадресация и внутренние номера)»;
«Каталог событий MCN Telecom — Виртуальная АТС (Очереди, Другие события ВАТС)»;
«Каталог событий MCN Telecom — Работа с речью»;
«Каталог событий MCN Telecom — Авторизация по звонку»;
«Каталог событий MCN Telecom — Автозвонки 2.0»;
«Каталог событий MCN Telecom — Адресная книга»;
«Каталог событий MCN Telecom — Голосовой робот»;
«Каталог событий MCN Telecom — ИИ-агент»;
«Каталог событий MCN Telecom — Контакт-центр»;
«Каталог событий MCN Telecom — Коллтрекинг»;
«Каталог событий MCN Telecom — Работа с речью»;
«Каталог событий MCN Telecom — Чат-боты»;
«Каталог событий MCN Telecom — SMS»;
«Каталог событий 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.
Входящие звонки
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"
}
}
InboundCallEnd - Завершение входящего звонка
Завершение входящего звонка
Событие: Конец входящего звонка телефонии
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 связанного звонка |
answered | string | ✓ | Был ли отвечен звонок: 0 или 1 |
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": "InboundCallEnd",
"created_at": "2026-07-01T20:25:11.241Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"userEventType": "InboundCallEnd",
"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": "hangup-signal-did-inbound-call-finished",
"callerID": "79000000014",
"event": "InboundCallEnd",
"objectId": "559985",
"timestamp": 1782926711,
"callId": "207-1782926711.179818",
"linkedId": "207-1782926711.179818",
"answered": "0",
"callerNumber": "79000000014",
"dateReceivedAtUTC": "2026-07-01 17:25:11.061776",
"eventType": "InboundCallEnd",
"priority": 3,
"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
}
}
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"
}
}
OutgoingEnd - Завершение исходящего звонка телефонии
Событие: Завершение звонка телефонии
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) |
hangupCauseCode | string | ✓ | Код завершения звонка |
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 связанного звонка |
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": "OutgoingEnd",
"created_at": "2026-07-01T13:15:55.304Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"connectedLineNum": "79000000021",
"userEventType": "OutgoingEnd",
"channel": "SIP/sip-node1-00009a8f",
"privilege": "user,all",
"exten": "s",
"channelState": 0,
"hangupCauseCode": "21",
"callerIdNum": "79000000022",
"systemName": "206",
"dateReceived": "Jul 1, 2026, 10:15:55 AM",
"record": "0",
"context": "signal-outgoing-hangup-handler",
"event": "OutgoingEnd",
"calledNumber": "79000000022",
"timestamp": 1782900955,
"callId": "206-1782900948.347401",
"linkedId": "206-1782900948.347401",
"answered": "0",
"callerNumber": null,
"connectedLineName": "79000000021",
"dateReceivedAtUTC": "2026-07-01 10:15:55.150667",
"eventType": "OutgoingEnd",
"priority": 18,
"accountId": 10001,
"channelStateDesc": "Down",
"did": "79000000021",
"uniqueId": "206-1782900948.347404"
}
}
Переадресация
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"
}
}
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"
}
}
Гостевой регион
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",
}
}