Часто встречаю запрос от клиентов: «А как нам автоматически получать ссылку на запись разговора, чтобы отправить её во внешний сервис или прикрепить в отчёт?». Рассказываю, как сделать по шагам.
1. Находим нужные звонки в CRM
Используем метод API: crm.activity.list. Он позволяет получить список активностей по нужной сделке, контакту или лиду. В ответе ищем массив FILES, именно там хранятся ID файлов записей звонков.
Например:
«FILES»: [
{
«id»: 129,
«url»: «https://ваш_портал/bitrix/tools/crm_show_file.php?fileId=129&ownerTypeId=6&ownerId=89&auth=»
}
]
2. Фильтруем звонки
Если хотите поставить фильтр, например, только успешные звонки длительностью > 30 секунд — подключаем метод: voximplant.statistic.get. Он позволяет гибко задать фильтры по длительности, направлению, результату и т. д., а в ответе уже получаем идентификаторы нужных звонков.
3. Получаем публичную ссылку на файл
По id из массива FILES вызываем метод: disk.file.getExternalLink. Это возвращает не требующую авторизации ссылку на файл записи, ее можно отправить куда угодно.
В итоге получается автоматизированный сценарий:
Поиск нужных звонков → Получение ID файла → Получение публичной ссылки.