метод REST scope: telephony

telephony.externalCall.attachRecord

Прикрепить запись к завершенному звонку

Кто может выполнять: любой пользователь

Описание

Метод telephony.externalCall.attachRecord прикрепляет запись к завершенному звонку и к CRM-делу звонка.

Вызывайте метод после telephony.externalCall.finish, когда запись готова.

Параметры

CALL_ID string обязательный

Идентификатор звонка из метода telephony.externalCall.register.

Если вызвать метод повторно для одного и того же звонка, новая запись заменит ранее прикрепленную

RECORD_URL string необязательный

URL записи на внешнем сервере. Если параметр передан, Битрикс24 скачивает файл по ссылке.

Рекомендуется использовать только если файл доступен стабильно и быстро

FILENAME string необязательный

Имя файла записи.

Возможные расширения:
- wav
- mp3

В режиме RECORD_URL:
- если FILENAME не передан, имя берется из URL

FILE_CONTENT string необязательный

Файл в кодировке Base64

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CALL_ID":"externalCall.716f1cb73def9700a23842adf9c4c568.1773130779","FILENAME":"call-001.mp3","FILE_CONTENT":"SUQzAwAAAAAiVVRJVDI...AAAAAAAAAAAAP8="}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/telephony.externalCall.attachRecord

Ответ

HTTP-статус: 200

{
    "result": {
        "FILE_ID": 9079
    },
    "time": {
        "start": 1773134738,
        "finish": 1773134740.398239,
        "duration": 2.3982388973236084,
        "processing": 2,
        "date_start": "2026-03-10T12:25:38+03:00",
        "date_finish": "2026-03-10T12:25:40+03:00",
        "operating_reset_at": 1773135338,
        "operating": 1.9444890022277832
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

FILE_ID integer

Идентификатор прикрепленного файла

uploadUrl string

URL загрузки файла, если FILE_CONTENT не был передан

fieldName string

Имя поля для загрузки файла

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "ERROR_CORE",
    "error_description": "Required parameters are not set. Request should contain or URL or FILENAME parameter"
}
Код Описание Значение
ERROR_CORE Required parameters are not set. Request should contain or URL or FILENAME parameter Не переданы RECORD_URL и FILENAME
ERROR_CORE Call is not found in the statistic table. Looks like it is not finished yet. Звонок не найден в статистике. Убедитесь, что звонок завершен
ERROR_CORE File name is empty Пустой FILENAME
ERROR_CORE Wrong file extension. Only wav and mp3 are allowed Недопустимое расширение файла
ERROR_CORE File content is empty. Пустой FILE_CONTENT
ERROR_CORE File content is not properly encoded. Base64 encoding is expected. FILE_CONTENT передан не в Base64
ERROR_CORE Server returns HTTP error code {N} Ошибка HTTP при загрузке записи по RECORD_URL

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.