Batasan
Batas ukuran body permintaan HTTP sama dengan batas video (100 MB), sehingga tidak ada unggahan yang dapat melebihinya. Periksa nilai yang sedang berlaku dengan
GET /app/info (max_image_size, max_file_size, max_video_size). Batas ini merupakan nilai default yang ditetapkan saat kompilasi; tidak ada variabel lingkungan untuk mengaturnya.
Dua cara menyediakan media
Setiap endpoint media menerima file multipart atau URL yang diambil GOWA dari sisi server:Pemrosesan
GOWA memerlukan FFmpeg dan libwebp pada host (keduanya tersedia dalam image Docker)./send/file mengirim dokumen tanpa konversi.
Pemrosesan gambar memeriksa dimensi pada header sebelum melakukan dekode. Sisi terpanjang yang diterima adalah 32,768 piksel. Gambar non-JPEG dibatasi hingga 40 juta piksel. JPEG memiliki batas 80 juta piksel serta alokasi memori dekode 320 MiB, sehingga sebagian JPEG progresif atau CMYK berukuran besar dapat ditolak meskipun jumlah pikselnya masih di bawah batas. Pengiriman gambar asli dapat tidak menyertakan thumbnail jika proses dekode melampaui alokasi tersebut. Gambar carousel interaktif memiliki batas terpisah yang lebih kecil di Pesan interaktif.
Media masuk
DenganWHATSAPP_AUTO_DOWNLOAD_MEDIA=true (default), GOWA mengunduh media dari pesan masuk ke statics/media/ dan menyertakan path relatifnya dalam payload webhook:
http://<host>:3000/statics/media/<file>. Atur WHATSAPP_IGNORE_STATUS_MEDIA=true untuk melewati media dari pembaruan status.
Jika unduhan otomatis dinonaktifkan, payload memuat URL CDN WhatsApp. Unduh melalui GOWA agar file didekripsi:
main GOWA setelah v9.9.0, permintaan unduhan dan penerusan secara eksplisit dapat meminta ponsel mengunggah ulang media yang kedaluwarsa. Ponsel harus online dan masih memiliki file tersebut. GOWA menunggu respons hingga 30 detik. Hal ini juga berlaku untuk tindakan MCP download_media dan forward, serta impor riwayat Chatwoot.
Penyimpanan dan pembersihan
Path bersifat relatif terhadap direktori proses, biasanyasrc/ saat dijalankan dari kode sumber atau /app di Docker. Compose memasang direktori storages/ dan statics/ dari repositori ke /app.
Tidak ada pengaturan retensi media berdasarkan umur maupun endpoint pembersihan. Sebuah gambar dapat memiliki salinan di
storages/ dan statics/media/. Jangan pernah menghapus seluruh direktori storages/ untuk mengosongkan ruang media.
Hentikan sementara GOWA dan proses lain yang menulis file, cadangkan file yang diperlukan, lalu tinjau daftar file yang akan dihapus. Contoh GNU find ini dijalankan dari direktori deployment dan memilih file yang berumur setidaknya 31 hari penuh.
-print dengan -delete pada perintah yang sama. Pertahankan file database, file pendamping SQLite -wal dan -shm, lampiran terjadwal, serta file kustom. Setelah itu, jalankan ulang GOWA. Path dan URL statis yang dihapus tidak lagi berfungsi, dan menghapus media tidak menghapus riwayat chat.
WHATSAPP_AUTO_DOWNLOAD_MEDIA=false menghentikan unduhan otomatis dan pembuatan salinan gambar tambahan berikutnya. Pengaturan ini tidak menghapus file lama atau mencegah unduhan eksplisit melalui REST maupun MCP. Lihat panduan penyimpanan dan pembersihan media selengkapnya.
/statics tetap bersifat publik. HTML, SVG, skrip, dan dokumen lain yang tersimpan disajikan sebagai lampiran dengan application/octet-stream dan nosniff. Data gambar yang didukung pada path pratinjau gambar dapat ditampilkan langsung. Perlindungan konten ini tidak membatasi siapa yang dapat mengunduh file. Lindungi media sensitif pada reverse proxy.
