Как лучше получить аудиофайл визита из сделки облачного Битрикс24?
По вводным: использую облачный Битрикс24 и хочу автоматизировать извлечение аудиозаписей визитов, прикреплённых к сделкам. В интерфейсе я вижу, что в сделке есть запись визита, и к ней прикреплён аудиофайл.
Проблема:
Сейчас ситуация такая: при запросе данных сделки через `crm.deal.get` или `crm.activity.list` я получаю ID активности (визита), но не могу найти способ загрузить сам аудиофайл — ни в ответе методов API, ни в документации не указано, как получить URL или содержимое файла.
Подскажите,:
Нужно понять: 1. Какой API-метод нужно вызвать, чтобы получить информацию о файле, прикреплённом к активности типа «Визит»?
Нужно понять: 2. Есть ли у активности (activity) поле с `FILE_ID` или `UPLOAD_FILE_ID`, и если да — как его использовать для скачивания?
Нужно понять: 3. Возможно ли получить аудиофайл напрямую по ID активности без привязки к сущностям типа `CRM_LEAD` или `CRM_CONTACT`?
Сейчас ситуация такая: буду благодарен за примеры запросов (REST/JSON) или ссылки на документацию, где это описано — пока в официальной документации Bitrix24 такой сценарий не нашёл.
Спасибо!
Опишите проблему, и специалист поможет с настройкой, исправлением ошибки или доработкой сайта. Подберём понятный план работ без лишней переписки.
Пока нет других ответов. Будьте первым, кто поможет автору.
Ответить на вопрос
В облачном Битрикс24 аудиофайл звонка или визита из сделки обычно получают не напрямую из сделки, а через связанные активности, звонки телефонии или timeline. Сама сделка хранит CRM-данные, а запись разговора лежит в сущностях активности/телефонии и доступна через REST API при наличии прав.
Алгоритм такой: сначала получаете ID сделки, затем список активностей по сделке, находите активность звонка или визита, смотрите поля с attachment/recordUrl, после этого запрашиваете файл авторизованным REST-вызовом. В облаке прямой публичной ссылки может не быть или она может требовать авторизации.
Пример общей логики запроса активностей:
const webhook = 'https://example.bitrix24.ru/rest/1/token/'; const dealId = 123; const params = new URLSearchParams(); params.set('filter[OWNER_TYPE_ID]', '2'); params.set('filter[OWNER_ID]', String(dealId)); params.set('select[]', 'ID'); params.append('select[]', 'TYPE_ID'); params.append('select[]', 'SUBJECT'); params.append('select[]', 'FILES'); params.append('select[]', 'ASSOCIATED_ENTITY_ID'); const res = await fetch(webhook + 'crm.activity.list.json?' + params); const data = await res.json();Если запись относится к телефонии, дополнительно смотрите методы telephony.externalcall или карточку звонка, в зависимости от вашей интеграции. У разных провайдеров телефонии запись может храниться не в Битрикс24, а у провайдера, тогда Bitrix отдаст ссылку или ID внешней записи.
Проверьте права пользователя вебхука: CRM, активности, телефония и диск. Если webhook создан пользователем без доступа к записи, API вернет пусто или ссылку, которая не открывается. Для надежной интеграции лучше сохранять найденную ссылку/ID записи в свое поле сделки и логировать случаи, когда запись еще не готова.