Журналы вызовов CDR

Во вкладке Журналы вызовов CDR содержится детализированный отчет обо всех совершенных вызовах, проведенных в активном домене.

Для перехода во вкладку: раздел CDR → вкладка Журналы вызовов CDR

Как читать журнал CDR

CDR (Call Detail Record) — запись с техническими сведениями о прохождении вызова: участниках, маршрутизации, состоянии, времени обработки, медиапотоке и причине завершения.

В сложных сценариях один пользовательский вызов может быть представлен несколькими CDR-записями. Например, при обратном вызове отдельно регистрируются обращение к сервису и созданные сервисом соединения. Связанные плечи перевода, переадресации или конференции можно сопоставить по значению Conf ID.

В описании полей используются следующие обозначения:

сторона А, или оригинатор, — сторона, инициировавшая соединение
сторона Б, или терминатор, — сторона, к которой устанавливается соединение
входящий А номер и входящий Б номер — номера, полученные системой до преобразований маршрута
номер А и номер терминатора — номера, используемые после обработки маршрутизацией. Они могут совпадать с входящими номерами, если преобразование не выполнялось

Нулевой UUID 00000000-0000-0000-0000-000000000000 означает, что объект не определен. Дата 01-01-1970 означает, что время события не определено. Отображаемое время зависит от часового пояса. Эти значения не следует считать фактическим идентификатором или временем события

Возможности журнала вызовов CDR:

просмотр детальной информации по каждому вызову
фильтрация по полям CDR
генерация и выгрузка отчетов в формате .csv
настройка отображаемых полей
прослушивание и скачивание записей разговоров

Просмотр информации о совершенном вызове

Для отображения подробной информации по совершенному вызову необходимо в строке выбранного вызова нажать кнопку Кнопка Раскрыть

Описание полей CDR

Состав полей зависит от сценария вызова. Поля, которые не относятся к вызову или событие для которых не наступило, могут быть пустыми.

Названия и порядок полей в первом столбце соответствуют списку настройки столбцов в веб-интерфейсе IVA CS. JSON-поля используются в API и выгружаемых данных.

Параметры CDR

Поле в интерфейсе JSON-поле Описание

Поле в интерфейсе	JSON-поле	Описание
URI вызывающего терминала	`proxy_uri`	Адрес источника запроса на вызов в формате `IP-адрес:порт`. Несмотря на название поля, значение может не содержать схему URI
Conf ID	`conf_id`	Идентификатор общего соединения, по которому можно сопоставить CDR-записи связанных плеч вызова
Входящий А номер	`a_leg_src_number`	Исходный номер стороны А, полученный системой до преобразования маршрутом
Входящий Б номер	`b_leg_src_number`	Исходный вызываемый номер, полученный системой до преобразования маршрутом
Код завершения	`call_code`	Код завершения вызова в формате кода ответа SIP
Расшифровка	`call_code_descr`	Текстовое описание значения поля Код завершения
Причина завершения звонка	`ended_by`	Внутренняя причина прекращения соединения. Значение формируется системой в виде произвольного технического текста
Длительность	`duration`	Продолжительность разговора в секундах: от ответа стороны Б до завершения соединения
Запись	`file_id`	Идентификатор файла записи разговора, связанного с CDR. Если запись доступна, в столбце отображаются действия для ее прослушивания и выгрузки
Создано	`created`	Дата и время создания CDR-записи при начале обработки вызова
ID	`id`	Идентификатор CDR-записи в базе данных
IVR	`ivr`	Устаревший технический признак участия IVR. Для определения IVR следует использовать поле IVR ID
IVR ID	`ivr_id`	ID IVR, который был источником или целью соединения. Если вызов не относится к IVR, поле не заполняется
ID оригинатора	`a_leg_id`	Внутренний ID плеча А. Это не ID абонента, шлюза или терминала
Хост оригинатора	`a_leg_src_hostname`	Имя хоста, с которого поступил вызов стороны А
Номер А	`a_leg_number`	Фактический номер стороны А после обработки маршрутизацией. Может совпадать с полем Входящий А номер
ID домена оригинатора	`a_leg_domain_id`	ID домена стороны А
Имя домена оригинатора	`a_leg_domain_name`	Название домена стороны А
ID терминала оригинатора	`a_leg_endpoint_id`	ID терминала, связанного со стороной А
ID терминатора	`b_leg_id`	Внутренний ID плеча Б. Это не ID абонента, шлюза или терминала
Родительский ID терминатора	`b_leg_parent_id`	ID родительского плеча Б, от которого создано текущее плечо
Хост терминатора	`b_leg_src_hostname`	Исходное имя хоста целевой стороны до обработки маршрутизацией
Номер терминатора	`b_leg_number`	Фактический номер стороны Б после обработки маршрутизацией. Может совпадать с полем Входящий Б номер
Имя терминатора	`b_leg_username`	Имя пользователя из привязки терминала стороны Б. Если привязка отсутствует, может содержать вызываемый номер
Имя хоста терминатора	`b_leg_hostname`	Имя хоста или домен из привязки терминала стороны Б
Порт терминатора	`b_leg_port`	Порт из привязки терминала стороны Б
SIP URI терминатора	`b_leg_sip_connect`	SIP URI, по которому система устанавливала соединение со стороной Б
ID домена терминатора	`b_leg_domain_id`	ID домена стороны Б
Имя домена терминатора	`b_leg_domain_name`	Название домена стороны Б
ID терминала терминатора	`b_leg_endpoint_id`	ID терминала, связанного со стороной Б
Преобразование маршрута терминатора	`b_leg_route_transform`	Регулярное выражение преобразования номера или хоста стороны Б, заданное в параметре `TransformB` сработавшего маршрута
Тип переадресации	`b_leg_redirect_type`	Тип переадресации, сработавшей при маршрутизации вызова к стороне Б
SDP	`sdp`	SDP-описание медиасессии, полученное системой от инициатора вызова
Медиа маршрут	`media_route`	Способ передачи медиапотока: `TRX` — через медиасервер; `P2P` — напрямую между сторонами
ID звонка	`call_id`	ID внутренней модели звонка IVA CS, связанной с CDR. Это не значение SIP-заголовка `Call-ID`
Состояние звонка	`call_state`	Числовое представление последнего состояния вызова, зафиксированного в CDR
Описание состояния звонка	`call_state_descr`	Строковое состояние вызова: например, `NEW`, `RINGING`, `ACTIVE`, `HANGUP`, `CANCEL`, `TIMEOUT`, `FAILED`, `HOLD`, `PROGRESS`, `REDIRECT`, `RTP_TIMEOUT` или `SOFT_RESET`
Код Q.931	`q931_code`	Числовой код причины разъединения по протоколу Q.931
Код Q.931. Причина разъединения	`q931_cause`	Текстовое описание причины разъединения, соответствующее коду Q.931
Аудио кодек	`call_codec_audio`	Список аудиокодеков, полученный от компонента обработки вызовов. Несколько значений разделяются запятыми
Видео кодек	`call_codec_video`	Список видеокодеков, полученный от компонента обработки вызовов. Несколько значений разделяются запятыми
Шифрование медиа(enum)	`call_media_encryption`	Числовое значение типа шифрования медиапотока
Шифрование медиа(строка)	`call_media_encryption_descr`	Строковое значение типа шифрования: `MediaEncryption_UNKNOWN`, `SRTP` или `DTLS_SRTP`
ID факса	`fax_id`	ID факсимильного сообщения, если CDR относится к отправке или приему факса
record_file_ids	`record_file_ids`	Вычисляемый массив ID файлов записи разговора, связанных с CDR. Название поля в интерфейсе не локализовано
callback_task_id	`callback_task_id`	UUID задания сервиса Обратный вызов, связанного с CDR-записью. Соответствует параметру `id` операции ServiceCallbackTask
Звонок	`ring_at`	Дата и время перехода вызова в состояние `RINGING`
Ответ	`pickup_at`	Дата и время ответа стороны Б, соответствующее переходу вызова в состояние `ACTIVE`
Завершен	`hangup_at`	Дата и время завершения вызова. Значение также может устанавливаться при `RTP_TIMEOUT` или завершении плеча
Принудительно завершен	`terminate_at`	Устаревшее техническое поле времени завершения, обычно аналогичное полю Завершен. Может быть пустым
Таймаут	`timeout_at`	Дата и время перехода вызова в состояние `TIMEOUT`
Ошибка	`fail_at`	Дата и время перехода вызова в состояние `FAILED`, `RTP_TIMEOUT` или `SOFT_RESET`
Прогресс	`progress_at`	Дата и время перехода вызова в состояние `PROGRESS`
ID маршрута	`route_id`	ID маршрута, выбранного системой при обработке вызова
Сущность маршрута	`route_entity`	Техническое имя сущности, к которой относится действие маршрута, например `file_audio`
Способ терминации	`route_action`	Техническое имя действия, выполненного маршрутом, например `play`
Имя маршрута	`route_name`	Название сработавшего маршрута
IP-адрес назначения	`destination_ip`	IP-адрес и порт целевой стороны соединения
Направление вызова	`direction`	Направление трафика: Внутренний, Входящий, Исходящий, Транзитный, Междоменный или Другой. Правила определения приведены ниже
Тип терминала оригинатора	`a_leg_ep_type`	Тип оконечной точки стороны А: Абонент или Шлюз
ID абонента/шлюза оригинатора	`a_leg_ep_id`	ID абонента или шлюза стороны А
Имя терминала оригинатора	`a_leg_ep_name`	Название абонента или шлюза стороны А
ID пользователя оригинатора	`a_leg_account_id`	ID пользователя, связанного с абонентом стороны А. Для шлюза не заполняется
ФИО пользователя оригинатора	`a_leg_account_fio`	ФИО пользователя, связанного с абонентом стороны А. Для шлюза не заполняется
Тип терминала терминатора	`b_leg_ep_type`	Тип оконечной точки стороны Б: Абонент или Шлюз
ID абонента/шлюза терминатора	`b_leg_ep_id`	ID абонента или шлюза стороны Б
Имя терминала терминатора	`b_leg_ep_name`	Название абонента или шлюза стороны Б
ID пользователя терминатора	`b_leg_account_id`	ID пользователя, связанного с абонентом стороны Б. Для шлюза не заполняется
ФИО пользователя терминатора	`b_leg_account_fio`	ФИО пользователя, связанного с абонентом стороны Б. Для шлюза не заполняется
Преобразование маршрута оригинатора	`a_leg_route_transform`	Регулярное выражение преобразования номера или хоста стороны А, заданное в параметре `TransformA` сработавшего маршрута
Обновлено	`updated`	Дата и время последнего обновления CDR-записи во время обработки вызова. После завершения вызова запись больше не изменяется

URI вызывающего терминала

proxy_uri

Адрес источника запроса на вызов в формате IP-адрес:порт. Несмотря на название поля, значение может не содержать схему URI

Conf ID

conf_id

Идентификатор общего соединения, по которому можно сопоставить CDR-записи связанных плеч вызова

Входящий А номер

a_leg_src_number

Исходный номер стороны А, полученный системой до преобразования маршрутом

Входящий Б номер

b_leg_src_number

Исходный вызываемый номер, полученный системой до преобразования маршрутом

Код завершения

call_code

Код завершения вызова в формате кода ответа SIP

Расшифровка

call_code_descr

Текстовое описание значения поля Код завершения

Причина завершения звонка

ended_by

Внутренняя причина прекращения соединения. Значение формируется системой в виде произвольного технического текста

Длительность

duration

Продолжительность разговора в секундах: от ответа стороны Б до завершения соединения

Запись

file_id

Идентификатор файла записи разговора, связанного с CDR. Если запись доступна, в столбце отображаются действия для ее прослушивания и выгрузки

Создано

created

Дата и время создания CDR-записи при начале обработки вызова

id

Идентификатор CDR-записи в базе данных

IVR

ivr

Устаревший технический признак участия IVR. Для определения IVR следует использовать поле IVR ID

IVR ID

ivr_id

ID IVR, который был источником или целью соединения. Если вызов не относится к IVR, поле не заполняется

ID оригинатора

a_leg_id

Внутренний ID плеча А. Это не ID абонента, шлюза или терминала

Хост оригинатора

a_leg_src_hostname

Имя хоста, с которого поступил вызов стороны А

Номер А

a_leg_number

Фактический номер стороны А после обработки маршрутизацией. Может совпадать с полем Входящий А номер

ID домена оригинатора

a_leg_domain_id

ID домена стороны А

Имя домена оригинатора

a_leg_domain_name

Название домена стороны А

ID терминала оригинатора

a_leg_endpoint_id

ID терминала, связанного со стороной А

ID терминатора

b_leg_id

Внутренний ID плеча Б. Это не ID абонента, шлюза или терминала

Родительский ID терминатора

b_leg_parent_id

ID родительского плеча Б, от которого создано текущее плечо

Хост терминатора

b_leg_src_hostname

Исходное имя хоста целевой стороны до обработки маршрутизацией

Номер терминатора

b_leg_number

Фактический номер стороны Б после обработки маршрутизацией. Может совпадать с полем Входящий Б номер

Имя терминатора

b_leg_username

Имя пользователя из привязки терминала стороны Б. Если привязка отсутствует, может содержать вызываемый номер

Имя хоста терминатора

b_leg_hostname

Имя хоста или домен из привязки терминала стороны Б

Порт терминатора

b_leg_port

Порт из привязки терминала стороны Б

SIP URI терминатора

b_leg_sip_connect

SIP URI, по которому система устанавливала соединение со стороной Б

ID домена терминатора

b_leg_domain_id

ID домена стороны Б

Имя домена терминатора

b_leg_domain_name

Название домена стороны Б

ID терминала терминатора

b_leg_endpoint_id

ID терминала, связанного со стороной Б

Преобразование маршрута терминатора

b_leg_route_transform

Регулярное выражение преобразования номера или хоста стороны Б, заданное в параметре TransformB сработавшего маршрута

Тип переадресации

b_leg_redirect_type

Тип переадресации, сработавшей при маршрутизации вызова к стороне Б

SDP

sdp

SDP-описание медиасессии, полученное системой от инициатора вызова

Медиа маршрут

media_route

Способ передачи медиапотока: TRX — через медиасервер; P2P — напрямую между сторонами

ID звонка

call_id

ID внутренней модели звонка IVA CS, связанной с CDR. Это не значение SIP-заголовка Call-ID

Состояние звонка

call_state

Числовое представление последнего состояния вызова, зафиксированного в CDR

Описание состояния звонка

call_state_descr

Строковое состояние вызова: например, NEW, RINGING, ACTIVE, HANGUP, CANCEL, TIMEOUT, FAILED, HOLD, PROGRESS, REDIRECT, RTP_TIMEOUT или SOFT_RESET

Код Q.931

q931_code

Числовой код причины разъединения по протоколу Q.931

Код Q.931. Причина разъединения

q931_cause

Текстовое описание причины разъединения, соответствующее коду Q.931

Аудио кодек

call_codec_audio

Список аудиокодеков, полученный от компонента обработки вызовов. Несколько значений разделяются запятыми

Видео кодек

call_codec_video

Список видеокодеков, полученный от компонента обработки вызовов. Несколько значений разделяются запятыми

Шифрование медиа(enum)

call_media_encryption

Числовое значение типа шифрования медиапотока

Шифрование медиа(строка)

call_media_encryption_descr

Строковое значение типа шифрования: MediaEncryption_UNKNOWN, SRTP или DTLS_SRTP

ID факса

fax_id

ID факсимильного сообщения, если CDR относится к отправке или приему факса

record_file_ids

record_file_ids

Вычисляемый массив ID файлов записи разговора, связанных с CDR. Название поля в интерфейсе не локализовано

callback_task_id

callback_task_id

UUID задания сервиса Обратный вызов, связанного с CDR-записью. Соответствует параметру id операции ServiceCallbackTask

Звонок

ring_at

Дата и время перехода вызова в состояние RINGING

Ответ

pickup_at

Дата и время ответа стороны Б, соответствующее переходу вызова в состояние ACTIVE

Завершен

hangup_at

Дата и время завершения вызова. Значение также может устанавливаться при RTP_TIMEOUT или завершении плеча

Принудительно завершен

terminate_at

Устаревшее техническое поле времени завершения, обычно аналогичное полю Завершен. Может быть пустым

Таймаут

timeout_at

Дата и время перехода вызова в состояние TIMEOUT

Ошибка

fail_at

Дата и время перехода вызова в состояние FAILED, RTP_TIMEOUT или SOFT_RESET

Прогресс

progress_at

Дата и время перехода вызова в состояние PROGRESS

ID маршрута

route_id

ID маршрута, выбранного системой при обработке вызова

Сущность маршрута

route_entity

Техническое имя сущности, к которой относится действие маршрута, например file_audio

Способ терминации

route_action

Техническое имя действия, выполненного маршрутом, например play

Имя маршрута

route_name

Название сработавшего маршрута

IP-адрес назначения

destination_ip

IP-адрес и порт целевой стороны соединения

Направление вызова

direction

Направление трафика: Внутренний, Входящий, Исходящий, Транзитный, Междоменный или Другой. Правила определения приведены ниже

Тип терминала оригинатора

a_leg_ep_type

Тип оконечной точки стороны А: Абонент или Шлюз

ID абонента/шлюза оригинатора

a_leg_ep_id

ID абонента или шлюза стороны А

Имя терминала оригинатора

a_leg_ep_name

Название абонента или шлюза стороны А

ID пользователя оригинатора

a_leg_account_id

ID пользователя, связанного с абонентом стороны А. Для шлюза не заполняется

ФИО пользователя оригинатора

a_leg_account_fio

ФИО пользователя, связанного с абонентом стороны А. Для шлюза не заполняется

Тип терминала терминатора

b_leg_ep_type

Тип оконечной точки стороны Б: Абонент или Шлюз

ID абонента/шлюза терминатора

b_leg_ep_id

ID абонента или шлюза стороны Б

Имя терминала терминатора

b_leg_ep_name

Название абонента или шлюза стороны Б

ID пользователя терминатора

b_leg_account_id

ID пользователя, связанного с абонентом стороны Б. Для шлюза не заполняется

ФИО пользователя терминатора

b_leg_account_fio

ФИО пользователя, связанного с абонентом стороны Б. Для шлюза не заполняется

Преобразование маршрута оригинатора

a_leg_route_transform

Регулярное выражение преобразования номера или хоста стороны А, заданное в параметре TransformA сработавшего маршрута

Обновлено

updated

Дата и время последнего обновления CDR-записи во время обработки вызова. После завершения вызова запись больше не изменяется

Определение направления вызова

Сторона А / сторона Б	Абонент того же домена	Абонент другого домена	Шлюз	IVR, факс или конференция
Абонент	Внутренний	Междоменный	Исходящий	Другой
Шлюз	Входящий	Входящий	Транзитный	Другой

Сторона А / сторона Б

Абонент того же домена

Абонент другого домена

Шлюз

IVR, факс или конференция

Абонент

Внутренний

Междоменный

Исходящий

Другой

Шлюз

Входящий

Транзитный

Другой

Действия с записью разговора

Если вызов был записан автоматически или с помощью DTMF-действия Сделать запись, в столбце Запись отображаются действия для прослушивания и выгрузки файла.

Возможные действия с аудиозаписью:

Выгрузить аудиозапись на локальное устройство: Нажать кнопку

Файл выгружается в формате .webm
Прослушать аудиозапись: Нажать кнопку

Прослушать аудиозапись в отдельном окне: Нажать кнопку Прослушать в отдельном окне → Прослушивание голосового сообщения

Элементы панели управления

Кнопка	Действие
	Начать воспроизведение
	Пауза
	Звук включен / выключить звук
	Звук выключен / включить звук
	Дополнительные функции: — выгрузить файл на локальное устройство — выбрать скорость воспроизведения (0.25х, 0.5х, 0.75х, 1х, 1.25х, 1.5х, 1.75х, 2х)

Кнопка

Действие

Прослушать

Начать воспроизведение

Пауза

Звук включен

Звук включен / выключить звук

Звук выключен

Звук выключен / включить звук

Настройки

Дополнительные функции:

— выгрузить файл на локальное устройство
— выбрать скорость воспроизведения (0.25х, 0.5х, 0.75х, 1х, 1.25х, 1.5х, 1.75х, 2х)

Выгрузка CDR-записей на локальное устройство

Для выгрузки списка CDR-записей на локальное устройство необходимо:

раздел CDR → вкладка Журналы вызовов CDR
нажать кнопку Скачать CDR → окно Сгенерировать файл
указать параметры выгрузки:
- Дата начала / Время начала и Дата окончания / Время окончания: установить период, за который нужны записи
- поле Пользователь: выбрать пользователя, для которого необходимо выгрузить CDR-записи
- поле Абонент: выбрать абонента, для которого необходимо выгрузить CDR-записи
нажать кнопку Отправить. Появится информационное сообщение о начале генерации файла CDR

Сгенерированный файл со списком CDR-записей можно выгрузить на локальное устройство в формате .csv, нажав на название сгенерированного файла