Versions Compared

Old Version 24

changes.mady.by.user Роман Сухов (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Asia Khalitova (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Warning

Мы обновили документацию, актуальная версия страницы доступна по ссылке: Записи разговоров (/record/)

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

...

Поля ресурса "Запись разговора" совпадают с полями ресурса CDR, но в отличие от CDR, поля record_uuid и record_file_size никогда не принимают значения null.

Имя

Тип

Описание

client_owner_id

integer

Идентификатор клиента-владельца записи

dealer_owner_id

integer

Идентификатор дилера-владельца записи

dest_domain

string

Домен назначения вызова

dest_number

string

Номер назначения вызова

did_domain

string

Домен внешнего номера

did_number

string

Внешний номер

duration

integer

Длительность вызова

ext_number_reg

string

Зарегистрированный внешний номер

extension_group_owner_id

integer

Идентификатор группы добавочных, владеющей записью

extension_id

integer

Идентификатор добавочного

extension_name

string

Имя добавочного

extension_type

string

Тип добавочного

flow

string

Направление вызова. Может принимать значение "in" или "out"

from_domain

string

Исходный домен звонящего

from_screen_name

string

Исходное отображаемое имя звонящего

from_username

string

Исходное имя пользователя звонящего

hangup_cause

string

Причина окончания вызова

hangup_time_gmt

string

Время окончания вызова

init_time_gmt

string

Время инициализации вызова

record_file_size

integer

Размер файла записи в байтах

record_uuid

string

Идентификатор записи разговора

result

string

Результат вызова

source_domain

string

Домен источника вызова

source_number

string

Номер источника вызова

start_time_gmt

string

Время начала вызова

to_domain

string

Исходный домен назначения

to_username

string

Исходный имя пользователя назначения

call_uuid

stringУникальный идентификатор вызова

Получение статистики записей разговора

...

Ответ:

{

    "record_url": "httphttps://storage.hostname.ru/bd7zzrXD5395gn7FMgzKtB8zhZnNoYx8BdkX_HgNdeE2lnJjPMLcOR_1hQprGf-dW94wuTCNRAY6MDjMZ0zWIg=="

...

Существует возможность получить архив с множеством файлов записей за период времени. Для этого необходимо воспользоваться специальным ресурсом API, передав в него временной диапазон и адрес электронной почты, на которую будет отправлена ссылка для загрузки архива. Размер файлов в архиве и диапазон дат ограничен. В течении часа невозможно запросить новый архив, не загрузив предыдущий. Коды возможных ошибок перечислены на странице Возвращаемые коды и статусы. Записи разговора по ссылке будут доступны в течении 12 часов.

POST /client/{client_id}/record/archive/

Параметры JSON

Имя

Тип

Обязательный

Описание

start_datetime

string (YYYY-MM-DD HH:MM:SS)

да

Начало диапазона в формате YYYY-MM-DD HH:MM:SS
end_datetimestring (YYYY-MM-DD HH:MM:SS)даКонец диапазона в формате YYYY-MM-DD HH:MM:SS

email

string

да

Адрес электронной почты для отправки ссылки на архив. Возможно перечисление нескольких адресов через запятую


Ресурсы раздела "Клиент"

GET /client/{client_id}/record/

...

Запросить архив записей разговора за период

Параметры URL

Имя

Тип

client_id

string

Параметры JSON

Имя

Тип

Обязательный

start_datetime

string

да

email

string

да

end_datetime

string

да

Поля ответа

Имя

Тип

start_datetime

string

archive_uuid

string

email

string

end_datetime

string

...

GET /client/{client_id}/record/stats/

...