Inbound Call Events (URL, номер, SIP ID) | Statistics API

При поступлении входящих звонков, переадресованных на другие номера или SIP ID, можно получать автоматические уведомления на URL-адрес вашего сервера. Для этого укажите его в настройках приложения в Личном кабинете.

Параметры уведомлений при входящих звонках

Begin

Соединение с вызывающим абонентом (с которого поступил вызов).

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: b
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер Exolve, на который поступил входящий вызов и на котором настроена переадресация вызовов
redirect_type	enum	тип переадресации, значения: `1` — одиночная, `2` — последовательная, `3` — параллельная
black_list	boolean	`True` — номер вызова находится в чёрном списке (вызов сбросится), `false` — номер вызова не в чёрном списке (вызов продолжится)
client_id	string	сквозной идентификатор от API клиента (это необязательное поле передается, если значение было передано клиентом в запросе)
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя

Пример

{
    "service": "redirect",
    "type": "b",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "black_list": false,
    "date_time": "2025-11-30T08:35:34.644585Z",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455"
}

Originate

Инициация вызова на номер переадресации.

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `o`
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер B-абонента (на который настроена переадресация вызова)
redirect_type	enum	тип переадресации, значения: 1 — одиночная, 2 — последовательная, 3 — параллельная
reserve	boolean	признак переадресации на резервный номер. `True` — вызов отправлен на резервный номер. `False` — вызов не отправлялся на резервный номер
record_call	boolean	признак записи разговора. `True` — разговор записывается. `False` — разговор не записывается
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя
client_id	string	сквозной идентификатор от вашего API (необязательное поле, передается если значение было передано в запросе)

Пример

{
    "service": "redirect",
    "type": "o",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "reserve": false,
    "date_time": "2025-11-30T08:35:34.644585Z",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455",
    "record_call": true
}

Start

Фактический ответ стороны B — номера переадресации.

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер B-абонента (на который настроена переадресация вызова)
type	string	тип уведомления, значение: `s`
reserve	boolean	признак переадресации на резервный номер. `True` — вызов отправлен на резервный номер. `False` — вызов не отправлялся на резервный номер
redirect_type	enum	тип переадресации, значения: `1` — одиночная, `2` - последовательная, `3` — параллельная
record_call	boolean	признак записи разговора. `True` — разговор записывается. `False` — разговор не записывается
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя
client_id	string	сквозной идентификатор от API клиента (необязательное поле, передается если значение было передано клиентом в запросе)

Пример

{
    "service": "redirect",
    "type": "s",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "reserve": false,
    "date_time": "2025-11-30T08:35:34.644585Z",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455",
    "record_call": true
}

Hungup

Разъединение/окончание вызова.

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `h`
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер B-абонента (на который настроена переадресация вызова)
reserve	boolean	признак переадресации на резервный номер. `True` — вызов был отправлен на резервный номер. `False` — вызов не отправлялся на резервный номер
redirect_type	enum	тип переадресации, значения: `1` – одиночная, `2` — последовательная, `3` — параллельная
record_call	boolean	признак записи разговора. `True` — разговор записывается. `False` — разговор не записывается
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя
client_id	string	сквозной идентификатор от API клиента (необязательное поле, передается если значение было передано клиентом в запросе)

Пример

{
    "service": "redirect",
    "type": "h",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "reserve": false,
    "date_time": "2025-11-30T08:35:34.644585Z",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455",
    "record_call": true
}

Definition

redirect_number Окончание вызова с причинами разъединения каждого номера переадресации (при последовательной или параллельной переадресации).

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `d`
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер B-абонента (на который настроена переадресация вызова)
redirect_type	enum	тип переадресации, значения: `1` — одиночная, `2` — последовательная, `3` — параллельная
reserve	boolean	признак переадресации на резервный номер. `True` — вызов отправлен на резервный номер. `False` — вызов не отправлялся на резервный номер
wait_time	uint32	время ожидания A-абонента до фактического соединения с B-абонентом (ответ на звонок) в миллисекундах
duration	uint32	полное время вызова в миллисекундах (с учётом ожидания, проигрывания аудиосообщений и времени фактического разговора абонентов)
talk_time	uint32	время фактического разговора абонентов в миллисекундах
record_call	boolean	признак записи разговора. `True` — разговор записывается. `False` — разговор не записывается
transcribe	boolean	признак транскрибации разговора. `True` — вызов расшифровывается в текст. `False` — вызов не расшифровывается в текст
speech_analytics	boolean	признак речевой аналитики разговора. `True` — вызов анализируется. `False` — вызов не анализируется
cause_code	string	код причины разъединения звонка (Q.850)
disconnect_side	string	признак разрыва вызова детектированием автоответчиков. В этом случае значение: `amd`. Если вызов не разорван, параметр не передается (применимо только при подключенной услуге «Детектирование автоинформаторов»)
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя
client_id	string	сквозной идентификатор от API клиента (это необязательное поле передается, если значение было передано клиентом в запросе)

Пример

{
    "service": "redirect",
    "type": "d",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "reserve": false,
    "date_time": "2023-11-30T08:35:34.644585Z",
    "cause_code": "16",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455",
    "record_call": true,
    "wait_time": 17943,
    "duration": 25740,
    "talk_time": 7797,
    "transcribe": false,
    "speech_analytics": false
}

End

Окончание вызова.

Параметр	Тип	Описание
call_id	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова. В онлайн-уведомлениях типа crr, ctr, sar называется `uid`
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `e`
service	string	сервис для отправки уведомления
date_time	string	дата события в формате RFC-3339 / ISO-8601
from	string	номер A-абонента (с которого поступил вызов)
to	string	номер B-абонента (на который настроена переадресация вызова), отсутствует в уведомлении типа `e` при `redirect_type` = `2` или `3`
redirect_type	enum	тип переадресации, значения: `1` — одиночная, `2` — последовательная, `3` — параллельная
client_id	string	сквозной идентификатор от вашего API (необязательное поле, передается, если значение было передано в запросе)
reserve	boolean	признак переадресации на резервный номер. `True` — вызов отправлен на резервный номер. `False` — вызов не отправлялся на резервный номер
record_call	boolean	признак записи разговора. `True` — разговор записывается. `False` — разговор не записывается
application_uuid	string	идентификатор приложения, через которое проходит вызов
customer_id	uint64	идентификатор пользователя

Пример

{
    "service": "redirect",
    "type": "e",
    "redirect_type": 1,
    "call_sid": "call-test-12345",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "customer_id": 1111,
    "reserve": false,
    "date_time": "2025-11-30T08:35:34.644585Z",
    "call_id": 12345678910,
    "from": "79991112233",
    "to": "79991114455",
    "record_call": true
}

Call record ready

Готова запись разговора.

Параметр	Тип	Описание
uid	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `crr`
called_number	string	номер Exolve, на которой позвонили
calling_number	string	номер Exolve, с которого совершён вызов на номер переадресации
number_a	string	номер A-абонента (с которого поступил вызов)
call_sid	string	идентификатор вызова
date_time	string	дата события в формате RFC-3339 / ISO-8601
path	string	ссылка на скачивания файла с записью звонка
service	string	сервис для отправки уведомления
expires_at	string	дата, до которой будет храниться запись RFC-3339 / ISO-8601
size	uint64	размер файла с записью (кб)
record_duration	uint64	длительность записи в секундах
customer_id	uint64	идентификатор пользователя
application_uuid	string	идентификатор приложения, через которое проходит вызов
client_id	string	сквозной идентификатор от вашего API (это необязательное поле передается, если значение было передано в запросе)

Пример

{
    "uid": 7135909209505402880,
    "client_id": "777",
    "number_a": "79991112233",
    "call_sid": "call-test-12345",
    "type": "crr",
    "application_uuid": "c9c5031b-ad9b-4453-b6f8-bd1b14455791",
    "date_time": "2023-11-30T08:35:34.644585Z",
    "path": "https://api.exolve.ru/statistics/download/7135909209505402880",
    "service": "ipcr",
    "called_number": "74991112233",
    "calling_number": "74991112233",
    "expires_at": "2023-12-30T00:00:00Z",
    "customer_id": 1111,
    "size": 695084,
    "record_duration": 21
    }

Call transcribation ready

Готова транскрибация разговора.

Параметр	Тип	Описание
uid	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова
call_sid	string	идентификатор вызова
transcribation	string	`ready` — признак готовности текстовой расшифровки звонка
type	string	тип уведомления, значение: `trc`

Пример

{
    "type": "trc",
    "uid": 7135909209505402880,                    
    "transcribation": "ready"            
}

Speech analytics ready

Готов результат речевой аналитики разговора.

Параметр	Тип	Описание
uid	uint64	идентификатор вызова, одинаковый во всех событиях и запросах в рамках одного вызова
call_sid	string	идентификатор вызова
type	string	тип уведомления, значение: `sar`
speech_analytics	string	`ready` — признак готовности речевой аналитики звонка

Пример

{
    "type": "sar",
    "uid": 7135909209505402880,                    
    "speech_analytics": "ready"            
}