> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Обработка файлов

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

## Лимиты

| Тип | Максимальный по умолчанию |
| - | - |
| Изображение | 20 МБ |
| Документ (`/send/file`) | 50 МБ |
| Видео | 100 МБ |
| Загруженные файлы (входящие) | 500 МБ |

Лимит тела HTTP-запроса равен лимиту видео (100 Мб), поэтому загрузка не может превышать его. Запрашивать живые значения с помощью `GET /app/info` (`max_image_size`, `max_file_size`, `max_video_size`). Эти ограничения компилируются по умолчанию; для них не существует.

## Два способа предоставить средства массовой информации

Каждая конечная точка медиа принимает либо многокомпонентный файл, либо URL, который GOWA получает сторону-сервера:

```bash theme={null}
# upload
curl -u admin:changeme -X POST http://localhost:3000/send/image \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 -F image=@photo.jpg

# URL
curl -u admin:changeme -X POST http://localhost:3000/send/image \
  -H "X-Device-Id: my-device" \
  -F phone=628123456789 -F image_url=https://example.com/photo.jpg
```

Отправлять один или другой, а не и то и другое. URL-адреса удаленных носителей должны использовать HTTP или HTTPS и принимать решения для публичных адресов. GOWA блокирует циклы, приватные ссылки, локальные и другие зарезервированные направления, включая цели перенаправления. Загрузите локальные файлы как многокомпонентные данные, а не используя внутренний URL.

## Обработка

GOWA требуется FFmpeg и libwebp на хосте (оба находятся в Docker изображении).

| Вариант | Endpoint | Эффект |
| - | - | - |
| `compress` | изображение (по умолчанию `true`), видео (по умолчанию `false`) | Повторно кодировать перед отправкой. |
| `hd` | изображение, видео | Отправить в HD без масштабирования: изображения до 2560 px длинного края; видео как H.264 ограничено 1280×1280. Переопределяет сжатие `compress`. |
| `view_once` | изображение, видео | Получатель может открыть его один раз. |
| `gif_playback` | видео | Играйте как зацикливание GIF. |
| `ptt` | аудио | Отправить как голосовую заметку (толкнуть-к-говорить). Преобразовано с помощью FFmpeg. |
| (автоматически) | стикер | JPG, PNG, WebP или GIF преобразованы в стикер 512×512. Анимированный WebP должен соответствовать стикерам WhatsApp. |

`/send/file` отправляет документы без конвертации.

Размер заголовка проверяет размеры изображения перед декодированием. Самый длинный допустимый край - 32,768 пикселей. Изображения не JPEG имеют 40-миллионный пиксельный бюджет. JPEG имеют 80-миллионовый потолок плюс 320 Мб декодовой памяти, поэтому некоторые большие прогрессивные или CMYK JPEG отвергаются ниже пиксельного потолка. Оригинальное изображение посылается без эскизов, когда декодирование превышает бюджет. Интерактивные изображения карусели имеют отдельные, меньшие ограничения в [Интерактивные сообщения](https://gowa-docs.mintlify.site/ru/examples/interactive-messages.md).

## Входящий медиа

С помощью `WHATSAPP_AUTO_DOWNLOAD_MEDIA=true` (по умолчанию) GOWA загружает файлы из входящих сообщений в `statics/media/` и ставит относительный путь в файл webhook payload:

```json theme={null}
{
  "image": "statics/media/1752404751-ad9e37ac-c658-4fe5-8d25-ba4a3f4d58fd.jpeg"
}
```

Загрузите его по ссылке `http://<host>:3000/statics/media/<file>`. Установите `WHATSAPP_IGNORE_STATUS_MEDIA=true`, чтобы пропустить медиа из обновлений.

С автозагрузкой вместо этого используется URL-адрес CDN WhatsApp. Загрузите GOWA, который расшифрует файл:

```bash theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  "http://localhost:3000/message/3EB0C127D7BACC83D6A3/download?phone=628987654321@s.whatsapp.net"
```

WhatsApp сохраняет мультимедиа на своих серверах в ограниченное время. Скачайте то, что вам нужно.

На GOWA `main` после v9.9.0 явные загрузки и перенаправления могут попросить телефон повторно загружать просроченные носители. Телефон должен быть онлайн и все еще иметь файл. GOWA ожидает ответа до 30 секунд. Также это применимо к действиям `download_media` MCP и `forward`, а также к [импортам истории Чатвута](https://gowa-docs.mintlify.site/ru/integrations/chatwoot.md#%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8F-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82%D0%B0).

## Хранилище и очистка

Пути относятся к каталогу процесса, обычно `src/` из исходного кода или `/app` в Docker. Составляйте монтирование каталогов `storages/` и `statics/` в `/app`.

| Путь | Содержание |
| - | - |
| `statics/media/` | Загруженные мультимедиа webhook и явные загрузки, включая подкаталоги чата/даты. |
| `storages/<timestamp>-<uuid>[.<extension>]` | Дополнительные копии, сохраненные обработчиком изображений при включенной автоматической загрузке. |
| `storages/scheduled/` | Вложения, сохраненные запланированными отправителями. Пусть планировщик их управляет. |
| `storages/history-*.json` | Исторические дампы, не зависящие от загрузки медиафайлов. |

Настройки срока хранения медиафайлов и конечной точки очистки нет. Копии изображения могут находиться и в `storages/`, и в `statics/media/`. Никогда не удаляйте весь каталог `storages/`, чтобы освободить место, занятое медиафайлами.

Приостановить GOWA и другие записи, создать резервную копию необходимых файлов, а затем предварительно просмотреть файлы для удаления. Эти GNU находят примеры запуска из каталога установки и выберите файлы по крайней мере 31 полный срок старых.

```bash theme={null}
find ./statics/media -type f -mtime +30 -print
find ./storages -maxdepth 1 -type f -mtime +30 \
  -name '[0-9]*-????????-????-????-????-????????????*' -print
```

После просмотра каждого пути замените `-print` на `-delete` в тех же командах. Сохраняйте файлы базы данных, SQLite `-wal` и `-shm` sidecars, запланированные вложения и пользовательские файлы. Перезапустите GOWA после. Удаленные пути и статические URL-адреса перестают работать, а удаление медиа-файлов не приводит к изменению истории чата.

`WHATSAPP_AUTO_DOWNLOAD_MEDIA=false` останавливает будущие автоматические загрузки и дополнительные копии изображений. Он не удаляет старые файлы и не предотвращает явные загрузки REST или MCP. Смотрите полное [медиа хранилище и руководство по очистке](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/media-storage.md).

`/statics` остается общедоступным. Сохраненные HTML, SVG, скрипты и другие документы обслуживаются в виде вложений в `application/octet-stream` и `nosniff`. Поддерживаемые изображения байты под путями предварительного просмотра могут визуализировать внутри. Эта защита содержимого не ограничивает кто может загрузить файл. Защищайте чувствительные носители на обратном прокси.

## Устранение проблем

| Проблема | Исправить |
| - | - |
| `413` или ошибка превышения размера тела запроса | Файл превышает 100 MB; отправьте ссылку. |
| Голосовая заметка не удалась или воспроизводилась как файл | Установите FFmpeg; установите `ptt=true`. |
| Преобразование стикера не удалось | Установите инструменты libwebp (`cwebp`, `dwebp`, `webpmux`). |
| URL носителя не удался | URL должен быть открытым, возвращать файл непосредственно (без HTML страницы) и соответствовать размеру страницы. |


## Related topics

- [Обработка ошибок](https://gowa-docs.mintlify.site/ru/advanced/error-handling.md)
- [Ссылка на конфигурацию](https://gowa-docs.mintlify.site/ru/configuration.md)
- [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
- [Ошибки](https://gowa-docs.mintlify.site/ru/api-reference/errors.md)
- [Получить конфигурацию webhook устройства](https://gowa-docs.mintlify.site/ru/api-reference/device/получить-конфигурацию-webhook-устройства.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.