制限
HTTP リクエストボディの制限は動画制限(100 MB)に等しくなるため、アップロードは動画制限を超えることはできません。
GET /app/info (max_image_size, max_file_size, max_video_size)でライブの値をクエリします。これらの制限はコンパイルされたデフォルトです。環境変数はありません。
メディアを提供する2つの方法
すべてのメディアエンドポイントは、マルチパートファイルまたはGOWAがサーバーサイドをフェッチするURLのいずれかを受け付けます:処理中
GOWAではホスト上にFFmpegとlibwebpが必要です(どちらもDockerイメージに含まれています)。/send/file は変換なしでドキュメントを送信します。
画像処理では、デコード前にヘッダーの寸法を確認します。受け付ける最長辺は 32,768 ピクセルです。JPEG 以外の画像には 40 メガピクセルの上限があります。JPEG には 80 メガピクセルの上限に加え、デコード用メモリに 320 MiB の上限があるため、大きなプログレッシブ JPEG や CMYK JPEG の一部は、ピクセル数が上限未満でも拒否されます。元画像の送信では、デコードが上限を超える場合にサムネイルを省略することがあります。インタラクティブカルーセルの画像には別途、より小さい上限があります。インタラクティブメッセージを参照してください。
メディアの着信
WHATSAPP_AUTO_DOWNLOAD_MEDIA=true(デフォルト)では、GOWAは受信したメッセージからstatics/media/へメディアをダウンロードし、webhookペイロードの相対パスを設定します。
http://<host>:3000/statics/media/<file>で取得します。ステータスの更新からメディアをスキップするには、WHATSAPP_IGNORE_STATUS_MEDIA=true を設定します。
自動ダウンロードをオフにすると、ペイロードは代わりにWhatsAppのCDNのURLを運びます。
main では、明示的なダウンロードと転送が期限切れのメディアの再アップロードを電話に依頼できます。 携帯電話はオンラインであり、まだファイルを持っている必要があります。 応答までに最大30秒待機します。 これは、MCP の download_media と forward アクション、 Chatwoot ヒストリインポート にも適用されます。
ストレージとクリーンアップ
パスは、Dockerのプロセスディレクトリ、通常はソースからsrc/、または/appへの相対パスです。リポジトリのstorages/とstatics/ディレクトリを/appにマウントします。
年齢ベースのメディア保持設定またはクリーンアップエンドポイントはありません。イメージは
storages/ と statics/media/ の両方にコピーを持つことができます。 メディア領域を取り戻すには、storages/ディレクトリ全体を削除しないでください。
GOWAや他のライターを一時停止し、必要なファイルをバックアップし、削除するファイルをプレビューします。 これらの GNU では、デプロイメント・ディレクトリから実行されるサンプルを見つけて、少なくとも丸31日前のファイルを選択します。
-printを-deleteに置き換えます。データベースファイルを保持するには、SQLite -walと-shmサイドカー、スケジュールされた添付ファイル、およびカスタムファイルを保存します。 後でGOWAを再起動します。削除されたパスと静的URLは動作を停止し、メディアの削除はチャット履歴を削除しません。
WHATSAPP_AUTO_DOWNLOAD_MEDIA=false を設定すると、以後の自動ダウンロードと追加の画像コピーが停止します。既存のファイルは削除されず、REST や MCP から明示的に行うダウンロードも妨げません。詳細はメディアストレージとクリーンアップのガイドを参照してください。
/statics は公開されたままです。保存された HTML、SVG、スクリプト、およびその他のドキュメントは、 application/octet-stream と nosniff の添付ファイルとして提供されます。 image-preview パスでサポートされている画像バイトは、インラインをレンダリングできます。 これらのコンテンツ保護はファイルをダウンロードできるユーザーを制限しません。リバースプロキシで敏感なメディアを保護してください。
