---
title: Как загрузить медиафайл в Multi API
description: Загрузка медиафайлов в Multi API — форматы, ограничения, действия, использование в API
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.



> **Коротко:** медиафайлы загружаются в базу «Медиа» и используются в шаблонах, рассылках и чат-ботах.

## Кому подходит

- Роль: Клиент, Разработчик
- Уровень: Новичок

## Что это

**База Медиа** — хранилище всех загруженных файлов: изображений, видео, документов и других. Каждый загруженный файл получает **URL**, который используется в API и в шаблонах.

**Где используются медиафайлы:**

- В **шаблонах сообщений** — как часть содержимого.
- Через **API** — как URL в параметре `payload`.

## Перед началом

- [ ] Вы работаете в разделе **Активы** → **Медиа**.
- [ ] У вас есть файл для загрузки.
- [ ] Вы знаете, где будете использовать файл — в рассылке, шаблоне или чат-боте.

## Как загрузить файл

### 1. Откройте раздел «Медиа»

В левом меню: **Активы** → **Медиа**.

### 2. Нажмите «Добавить медиа»

Кнопка в правом верхнем углу страницы. Откроется окно **Выбор медиа**.

### 3. Загрузите файл

Два способа:

- **Перетащите файл** в область загрузки.
- **Нажмите «Выбрать файл»** и выберите файл на устройстве.

### 4. Нажмите «Сохранить изменения»

Файл загрузится в базу. Он появится в списке и будет доступен для использования.

## Поддерживаемые форматы

**База Медиа принимает любые форматы файлов.** Это могут быть:

- Изображения.
- GIF.
- Видео.
- Аудио.
- Документы.

**Максимальный размер файла — 500 МБ.**

<Note>
**Конкретные форматы для отправки** зависят от канала. Например, для WhatsApp — JPG, PNG, MP4, PDF; для Viber — JPG, MP4, PDF и другие.

Полный список форматов по каналам — в статье [Форматы payload по каналам →](https://iba-platform.jamdesk.app/03-multiapi/02-api/mapi-104-omni-payload).
</Note>

## Ограничения

| Что | Ограничение |
|---|---|
| **Максимальный размер файла** | **500 МБ** |
| **Формат** | Любой |

## Режимы просмотра

В базе **Медиа** доступны два режима:

| Режим | Что показывает |
|---|---|
| **Таблица** | Список файлов с колонками |
| **Карточки** | Плиточный вид с превью |

Переключайтесь между режимами кнопками в правом верхнем углу.

## Действия с медиа

| Действие | Что делает |
|---|---|
| **Увеличить** | Открывает изображение в большом размере. Доступно **только для изображений и GIF** |
| **Копировать** | Копирует медиафайл |
| **Скачать** | Скачивает файл на устройство |
| **Удалить** | Удаляет файл из системы |

## Что в таблице

| Колонка | Что показывает |
|---|---|
| **Превью** | Миниатюра файла |
| **Имя файла** | Название файла |
| **Тип медиа** | Image, Video, Document |
| **Формат** | JPG, PNG, PDF и другие |
| **Разрешение** | Для изображений |
| **Размер файла** | В МБ |
| **Дата загрузки** | Когда загружен |

## Как использовать в API

Каждый загруженный файл получает **URL**. Этот URL передаётся в параметре `payload` — в поле, соответствующем каналу.

| Канал | Поле для медиа | Что указать |
|---|---|---|
| **RCS** | `fileUrl` (в `fileMessage`) | URL файла |
| **RCS** | `mediaUrl` (в `richcardMessage`) | URL изображения |
| **RCS** | `thumbnailUrl` (в `richcardMessage`) | URL миниатюры |
| **RCS** | `fileUrl` (в `audioMessage`) | URL аудиофайла |
| **Viber** | `imageUrl` | URL изображения |
| **WhatsApp** | `link` (в `image`, `video`, `document`) | URL файла |
| **WhatsApp** | `link` (в `sticker`) | URL стикера |
| **Telegram bot** | `link` (в `photo`, `video`, `document`) | URL файла |
| **Push (Mobile Push)** | `notification.image` | URL изображения |
| **Email** | `content` (в `body.rendered`) | HTML-код с изображением |

**Пример использования в WhatsApp:**

```bash
curl --location 'https://web.multiapi.ru/api/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <ваш-ключ>' \
  --data-raw '{
    "contact": "79123456789",
    "channel": 4,
    "senderId": "<senderID>",
    "payload": {
      "type": "image",
      "image": {
        "link": "https://web.multiapi.ru/files/storage/example.jpg",
        "caption": "Подпись к изображению"
      }
    }
  }'
```

<Note>
URL файла можно скопировать из базы **Медиа** — через действие **Копировать**.
</Note>

## Результат

Файл загружен в базу **Медиа** и доступен для использования в рассылках, шаблонах, чат-ботах и через API.

- [Форматы payload по каналам →](https://iba-platform.jamdesk.app/03-multiapi/02-api/mapi-104-omni-payload)
- [Как создать шаблон сообщения →](https://iba-platform.jamdesk.app/03-multiapi/04-assets/mapi-401-message-template)
- [Как создать шаблон WhatsApp →](https://iba-platform.jamdesk.app/03-multiapi/04-assets/mapi-402-whatsapp-template)

## Частые проблемы

### Файл не загружается

**Причина:** превышен максимальный размер файла.

**Решение:** сократите размер файла до **500 МБ**.

[Контакты поддержки →](https://iba-platform.jamdesk.app/06-reference/03-troubleshooting/ts-support-contacts)

### Изображение не отображается

**Причина:** файл не загружен в базу, или ссылка повреждена.

**Решение:** загрузите файл заново. Проверьте, что он появился в списке **Медиа**.

### Файл не находится в API

**Причина:** файл не сохранён в базе.

**Решение:** убедитесь, что нажали **Сохранить изменения**. Скопируйте URL файла из базы и вставьте его в параметр `payload`.

### Кнопка «Увеличить» не работает

**Причина:** файл не является изображением или GIF.

**Решение:** действие **Увеличить** доступно только для изображений и GIF. Для других типов используйте **Скачать**.

### Не удаётся удалить файл

**Причина:** файл используется в шаблоне, рассылке или чат-боте.

**Решение:** сначала отвяжите файл от всех шаблонов и сценариев, затем удаляйте. Если не получается — обратитесь в поддержку.

[Контакты поддержки →](https://iba-platform.jamdesk.app/06-reference/03-troubleshooting/ts-support-contacts)

## См. также

<Columns cols={2}>
  <Card title="Форматы payload по каналам" icon="code" href="/03-multiapi/02-api/mapi-104-omni-payload">
    JSON-примеры и форматы для каждого канала
  </Card>
  <Card title="Как создать шаблон сообщения" icon="square-plus" href="/03-multiapi/04-assets/mapi-401-message-template">
    Шаблоны для отправки сообщений
  </Card>
  <Card title="Как создать шаблон WhatsApp" icon="whatsapp" href="/03-multiapi/04-assets/mapi-402-whatsapp-template">
    Предварительно одобренные шаблоны
  </Card>
  <Card title="Настройка WhatsApp" icon="comment" href="/05-channels/04-whatsapp/whatsapp">
    Возможности канала и форматы
  </Card>
</Columns>

## Нужна помощь?

- **Multi API:** support@multiapi.ru