> ## 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 MB |
| ドキュメント (`/send/file`) | 50 MB |
| ビデオ | 100 MB |
| ダウンロードしたメディア (受信) | 500 MB |

HTTP リクエストボディの制限は動画制限(100 MB)に等しくなるため、アップロードは動画制限を超えることはできません。 `GET /app/info` (`max_image_size`, `max_file_size`, `max_video_size`)でライブの値をクエリします。これらの制限はコンパイルされたデフォルトです。環境変数はありません。

## メディアを提供する2つの方法

すべてのメディアエンドポイントは、マルチパートファイルまたはGOWAがサーバーサイドをフェッチするURLのいずれかを受け付けます:

```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
```

両方ではなく、1つまたはもう1つを送信します。リモートメディアURLはHTTPまたはHTTPSを使用し、パブリックアドレスに解決する必要があります。 GOWAは、ループバック、プライベート、リンクローカル、およびその他の予約先(リダイレクトターゲットを含む)をブロックします。内部URLを使用する代わりに、ローカルファイルをマルチパートデータとしてアップロードします。

## 処理中

GOWAではホスト上にFFmpegとlibwebpが必要です(どちらもDockerイメージに含まれています)。

| Option | Endpoint | 効果 |
| - | - | - |
| `compress` | image (default `true`), video (default `false`) | 送信する前に再エンコードしてください。 |
| `hd` | 画像、ビデオ | 拡大縮小せずに HD で送信します。画像の長さは 2560 px までで、H.264 は 1280 × 1280 でキャップされています。`compress` を上書きします。 |
| `view_once` | 画像、ビデオ | 受信者は一度開くことができます。 |
| `gif_playback` | ビデオ | ループGIFとして再生します。 |
| `ptt` | 音声 | 音声メモ(プッシュトゥトーク)として送信します。FFmpegで変換します。 |
| （自動） | ステッカー | JPG、PNG、WebPまたはGIFは512×512 WebPステッカーに変換されます。 アニメーションWebPはWhatsAppのステッカー制限を満たす必要があります。 |

`/send/file` は変換なしでドキュメントを送信します。

画像処理では、デコード前にヘッダーの寸法を確認します。受け付ける最長辺は 32,768 ピクセルです。JPEG 以外の画像には 40 メガピクセルの上限があります。JPEG には 80 メガピクセルの上限に加え、デコード用メモリに 320 MiB の上限があるため、大きなプログレッシブ JPEG や CMYK JPEG の一部は、ピクセル数が上限未満でも拒否されます。元画像の送信では、デコードが上限を超える場合にサムネイルを省略することがあります。インタラクティブカルーセルの画像には別途、より小さい上限があります。[インタラクティブメッセージ](https://gowa-docs.mintlify.site/ja/examples/interactive-messages.md)を参照してください。

## メディアの着信

`WHATSAPP_AUTO_DOWNLOAD_MEDIA=true`（デフォルト）では、GOWAは受信したメッセージから`statics/media/`へメディアをダウンロードし、webhookペイロードの相対パスを設定します。

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

`http://<host>:3000/statics/media/<file>`で取得します。ステータスの更新からメディアをスキップするには、`WHATSAPP_IGNORE_STATUS_MEDIA=true` を設定します。

自動ダウンロードをオフにすると、ペイロードは代わりにWhatsAppのCDNのURLを運びます。

```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は限られた時間のためにそのサーバー上のメディアを保持します. あなたが必要とするものを速やかにダウンロード.

v9.9.0以降のGOWA `main` では、明示的なダウンロードと転送が期限切れのメディアの再アップロードを電話に依頼できます。 携帯電話はオンラインであり、まだファイルを持っている必要があります。 応答までに最大30秒待機します。 これは、MCP の `download_media` と `forward` アクション、 [Chatwoot ヒストリインポート](https://gowa-docs.mintlify.site/ja/integrations/chatwoot.md#%E3%82%A4%E3%83%B3%E3%83%9D%E3%83%BC%E3%83%88%E5%B1%A5%E6%AD%B4) にも適用されます。

## ストレージとクリーンアップ

パスは、Dockerのプロセスディレクトリ、通常はソースから`src/`、または`/app`への相対パスです。リポジトリの`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`サイドカー、スケジュールされた添付ファイル、およびカスタムファイルを保存します。 後で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` の添付ファイルとして提供されます。 image-preview パスでサポートされている画像バイトは、インラインをレンダリングできます。 これらのコンテンツ保護はファイルをダウンロードできるユーザーを制限しません。リバースプロキシで敏感なメディアを保護してください。

## トラブルシューティング

| 問題 | 修正 |
| - | - |
| `413` または body-limit エラー | ファイルが100MBを超えています。代わりにリンクを送信してください。 |
| 音声メモが失敗またはファイルとして再生されます。 | FFmpeg; `ptt=true`を設定します。 |
| ステッカーの変換に失敗しました | libwebp ツール(`cwebp`, `dwebp`, `webpmux`)をインストールします。 |
| URL メディアが失敗しました | URLはpublicで、ファイルを直接返す(HTMLページなし)。サイズ制限に合う必要があります。 |


## Related topics

- [メッセージからメディアをダウンロード](https://gowa-docs.mintlify.site/ja/api-reference/message/メッセージからメディアをダウンロード.md)
- [ニュースレターメッセージからメディアをダウンロード](https://gowa-docs.mintlify.site/ja/api-reference/newsletter/ニュースレターメッセージからメディアをダウンロード.md)
- [Webhooks](https://gowa-docs.mintlify.site/ja/concepts/webhooks.md)
- [WhatsAppチャンネル](https://gowa-docs.mintlify.site/ja/examples/newsletters.md)
- [メッセージを送信中](https://gowa-docs.mintlify.site/ja/examples/sending-messages.md)


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