Перейти к основному содержимому

Отправить файл

Отправляет файл диска в чат по ID

Функция ОтправитьФайл(Знач URL, Знач IDЧата, Знач IDФайла, Знач Описание = "", Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрокаURL внешнего вебхука или адрес Bitrix24 при использовании токена
IDЧата--chatСтрока, ЧислоID чата
IDФайла--fileidСтрока, ЧислоID файла, загруженного при помощи ЗагрузитьФайлВКаталог
Описание--descriptionСтрокаОписание файла
Токен--tokenСтрокаТокен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24


подсказка

Метод в документации API: im.disk.file.commit


Пример использования для 1С:Предприятие/OneScript
    URL      = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
IDЧата = "3244";
Файл = "https://hut.openintegrations.dev/test_data/document.docx"; // Двоичные данные, URL или путь к файлу
Описание = "Очень важный файл";

Каталог = OPI_Bitrix24.ПолучитьКаталогФайловЧата(URL, IDЧата);
IDКаталога = Каталог["result"]["ID"];

ЗагруженныйФайл = OPI_Bitrix24.ЗагрузитьФайлВКаталог(URL, "Важный документ.docx", Файл, IDКаталога);
IDФайла = ЗагруженныйФайл["result"]["ID"];

Результат = OPI_Bitrix24.ОтправитьФайл(URL, IDЧата, IDФайла, Описание);

URL = "b24-ar17wx.bitrix24.by";
Токен = "8a1bee68006e9f06006b12e400000001000...";
IDЧата = "3246";

Каталог = OPI_Bitrix24.ПолучитьКаталогФайловЧата(URL, IDЧата, Токен);
IDКаталога = Каталог["result"]["ID"];

ЗагруженныйФайл = OPI_Bitrix24.ЗагрузитьФайлВКаталог(URL, "Важный документ.docx", Файл, IDКаталога, Токен);
IDФайла = ЗагруженныйФайл["result"]["ID"];

Результат = OPI_Bitrix24.ОтправитьФайл(URL, IDЧата, IDФайла, Описание, Токен);
    oint bitrix24 ОтправитьФайл \
--url "b24-ar17wx.bitrix24.by" \
--chat 3258 \
--fileid 44870 \
--description "Очень важный файл" \
--token "***"
Результат
{
"result": {
"FILES": {
"upload44924": {
"id": 44924,
"chatId": 3262,
"date": {},
"type": "file",
"name": "Важный документ.docx",
"extension": "docx",
"size": 24071,
"image": false,
"status": "done",
"progress": 100,
"authorId": 1,
"authorName": "Антон Титовец",
"urlPreview": "",
"urlShow": "https://b24-ar17wx.bitrix24.by/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=44924&width=1280&height=1280&signature=405f52303a2158d356cc3cf129e7d69a6ae4653576e908ef707f1499ada11f4b&exact=N&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
"urlDownload": "https://b24-ar17wx.bitrix24.by/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=44924&width=1280&height=1280&signature=405f52303a2158d356cc3cf129e7d69a6ae4653576e908ef707f1499ada11f4b&exact=N&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
"viewerAttrs": {
"viewer": null,
"viewerType": "cloud-document",
"src": "https://b24-ar17wx.bitrix24.by/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=44924&width=1280&height=1280&signature=405f52303a2158d356cc3cf129e7d69a6ae4653576e908ef707f1499ada11f4b&exact=N&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
"viewerTypeClass": "BX.Messenger.Integration.Viewer.OnlyOfficeChatItem",
"viewerSeparateItem": true,
"viewerExtension": "im.integration.viewer",
"objectId": "44924",
"imChatId": 3262,
"title": "Важный документ.docx",
"actions": "[{\"type\":\"download\"},{\"type\":\"copyToMe\",\"text\":\"Сохранить на Диск\",\"action\":\"BXIM.disk.saveToDiskAction\",\"params\":{\"fileId\":\"44924\"},\"extension\":\"disk.viewer.actions\",\"buttonIconClass\":\"ui-btn-icon-cloud\"}]"
},
"mediaUrl": {
"preview": {
"250": ""
}
},
"isTranscribable": false
}
},
"DISK_ID": [
"44924"
],
"FILE_MODELS": {
"upload44924": {
"id": 44924,
"name": "Важный документ.docx",
"createTime": {},
"updateTime": {},
"deleteTime": null,
"code": null,
"xmlId": null,
"storageId": 6,
"realObjectId": 44924,
"parentId": 44920,
"deletedType": 0,
"createdBy": "1",
"updatedBy": "1",
"deletedBy": "0",
"uniqueCode": "lntUHdpJ2Hc5VvJUpLEh",
"typeFile": 4,
"globalContentVersion": 2,
"fileId": 30284,
"size": 24071,
"etag": "80faa023f9e513d5981a7977e66a749c",
"links": {
"download": "/bitrix/services/main/ajax.php?action=disk.file.download&SITE_ID=s1&fileId=44924",
"showInGrid": "/bitrix/tools/disk/focus.php?objectId=44924&action=showObjectInGrid&ncc=1"
}
}
},
"MESSAGE_ID": 64618
},
"time": {
"start": 1760461508,
"finish": 1760461508.52144,
"duration": 0.521439075469971,
"processing": 0,
"date_start": "2025-10-14T17:05:08+00:00",
"date_finish": "2025-10-14T17:05:08+00:00",
"operating_reset_at": 1760462108,
"operating": 0
}
}