GetInfo

Метод GetInfo

Примените метод GetInfo для получения информации о звонке по его идентификатору.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/statistics/call-history/v2/GetInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, выделенные жирным шрифтом, обязательны.

ПараметрТипОписание
call_iduint64уникальные идентификаторы звонков

Выходные параметры

ПараметрТипОписание
call_iduint64идентификатор звонка
servicestring ServiceTypeуслуга, в рамках которой совершён звонок
application_uuidstringидентификатор приложения, с/на номер которого совершён звонок
start_timetimestampдата и время начала звонка UTC
end_timetimestampдата и время окончания звонка UTC
fromstringномер-инициатор звонка
tostringномер принимающего абонента
statusstringобщий статус звонка: UNSPECIFIED — не определён, ANSWERED — ответ, BUSY — занят, NO_ANSWER — нет ответа, CANCELED — отменен, REJECTED — вызов сброшен/отклонён, ERROR — ошибка
directionstringнаправление звонка: UNSPECIFIED — не определён, OUTBOUND — исходящий, INBOUND — входящий
durationuint32полная длительность звонка в сек от момента инициации до завершения
redirect_typestringтип переадресации, только для услуг REDIRECT, SIP_REDIRECT, IPCR. 1 — одиночная, 2 — последовательная, 3 — параллельная
black_listbooleanпризнак наличия номера звонящего в чёрном списке, только для услуг REDIRECT, SIP_REDIRECT, IPCR. True — номер в чёрном списке. False — номера нет в чёрном списке
reservebooleanпризнак переадресации на резервный номер, только для услуг REDIRECT, SIP_REDIRECT, IPCR. True — звонок переадресован на резервный номер. False — звонок не переадресован на резервный номер
legsструктура Legsинформация о ходе звонка на каждом плече
record_callbooleanпризнак, показывающий, подключена ли услуга записи разговора на номере. True — услуга подключена. False — услуга не подключена
voice_record_existbooleanпризнак готовности записи разговора. True — запись разговора готова для прослушивания и скачивания. False — запись разговора не готова для прослушивания и скачивания
transcribebooleanпризнак, показывающий, подключена ли услуга текстовой расшифровки аудиозаписи разговора на номере. True — услуга подключена. False — услуга не подключена
transcribations_record_existbooleanпризнак готовности текстовой расшифровки аудиозаписи разговора. True — расшифровка готова для скачивания. False — расшифровка не готова для скачивания
speech_analyticsbooleanпризнак, показывающий, подключена ли услуга речевой аналитики разговора на номере. True — услуга подключена. False — услуга не подключена
speech_analytics_existbooleanпризнак готовности результатов речевой аналитики разговора. True — речевая аналитика готова. False — речевая не аналитика готова
detectionbooleanпризнак, показывающий, подключена ли услуга детектирования автоответчика на номере. True — услуга подключена. False — услуга не подключена
voice_detection_existbooleanпризнак разрыва соединения по причине обнаруженного автоответчика. True — звонок завершён из-за обнаруженного автоответчика. False — автоответчик не обнаружен

ServiceType

ПараметрЗначение
unspecifiedуслуга не определена
ipcr_redirectуслуга динамической переадресации по API
voice_messageуслуга голосового SMS
redirectуслуга переадресации входящего звонка на номер
sipисходящий вызов через SIP
sip_redirectуслуга переадресации входящего звонка на SIP
static_redirectуслуга переадресации входящего звонка на SIP
carouselуслуга карусели

Legs

ПараметрТипОписание
start_timetimestampдата и время начала звонка UTC
end_timetimestampдата и время окончания звонка UTC
fromstringномер-инициатор звонка
tostringномер принимающего абонента
statusstringстатус вызова данного плеча
setup_timeuint32время установки соединения в сек
wait_timeuint32время ожидания соединения в сек, совпадает с setup_time
talk_timeuint32длительность разговора в сек
durationuint32общая длительность в сек по данному плечу с учётом гудков, ожидания, разговора
cause_codeuint32код причины отбоя

Коды причин отбоя

КодСтатусОписание
1rejectedUNALLOCATED_NUMBERвызов отменён — номер получателя не найден, формат верный
2rejectedNO_ROUTE_TRANSIT_NETвызов отменён — нет маршрута к указанной транзитной сети
3rejectedNO_ROUTE_DESTINATIONвызов отменён — нет маршрута до указанного номера
21rejectedCALL_REJECTEDвызов отклонён
17busyUSER_BUSYвызываемый номер занят
18no_answerNO_USER_RESPONSEнет ответа
19no_answerNO_ANSWERнет сигнализации от пользователя, нет ответа
20no_answerSUBSCRIBER_ABSENTнет ответа
41no_answerNORMAL_TEMPORARY_FAILUREвременная неработоспособность
502no_answerLOSE_RACEнет ответа
487canceledORIGINATOR_CANCELвызов отменён звонящим
16answeredNORMAL_CLEARINGнормальное завершение вызова
604answeredMEDIA_TIMEOUTнормальное завершение вызова

Примеры

Входные параметры:

{
   "call_id": [
       7013203421000674336
   ]
}

Выходные параметры:

{
   "call_id": "7116111127119111116",
   "service": "ipcr_redirect",
   "application_uuid": "1111e1cd-1d48-1ada-bbbf-1111110bd1c6",
   "start_time": "2025-01-01T07:22:19.066Z",
   "end_time": "2025-01-01T07:22:50.150Z",
   "from": "79111111118",
   "to": "79801111111",
   "status": "answered",
   "direction": "inbound",
   "duration": 31,
   "redirect_type": "1",
   "black_list": false,
   "legs": [
       {
           "start_time": "2025-01-01T07:22:27.503Z",
           "end_time": "2025-01-01T07:22:50.150Z",
           "from": "79801111111",
           "to": "79101110112",
           "status": "answered",
           "setup_time": 20,
           "wait_time": 20,
           "talk_time": 11,
           "duration": 31,
           "cause_code": 16
       }
   ],
   "record_call": true,
   "voice_record_exist": true,
   "transcribe": false,
   "transcribations_record_exist": false,
   "speech_analytics": true,
   "speech_analytics_exist": true,
   "detection": false,	
   "voice_detection_exist": false
}

Возможные ошибки

КодСтатусПример сообщенияОписание
400Bad Requestinvalid uuid formatнеправильный формат в параметре запроса
400Bad Requestinvalid valueзначения параметра невалидно
401Unauthorizedmalformed tokenне указан / неправильно указан API-ключ приложения