Перейти к основному содержанию

Лимиты

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

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

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

Обработка

GOWA требуется FFmpeg и libwebp на хосте (оба находятся в Docker изображении). /send/file отправляет документы без конвертации. Размер заголовка проверяет размеры изображения перед декодированием. Самый длинный допустимый край - 32,768 пикселей. Изображения не JPEG имеют 40-миллионный пиксельный бюджет. JPEG имеют 80-миллионовый потолок плюс 320 Мб декодовой памяти, поэтому некоторые большие прогрессивные или CMYK JPEG отвергаются ниже пиксельного потолка. Оригинальное изображение посылается без эскизов, когда декодирование превышает бюджет. Интерактивные изображения карусели имеют отдельные, меньшие ограничения в Интерактивные сообщения.

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

С помощью WHATSAPP_AUTO_DOWNLOAD_MEDIA=true (по умолчанию) GOWA загружает файлы из входящих сообщений в statics/media/ и ставит относительный путь в файл webhook payload:
Загрузите его по ссылке http://<host>:3000/statics/media/<file>. Установите WHATSAPP_IGNORE_STATUS_MEDIA=true, чтобы пропустить медиа из обновлений. С автозагрузкой вместо этого используется URL-адрес CDN WhatsApp. Загрузите GOWA, который расшифрует файл:
WhatsApp сохраняет мультимедиа на своих серверах в ограниченное время. Скачайте то, что вам нужно. На GOWA main после v9.9.0 явные загрузки и перенаправления могут попросить телефон повторно загружать просроченные носители. Телефон должен быть онлайн и все еще иметь файл. GOWA ожидает ответа до 30 секунд. Также это применимо к действиям download_media MCP и forward, а также к импортам истории Чатвута.

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

Пути относятся к каталогу процесса, обычно src/ из исходного кода или /app в Docker. Составляйте монтирование каталогов storages/ и statics/ в /app. Настройки срока хранения медиафайлов и конечной точки очистки нет. Копии изображения могут находиться и в storages/, и в statics/media/. Никогда не удаляйте весь каталог storages/, чтобы освободить место, занятое медиафайлами. Приостановить GOWA и другие записи, создать резервную копию необходимых файлов, а затем предварительно просмотреть файлы для удаления. Эти GNU находят примеры запуска из каталога установки и выберите файлы по крайней мере 31 полный срок старых.
После просмотра каждого пути замените -print на -delete в тех же командах. Сохраняйте файлы базы данных, SQLite -wal и -shm sidecars, запланированные вложения и пользовательские файлы. Перезапустите GOWA после. Удаленные пути и статические URL-адреса перестают работать, а удаление медиа-файлов не приводит к изменению истории чата. WHATSAPP_AUTO_DOWNLOAD_MEDIA=false останавливает будущие автоматические загрузки и дополнительные копии изображений. Он не удаляет старые файлы и не предотвращает явные загрузки REST или MCP. Смотрите полное медиа хранилище и руководство по очистке. /statics остается общедоступным. Сохраненные HTML, SVG, скрипты и другие документы обслуживаются в виде вложений в application/octet-stream и nosniff. Поддерживаемые изображения байты под путями предварительного просмотра могут визуализировать внутри. Эта защита содержимого не ограничивает кто может загрузить файл. Защищайте чувствительные носители на обратном прокси.

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