Функционал доступен при наличии лицензии SMG-API и SMG-REC.

В данном приложении описана функция автоматической передачи ссылок на файлы записей разговоров. 

API поддерживает два способа передачи ссылки на сформированный файл записи разговора:

  1. Автоматическая отправка URL-ссылки на внешний HTTP-сервер с использованием HTTP-метода PUT.
  2. Добавление URL-ссылки в соответствующую CDR-запись.

Предварительная настройка

Перед началом работы с API необходимо:

1. Настроить API-сервер шлюза:

  • Убедиться, что API сервер включен;
  • Настроить интерфейс выгрузки файлов "Запись разговоров":
    • Выбрать сетевой интерфейс;
    • Указать порт;
  • При необходимости включить TLS. В этом случае запросы будут выполняться по протоколу HTTPS.

API → Сервер

2. Создать пользователя.

Для API-аккаунта необходимо задать:

  • Запись разговоров;
  • Категория записей разговоров.

API → Аккаунты

3. Включить выгрузку ссылок на записи разговоров.

  • Включить опцию "Выгружать URL-ссылки через HTTP";
  • Настроить адрес и порт сервера, на который будут отправляться URL-ссылки.

Запись разговоров → Параметры записи

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

Выгрузка файла записи разговора

Параметры ссылки на файл записи разговора

ПараметрОбязательныйОписание
typeДаТип записи
dirДаДиректория, в которой находится файл записи
fileДаИмя файла записи с расширением

Пример полученной URL-ссылки:

PUT /uploads/url_record HTTP/1.1
Host: 192.168.113.228
Content-Type: application/json
Content-Length: 127

{"url":"http://192.168.113.230:4444/api/v1/files?type=callrec&dir=2026-07-24-0000&file=2026-07-24_14-54-18_400-3005_n0_c0.wav"}

Использование FTP-ссылки вместо HTTP

Если записи разговоров отправляются на внешний FTP-сервер, включите опцию "Использовать адрес FTP в ссылках CDR/HTTP". Тогда вместо HTTP-ссылки формируется ссылка на FTP-сервер:

PUT /uploads/url_record HTTP/1.1
Host: 192.168.113.228
Content-Type: application/json
Content-Length: 81

{"url":"ftp://192.168.113.228:21/callrec/2026-07-24_16-17-56_400-3005_n0_c0.wav"}

Поле "Ссылка на запись разговора" в CDR

Также ссылку можно получить в CDR-файлах, для этого необходимо добавить поле "Ссылка на запись разговора" в список добавленных полей CDR.

Внутренние ресурсы → CDR-записи

Скачивание файла записи разговора по ссылке:

Чтобы скачать файл с внутреннего хранилища устройства, необходимо:

1. Получить токен по имени пользователя и паролю API аккаунта:

curl -X POST http://<IP>:<port>/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"login":"<login>","password":"<password>"}'

Ответ сервера:

{"status":"ok","version":"v1","payload":{"token":"token"}}

2. Отправить запрос на скачивание файла, используя полученный токен. Например:

curl -X GET "http://<IP>:<PORT>/api/v1/files/callrec?type=callrec&dir=2026-05-07-0000&file=2026-05-07_15-20-09_400-405_n0_c0_s.wav" \
  -H "Authorization: Bearer <token>" \
  -o callrec.wav
  • Нет меток