Отправить файл
Отправляет файл диска в чат по 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Файла, Описание, Токен);
- Bash
- CMD/Bat
oint bitrix24 ОтправитьФайл \
--url "b24-ar17wx.bitrix24.by" \
--chat 3258 \
--fileid 44870 \
--description "Очень важный файл" \
--token "***"
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
}
}