Перейти к содержанию

GetCallRecording#

Метод предназначен для скачивания входящих и исходящх звонков.

Ссылка на файл в формате .ogg возвращается в ответе метода. idMessage звонка можно получить с помощью методов LastIncomingCalls и LastOutgoingCalls.

Срок хранения файлов для их скачивания ограничено временем в 60 дней.

Запрос#

POST
{{apiUrl}}/waInstance{{idInstance}}/getCallRecording/{{apiTokenInstance}}

Для получения параметров запроса apiUrl, idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр Тип Обязательный Описание
idMessage string Да Идентификатор сообщения (звонка)

Пример тела запроса#

{
    "idMessage": "BAE550673B9C0497"
}

Ответ#

Поля ответа#

Поле Тип Описание
status string Готовность сообщения: processing - обрабатывается и ссылки на скачивание не будет, ready - готово
downloadUrl string Ссылка на файл из сообщения, доступна в течении одного часа после формирования, после часа нужно формировать новую
expireAt integer Время жизни ссылки в UnixTime
durationMs integer Время разговора в мс
sizeBytes integer Размер файла в байтах

Пример тела ответа#

{
    "downloadUrl": "https://sw-media.storage.yandexcloud.net/1103912412/a6679d42-2f7f-4121-acfe-1f993dfcf123.png"
}

Ошибки DownloadFile#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Код HTTP Идентификатор ошибки Описание
400 Bad Request
Validation failed
Пустой или неверный idMessage