AddFile

[POST] .../v1/chatmessage/addfile

Загружает новый файл в системную папку чата для последующего использования в сообщении.

Метод поддерживает два формата запроса:

• application/json для обратной совместимости, когда файл передается в data как Base64.
• multipart/form-data для потоковой загрузки бинарного файла без Base64 в клиентском запросе.

Входные параметры

Для application/json:

Для multipart/form-data:

Ограничения и проверки

• chat_id обязателен всегда.
• Для JSON-запроса обязательны name, extension, data.
• Для multipart/form-data обязателен file; name и extension можно не передавать, если они есть в имени файла.
• Метод принимает только один файл за запрос.
• name не длиннее 200 символов.
• extension не длиннее 10 символов.
• width и height передаются только парой и должны быть больше 0.
• duration_ms не может быть отрицательным.
• Клиент не передаёт media_type; поле возвращается в модели File.
• Размер файла ограничивается серверной настройкой file_max_filesize; при превышении возвращается ошибка 1024 (file.size).
• При превышении дисковой квоты аккаунта возвращается ошибка 1222 (disk_space).
• Для multipart/form-data содержимое файла передаётся бинарным потоком без Base64.
• Требуется право file_add (655) и доступ к чату.
• Для обычных чатов проверяется право chat_message_add (685).
• Для чатов, связанных с Lead/Deal/Ticket/Task, загрузка файла требует доступ к связанной сущности и участие текущего пользователя в этой сущности.
• Для Task-чатов используются права project_task_select, project_task_manage_all; crm_manage_all на task-чаты не распространяется.
• Для закрытого чата (closed = true) загрузка файла отклоняется с ошибкой 1220.
• Без права chat_manage_all (688) запись файла доступна только участнику чата.
• При праве chat_manage_all (688) участником чата быть не обязательно (только для обычных чатов).
• В Channel файл может загрузить участник User/Staff или пользователь с правом chat_manage_all (688).
• Поля folder_id и access_level извне не принимаются и задаются сервером.
• Файл всегда сохраняется в системную папку текущего чата с access_level = system.

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

{
  "chat_id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef",
  "name": "photo.jpg",
  "extension": "jpg",
  "data": "/9j/4AAQSkZJRgABAQ...",
  "width": 1280,
  "height": 720,
  "duration_ms": null
}

Пример multipart-запроса

curl -X POST "https://example.com/v1/chatmessage/addfile" \
  -H "Authorization: Bearer <token>" \
  -F "chat_id=6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef" \
  -F "width=1280" \
  -F "height=720" \
  -F "file=@photo.jpg"

Выходные параметры

Пример ответа

{
  "ok": true,
  "result": {
    "file_id": 12051
  }
}