Каталог событий MCN Telecom — Телефония

8 просмотра

Создано 17.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.

Входящие звонки

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",
  }
}

На главную

Каталог событий MCN Telecom — Телефония

Телефония

Содержание

Общий формат события

Входящие звонки

Начало входящего звонка

Envelope

`data`

Завершение входящего звонка

Envelope

`data`

Исходящие звонки

Envelope

`data`

Envelope

`data`

Envelope

`data`

Переадресация

Envelope

`data`

Envelope

`data`

Гостевой регион

Envelope

`data`

Была ли эта статья полезной