Отправить файл
Отправляет файл диска в чат по 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Чата = "2948";
Файл = "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";
Токен = "4f8db968006e9f06006b12e400000001000...";
IDЧата = "2950";
Каталог = 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 3022 \
--fileid 41688 \
--description "Очень важный файл" \
--token ***
oint bitrix24 ОтправитьФайл ^
--url "b24-ar17wx.bitrix24.by" ^
--chat 3022 ^
--fileid 41688 ^
--description "Очень важный файл" ^
--token ***
Результат
{
"result": {
"FILES": {
"upload41688": {
"id": 41688,
"chatId": 3022,
"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=41688&width=1280&height=1280&signature=f16bbda4e619e8074ab75e60f624d76afc2a0aee40ffbd80bf55886d20a8aa89&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=41688&width=1280&height=1280&signature=f16bbda4e619e8074ab75e60f624d76afc2a0aee40ffbd80bf55886d20a8aa89&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=41688&width=1280&height=1280&signature=f16bbda4e619e8074ab75e60f624d76afc2a0aee40ffbd80bf55886d20a8aa89&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": "41688",
"imChatId": 3022,
"title": "Важный документ.docx",
"actions": "[{\"type\":\"download\"},{\"type\":\"copyToMe\",\"text\":\"Сохранить на Диск\",\"action\":\"BXIM.disk.saveToDiskAction\",\"params\":{\"fileId\":\"41688\"},\"extension\":\"disk.viewer.actions\",\"buttonIconClass\":\"ui-btn-icon-cloud\"}]"
},
"mediaUrl": {
"preview": {
"250": ""
}
}
}
},
"DISK_ID": [
"41688"
],
"FILE_MODELS": {
"upload41688": {
"id": 41688,
"name": "Важный документ.docx",
"createTime": {},
"updateTime": {},
"deleteTime": null,
"code": null,
"xmlId": null,
"storageId": 6,
"realObjectId": 41688,
"parentId": 41684,
"deletedType": 0,
"createdBy": "1",
"updatedBy": "1",
"deletedBy": "0",
"typeFile": 4,
"globalContentVersion": 2,
"fileId": 27944,
"size": 24071,
"etag": "9fa7d50ca09381015211552ccb07fb1c",
"links": {
"download": "/bitrix/services/main/ajax.php?action=disk.file.download&SITE_ID=s1&fileId=41688",
"showInGrid": "/bitrix/tools/disk/focus.php?objectId=41688&action=showObjectInGrid&ncc=1"
}
}
},
"MESSAGE_ID": 59362
},
"time": {
"start": 1757443408.68862,
"finish": 1757443408.74174,
"duration": 0.0531270503997803,
"processing": 0.030940055847168,
"date_start": "2025-09-09T18:43:28+00:00",
"date_finish": "2025-09-09T18:43:28+00:00",
"operating_reset_at": 1757444008,
"operating": 0
}
}