Битрикс24 глазами интегратора

Как получить публичную ссылку на запись звонка в Битрикс24 для внешних сценариев

Часто встречаю запрос от клиентов: «А как нам автоматически получать ссылку на запись разговора, чтобы отправить её во внешний сервис или прикрепить в отчёт?». Рассказываю, как сделать по шагам.

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 файла → Получение публичной ссылки.