Jawaban singkat
Dokumentasi Meta mencantumkan ukuran maksimum berikut untuk media WhatsApp Cloud API saat artikel ini ditulis: gambar 5 MB (JPEG, PNG, WebP statis), video 16 MB (MP4 atau 3GPP dengan H.264 dan AAC), audio 16 MB, dokumen 100 MB, stiker animasi 500 KB, dan stiker statis 100 KB. Unggah file lalu kirim media ID-nya, bukan tautan, dan pastikan MIME type sesuai dengan filenya.
Batas ukuran per jenis media
Plafon Cloud API untuk media apa pun adalah 100 MB. Sebuah file bisa memenuhi batas ukuran namun tetap ditolak karena formatnya, misalnya video yang bukan H.264 dengan audio AAC atau gambar yang bukan 8-bit RGB atau RGBA.
| Jenis media | Ukuran maksimum | Catatan |
|---|---|---|
| Gambar | 5 MB | Hanya 8-bit RGB atau RGBA |
| Video | 16 MB | Video H.264, audio AAC |
| Audio | 16 MB | AAC, AMR, MP3, M4A, OGG berkode Opus |
| Dokumen | 100 MB | File Office, PDF, dan teks |
| Stiker (animasi) | 500 KB | Hanya WebP |
| Stiker (statis) | 100 KB | Hanya WebP |
Unggah atau tautan, dan berapa lama ID berlaku
Meta menyarankan mengunggah file dan mengirim media ID-nya demi performa yang lebih baik. ID hasil unggahan berlaku 30 hari, dan ID yang diterima lewat webhook masuk berlaku 7 hari, jadi unduh file pelanggan dengan segera. URL unduhan kedaluwarsa dalam 5 menit.
Keterangan (caption) gambar, video, dan dokumen dapat mencapai 1.024 karakter. Pesan audio dan stiker tidak memiliki caption.
Kesalahan umum
- Menilai hanya dari ukuran dan mengabaikan codec atau format warna.
- Menyajikan file dengan MIME type yang tidak sesuai, penyebab umum error 131053.
- Mengandalkan media ID yang berumur lebih dari 30 hari.
- Mengirim WebP animasi sebagai gambar, yang akan ditolak.
Sumber resmi
- Media — WhatsApp Business Platform, Meta for Developers
- Image messages — WhatsApp Business Platform, Meta for Developers
- Video messages — WhatsApp Business Platform, Meta for Developers
- Document messages — WhatsApp Business Platform, Meta for Developers
- Error codes — WhatsApp Business Platform, Meta for Developers