метод REST scope: im

im.v2.File.upload

Загрузить файл в чат

Кто может выполнять: пользователь с доступом к чату

Описание

Метод im.v2.File.upload загружает файл в чат от имени текущего пользователя. Объединяет три шага устаревшего API в один вызов: загрузку файла на диск, прикрепление к чату и отправку сообщения.

Параметры

dialogId string обязательный

ID диалога. Для групповых чатов — chat{chatId}, для личных — {userId}

fields object обязательный

Объект с параметрами файла и сообщения (подробное описание)

Параметр fields

name string обязательный

Имя файла с расширением

content string обязательный

Содержимое файла в кодировке Base64. Максимальный размер — 100 МБ

message string необязательный

Текст сообщения, отправляемого вместе с файлом

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"dialogId":"chat5","fields":{"name":"report.pdf","content":"SGVsbG8gV29ybGQh","message":"Here is the report"}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.v2.File.upload

Ответ

HTTP-статус: 200

{
    "result": {
        "file": {
            "id": 9817,
            "chatId": 4415,
            "date": "2026-08-11T15:28:50+03:00",
            "type": "file",
            "name": "report.pdf",
            "extension": "pdf",
            "size": 35341,
            "image": false,
            "status": "done",
            "progress": 100,
            "authorId": 1,
            "authorName": "Иван Иванов",
            "urlPreview": "",
            "urlShow": "https://mysite.bitrix24.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=9817&exact=N&fileName=report.pdf",
            "urlDownload": "https://mysite.bitrix24.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=9817&exact=N&fileName=report.pdf",
            "viewerAttrs": {
                "viewer": "",
                "viewerType": "code",
                "src": "https://mysite.bitrix24.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=9817&exact=N&fileName=report.pdf",
                "objectId": "9817",
                "viewerGroupBy": "4415",
                "imChatId": 4415,
                "title": "report.pdf",
                "unifiedLink": "https://mysite.bitrix24.ru/file/5tqNA6utERA5MIWnKpFX",
                "actions": "[{\"type\":\"download\"}]"
            },
            "mediaUrl": {
                "preview": {
                    "250": ""
                }
            },
            "isTranscribable": false,
            "isVideoNote": false,
            "isVoiceNote": false
        },
        "messageId": 38655,
        "chatId": 4415,
        "dialogId": "chat4415"
    },
    "time": {
        "start": 1786451330,
        "finish": 1786451330.233862,
        "duration": 0.23386192321777344,
        "processing": 0,
        "date_start": "2026-08-11T15:28:50+03:00",
        "date_finish": "2026-08-11T15:28:50+03:00",
        "operating_reset_at": 1786451790,
        "operating": 0
    }
}

Возвращаемые данные

result object

Результат операции

result.dialogId string

Идентификатор диалога

result.chatId integer

Числовой идентификатор чата

result.messageId integer

Идентификатор созданного сообщения с файлом

result.file File

Данные загруженного файла (подробное описание)

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "FILE_TOO_LARGE",
    "error_description": "File too large"
}
Код Описание Значение
FILE_EMPTY File name and content are required Не передано имя или содержимое файла
FILE_INVALID_CONTENT Invalid base64 content Содержимое файла — не строка Base64
CHAT_NOT_FOUND CHAT_NOT_FOUND Чат из dialogId не найден
FOLDER_ERROR Failed to get chat folder Не удалось получить папку чата
UPLOAD_FAILED File upload failed Ошибка загрузки файла
SEND_FAILED Failed to send message Ошибка отправки сообщения
FILE_TOO_LARGE File is too large Размер файла превышает 100 МБ
ACCESS_DENIED Access denied Нет доступа к чату

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.