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

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

Отправляет файл диска в чат по 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Файла, Описание, Токен);
    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
}
}