Как лучше получить аудиофайл визита из сделки облачного Битрикс24?

Ссылка скопирована
1 ответ

По вводным: использую облачный Битрикс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 такой сценарий не нашёл.

Спасибо!

Нужно решить такую задачу?

Опишите проблему, и специалист поможет с настройкой, исправлением ошибки или доработкой сайта. Подберём понятный план работ без лишней переписки.

Заказать помощь
Лучший ответ
1
Максим Павлов Ответ

В облачном Битрикс24 аудиофайл звонка или визита из сделки обычно получают не напрямую из сделки, а через связанные активности, звонки телефонии или timeline. Сама сделка хранит CRM-данные, а запись разговора лежит в сущностях активности/телефонии и доступна через REST API при наличии прав.

Алгоритм такой: сначала получаете ID сделки, затем список активностей по сделке, находите активность звонка или визита, смотрите поля с attachment/recordUrl, после этого запрашиваете файл авторизованным REST-вызовом. В облаке прямой публичной ссылки может не быть или она может требовать авторизации.

1. crm.deal.get -> проверить сделку.
2. crm.activity.list -> найти активности по OWNER_TYPE_ID и OWNER_ID.
3. Найти активность типа звонка.
4. Проверить ASSOCIATED_ENTITY_ID, FILES, STORAGE_ELEMENT_IDS или параметры телефонии.
5. Скачать запись через доступный URL/API с авторизацией.

Пример общей логики запроса активностей:

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 записи в свое поле сделки и логировать случаи, когда запись еще не готова.

Другие ответы (0)

Пока нет других ответов. Будьте первым, кто поможет автору.

Ответить на вопрос

комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

Вам также может быть интересно