Просмотреть исходный

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

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

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

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

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

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

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

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

API → Сервер

Eltex Documentation > 3.411.0. Приложение Х. Выгрузка записей разговоров по ссылке > image-2026-7-24_13-31-12.png

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

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

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

API → Аккаунты

Eltex Documentation > 3.411.0. Приложение Х. Выгрузка записей разговоров по ссылке > image-2026-7-24_13-33-41.png

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

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

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

Eltex Documentation > 3.411.0. Приложение Х. Выгрузка записей разговоров по ссылке > image-2026-7-24_14-4-11.png

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

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

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

Параметр	Обязательный	Описание
`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-записи

Eltex Documentation > 3.411.0. Приложение Х. Выгрузка записей разговоров по ссылке > image-2026-7-24_17-11-43.png

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

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

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