Как загрузить медиафайл в Multi API
Загрузка медиафайлов в Multi API — форматы, ограничения, действия, использование в API
Коротко: медиафайлы загружаются в базу «Медиа» и используются в шаблонах, рассылках и чат-ботах.
Кому подходит
- Роль: Клиент, Разработчик
- Уровень: Новичок
Что это
База Медиа — хранилище всех загруженных файлов: изображений, видео, документов и других. Каждый загруженный файл получает URL, который используется в API и в шаблонах.
Где используются медиафайлы:
- В шаблонах сообщений — как часть содержимого.
- Через API — как URL в параметре
payload.
Перед началом
- Вы работаете в разделе Активы → Медиа.
- У вас есть файл для загрузки.
- Вы знаете, где будете использовать файл — в рассылке, шаблоне или чат-боте.
Как загрузить файл
В левом меню: Активы → Медиа.
Кнопка в правом верхнем углу страницы. Откроется окно Выбор медиа.
Два способа:
- Перетащите файл в область загрузки.
- Нажмите «Выбрать файл» и выберите файл на устройстве.
Файл загрузится в базу. Он появится в списке и будет доступен для использования.
Поддерживаемые форматы
База Медиа принимает любые форматы файлов. Это могут быть:
- Изображения.
- GIF.
- Видео.
- Аудио.
- Документы.
Максимальный размер файла — 500 МБ.
Конкретные форматы для отправки зависят от канала. Например, для WhatsApp — JPG, PNG, MP4, PDF; для Viber — JPG, MP4, PDF и другие.
Полный список форматов по каналам — в статье Форматы payload по каналам →.
Ограничения
| Что | Ограничение |
|---|---|
| Максимальный размер файла | 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 изображения |
link (в image, video, document) | URL файла | |
link (в sticker) | URL стикера | |
| Telegram bot | link (в photo, video, document) | URL файла |
| Push (Mobile Push) | notification.image | URL изображения |
content (в body.rendered) | HTML-код с изображением |
Пример использования в WhatsApp:
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": "Подпись к изображению"
}
}
}'URL файла можно скопировать из базы Медиа — через действие Копировать.
Результат
Файл загружен в базу Медиа и доступен для использования в рассылках, шаблонах, чат-ботах и через API.
Частые проблемы
Причина: превышен максимальный размер файла.
Решение: сократите размер файла до 500 МБ.
Причина: файл не загружен в базу, или ссылка повреждена.
Решение: загрузите файл заново. Проверьте, что он появился в списке Медиа.
Причина: файл не сохранён в базе.
Решение: убедитесь, что нажали Сохранить изменения. Скопируйте URL файла из базы и вставьте его в параметр payload.
Причина: файл не является изображением или GIF.
Решение: действие Увеличить доступно только для изображений и GIF. Для других типов используйте Скачать.
Причина: файл используется в шаблоне, рассылке или чат-боте.
Решение: сначала отвяжите файл от всех шаблонов и сценариев, затем удаляйте. Если не получается — обратитесь в поддержку.
См. также
Нужна помощь?
- Multi API: support@multiapi.ru