--- title: "Media di API WhatsApp: Jenis File dan Batas Ukuran" description: "Batas ukuran dan jenis file media di API WhatsApp untuk gambar, video, audio, dokumen, dan stiker, plus perbedaan unggah vs tautan, media ID, dan caption." canonical: "https://omnichannels.ai/id/blog/whatsapp-media-messages-file-types-size-limits/" language: "id" updated: "2026-11-07" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "batas ukuran file api whatsapp" keywords: ["jenis file yang didukung api whatsapp", "media whatsapp cloud api", "batas ukuran video whatsapp", "batas ukuran dokumen whatsapp", "ukuran stiker whatsapp", "masa berlaku media id whatsapp", "gambar header template whatsapp", "error 131053 whatsapp"] published: "2026-11-07" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "Dokumentasi Meta mencantumkan ukuran maksimum media WhatsApp Cloud API berikut pada 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, bukan tautan, dan pastikan tipe MIME sesuai dengan file." takeaways: ["Menurut dokumentasi Meta saat artikel ini ditulis, batas ukurannya adalah 5 MB untuk gambar, 16 MB untuk video dan audio, 100 MB untuk dokumen, serta 500 KB (animasi) atau 100 KB (statis) untuk stiker.", "Video harus H.264 dengan audio AAC, dan gambar harus 8-bit RGB atau RGBA; file yang memenuhi batas ukuran tetap bisa ditolak karena codec atau format warnanya.", "Meta menyarankan mengirim media yang sudah diunggah menggunakan ID, bukan tautan, demi performa yang lebih baik.", "Media ID dari hasil unggah kedaluwarsa setelah 30 hari, sedangkan ID yang diterima dari webhook pesan masuk kedaluwarsa setelah 7 hari, jadi segera unduh file dari pelanggan.", "Caption gambar, video, dan dokumen dibatasi 1.024 karakter, dan error 131053 biasanya menandakan tipe MIME yang tidak sesuai dengan file."] faq: - q: "Berapa batas ukuran file di API WhatsApp?" a: "Tergantung jenisnya. Dokumentasi Meta mencantumkan 5 MB untuk gambar, 16 MB untuk video dan audio, 100 MB untuk dokumen, serta 500 KB untuk stiker animasi atau 100 KB untuk stiker statis. Batas atas media di Cloud API adalah 100 MB. Batas dapat berubah, jadi pastikan di referensi media Meta terbaru sebelum membuat aturan validasi." - q: "Jenis file apa saja yang didukung WhatsApp Business API?" a: "Gambar: JPEG, PNG, dan WebP statis. Video: MP4 dan 3GPP dengan video H.264 dan audio AAC. Audio: AAC, AMR, MP3, M4A, dan OGG berkode Opus. Dokumen: TXT, XLS, XLSX, DOC, DOCX, PPT, PPTX, dan PDF. Stiker: hanya WebP. Format di luar daftar ini ditolak, jadi konversikan dulu sebelum mengirim." - q: "Sebaiknya kirim media lewat tautan atau media ID?" a: "Dokumentasi Meta menyarankan media ID hasil unggah demi performa yang lebih baik. Tautan harus mengarah ke file di server publik, sehingga platform perlu mengambilnya saat pengiriman. ID merujuk ke file yang sudah tersimpan di Meta. ID dari hasil unggah berlaku 30 hari, setelah itu Anda harus mengunggah ulang." - q: "Berapa lama media ID WhatsApp berlaku?" a: "Meta mendokumentasikan 30 hari untuk ID yang dikembalikan saat Anda mengunggah media, dan 7 hari untuk media ID yang diterima dari webhook pesan masuk. File yang diunggah disimpan 30 hari kecuali dihapus lebih awal. URL unduhan dari sebuah media ID kedaluwarsa setelah 5 menit, jadi minta URL baru setiap kali Anda membutuhkan file tersebut." - q: "Bisakah saya menambahkan caption ke gambar atau video WhatsApp?" a: "Bisa. Referensi pesan Meta mencantumkan caption opsional hingga 1.024 karakter untuk pesan gambar, video, dan dokumen. Pesan audio dan stiker tidak memiliki caption. Jika perlu teks bersama stiker atau pesan suara, kirim pesan teks terpisah setelahnya." - q: "Apa arti error 131053 di WhatsApp?" a: "Meta menjelaskannya sebagai kegagalan mengunggah media yang dipakai dalam pesan. Penyebab yang umum adalah tipe MIME yang tidak cocok dengan ekstensi file, atau tipe yang tidak didukung. Periksa detail error di webhook terkait, cocokkan format dengan tipe media yang didukung Meta, lalu enkode ulang file jika perlu." sources: - title: "Media — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media" - title: "Image messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages" - title: "Video messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages" - title: "Document messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages" - title: "Error codes — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes" --- # Media di API WhatsApp: Jenis File dan Batas Ukuran Canonical: https://omnichannels.ai/id/blog/whatsapp-media-messages-file-types-size-limits/ Language: id Publisher: OmniChannels.ai by BroadNet Technologies Panduan ini ditujukan bagi developer dan marketer yang mengirim gambar, video, audio, dokumen, atau stiker lewat WhatsApp Business API dan ingin menghindari pengiriman yang gagal. Panduan ini mencantumkan jenis file dan batas ukuran yang didokumentasikan Meta, menjelaskan unggah vs tautan, media ID, caption, dan header template, serta menunjukkan cara menangani file yang dikirim pelanggan kepada Anda. Semua angka di bawah adalah nilai yang didokumentasikan Meta saat artikel ini ditulis (7 November 2026). Meta dapat mengubahnya, jadi jadikan [referensi media](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media) sebagai acuan utama. ## Apa saja batas ukuran media di API WhatsApp? Setiap jenis media punya batas sendiri, dan batas atas Cloud API untuk media apa pun adalah 100 MB. Dokumen mendapat ruang terbesar, stiker paling kecil. | 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 | Beberapa format, lihat di bawah | | Dokumen | 100 MB | File Office, PDF, dan teks | | Stiker (animasi) | 500 KB | Hanya WebP | | Stiker (statis) | 100 KB | Hanya WebP | File bisa memenuhi batas ukuran tetapi tetap gagal karena formatnya. Bagian berikut mencantumkan format yang diterima untuk tiap jenis. ## Format gambar dan stiker apa yang didukung? Gambar bisa berupa JPEG, PNG, atau WebP statis, hingga 5 MB, dan harus 8-bit RGB atau RGBA. Stiker harus berformat WebP. | Jenis | Ekstensi | Tipe MIME | |---|---|---| | JPEG | .jpeg | `image/jpeg` | | PNG | .png | `image/png` | | WebP statis | .webp | `image/webp` | Meta mendokumentasikan tiga aturan lain untuk gambar. WebP statis yang dikirim dalam pesan gambar ditranskode ke JPEG. File WebP animasi, WebP yang tidak dapat didekode, dan gambar dengan sisi lebih dari 4.096 piksel ditolak. Untuk stiker, gunakan WebP dengan `image/webp`: hingga 500 KB jika animasi dan 100 KB jika statis. Jika aset merek Anda berupa PNG besar dari aplikasi desain, ekspor JPEG berukuran web alih-alih mengirim file aslinya. ## Format video dan audio apa yang didukung? Video berupa MP4 atau 3GPP hingga 16 MB. Audio bisa AAC, AMR, MP3, M4A, atau OGG berkode Opus, juga hingga 16 MB. | Jenis | Ekstensi | Tipe MIME | |---|---|---| | Video MP4 | .mp4 | `video/mp4` | | Video 3GPP | .3gp | `video/3gpp` | | Audio AAC | .aac | `audio/aac` | | Audio AMR | .amr | `audio/amr` | | Audio MP3 | .mp3 | `audio/mpeg` | | Audio MP4 | .m4a | `audio/mp4` | | Audio OGG | .ogg | `audio/ogg` | Untuk video, Meta mewajibkan codec H.264 dan audio AAC, dengan satu aliran audio atau tanpa audio. Meta juga tidak menyarankan profil H.264 "High" dengan B-frame karena klien WhatsApp Android tidak mendukungnya; gunakan "Main" tanpa B-frame, atau "Baseline". Tempatkan box `moov` sebelum box `mdat`, yang di ffmpeg berarti memakai opsi `-movflags faststart`. Untuk OGG, hanya codec Opus yang didukung, tipe dasar `audio/ogg` tidak, dan inputnya harus mono. ## Format dokumen apa yang didukung? Dokumen bisa berupa PDF, Word, Excel, PowerPoint, atau teks biasa, hingga 100 MB. | Jenis | Ekstensi | Tipe MIME | |---|---|---| | PDF | .pdf | `application/pdf` | | Word | .doc, .docx | `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | | Excel | .xls, .xlsx | `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | | PowerPoint | .ppt, .pptx | `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation` | | Teks | .txt | `text/plain` | Pesan dokumen menerima nama file opsional beserta ekstensinya, dan aplikasi WhatsApp memilih ikon file berdasarkan ekstensi tersebut. Pilih nama yang mudah dibaca seperti `invoice-2026-1042.pdf`, karena pelanggan melihatnya. ## Sebaiknya unggah media atau kirim tautan? Meta menyarankan mengunggah file lalu mengirim media ID-nya. Anda juga bisa mengirim tautan ke file di server publik, tetapi referensi Meta untuk gambar, video, dan dokumen menyarankan ID hasil unggah demi performa yang lebih baik, dan panduan throughput-nya mengatakan hal yang sama untuk volume yang lebih besar. | | Media ID | Tautan | |---|---|---| | Cara kerja | Unggah dulu, lalu rujuk ID yang dikembalikan | Arahkan ke URL publik; file diambil saat Anda mengirim | | Panduan Meta | Disarankan | Didukung, tidak disarankan | | Masa berlaku | 30 hari sejak unggah | Selama server Anda menyajikan file | | Mode kegagalan | ID kedaluwarsa atau tidak valid | URL tidak terjangkau, lambat, atau tipenya salah | Dengan endpoint Meta sendiri, unggah berupa `POST` ke `//media` dengan file, tipe MIME-nya, dan `messaging_product=whatsapp`, dan responsnya `{"id": ""}`. File yang diunggah dienkripsi dan disimpan 30 hari kecuali Anda menghapusnya lebih awal. Pada endpoint WhatsApp OmniChannels.ai, pesan media menerima `mediaUrl` (URL HTTPS publik) atau `mediaFile` (file yang diunggah bersama permintaan), dengan caption di `content`. Lihat [dokumentasi API WhatsApp](/developers/whatsapp/). Tanyakan kepada tim kami bagaimana akun Anda menangani penyimpanan dan penggunaan ulang media untuk pengiriman besar. ## Berapa lama media ID berlaku? Meta mendokumentasikan 30 hari untuk ID yang dikembalikan oleh unggahan dan 7 hari untuk ID yang diterima dari webhook pesan masuk. URL unduhan yang dikembalikan untuk sebuah ID kedaluwarsa setelah 5 menit. Konsekuensi praktisnya: - Jangan menyimpan media ID di cache berbulan-bulan. Simpan file asli Anda dan unggah ulang saat sebuah ID ditolak. - Unduh file masuk segera setelah event tiba dan simpan salinan Anda sendiri. - Jangan pernah menyimpan URL unduhan; minta yang baru saat dibutuhkan. ## Bisakah saya menambahkan caption pada pesan media? Bisa. Pesan gambar, video, dan dokumen menerima caption opsional hingga 1.024 karakter, menurut referensi pesan Meta. Caption berupa teks biasa di samping file. Pesan audio dan stiker tidak punya caption dalam model ini. Jika perlu kata-kata bersama pesan suara, kirim pesan teks singkat di sampingnya. Caption di dalam [jendela layanan pelanggan](/id/blog/whatsapp-24-hour-customer-service-window/) bebas; di luar jendela itu, media harus dikirim di dalam template yang disetujui. ## Bagaimana media bekerja di template pesan? Template dapat memiliki gambar, video, atau dokumen di header, dan header itu ditetapkan saat Anda membuat template. Saat mengajukan template untuk disetujui, Anda menyertakan file contoh, dan file sebenarnya bisa Anda berikan saat mengirim. Di API kami, `headerFormat` bisa `IMAGE`, `VIDEO`, atau `DOCUMENT` saat pembuatan, `headerFile` membawa contohnya, dan `mediaUrl` saat pengiriman menimpa media header. Periksa dokumentasi template Meta untuk persyaratan file contoh. Lihat [kategori dan persetujuan template](/id/blog/whatsapp-template-categories-approval/) dan [contoh template](/id/blog/whatsapp-message-template-examples/). ## Bagaimana cara mengunduh media yang dikirim pelanggan? Media masuk tiba lewat webhook dengan media ID; Anda mengubahnya menjadi URL dan mengunduhnya dengan otorisasi. 1. Baca media ID dari event pesan masuk. 2. Minta URL media untuk ID tersebut. Respons Meta mencakup `url`, `mime_type`, `sha256`, dan `file_size`. 3. Kirim `GET` ke URL itu dengan header `Authorization: Bearer `. Tanpa token, permintaan gagal. 4. Periksa header `Content-Type` dan nilai `sha256`, lalu simpan file. 5. Jika mendapat `404`, minta URL baru dan coba lagi; jika masih gagal, perbarui token akses. Ukuran maksimum media masuk dari Meta di Cloud API adalah 100 MB. File yang lebih besar memicu webhook dengan kode error `131052`; minta pelanggan mengirim file yang lebih kecil atau membagikannya dengan cara lain. Pindai setiap file sebelum membukanya secara internal. Lihat [panduan webhook](/id/blog/whatsapp-webhooks-guide/), dan konfirmasikan dengan engineer onboarding Anda bagaimana media masuk dikirimkan di akun Anda. ## Contoh kasus: klinik gigi yang mengirim laporan "Nile Smile Clinic" (sintetis) di Kairo mengirim kartu janji temu dan laporan rontgen. 1. Kartu janji temu berupa gambar PNG 300 KB dengan caption dua baris. Jauh di bawah 5 MB. 2. Laporan perawatan berupa PDF 2 hingga 8 MB, diberi nama `report-2026-0381.pdf`, dan dikirim sebagai dokumen. 3. Video tur klinik 25 MB terlalu besar untuk video. Tim mengenkode ulang menjadi MP4 H.264/AAC di bawah 16 MB dengan `faststart`. 4. Pasien mengirim foto resep. Kotak masuk mengunduh setiap file segera, karena ID masuk kedaluwarsa setelah 7 hari. 5. Sapaan suara diekspor sebagai OGG Opus mono, karena varian OGG lain ditolak. ## Apa saja kesalahan yang umum terjadi? - **Menilai dari ukuran saja.** Gambar 3 MB dengan format warna yang salah atau video dengan codec yang salah tetap gagal. - **MIME tidak cocok.** File `.jpg` yang disajikan sebagai `application/octet-stream` adalah penyebab klasik error 131053. - **Menautkan ke URL yang lambat atau privat,** seperti tautan bertanda tangan yang sudah kedaluwarsa atau halaman di balik login. - **Mengandalkan media ID lama.** ID kedaluwarsa setelah 30 hari. - **Mengabaikan kedaluwarsa ID masuk.** File pelanggan harus disimpan dalam 7 hari. - **WebP animasi sebagai gambar.** Ditolak; gunakan stiker atau video. - **Batas berubah.** Periksa ulang referensi Meta sebelum Anda menanamkan aturan validasi di kode. ## Bagaimana OmniChannels.ai membantu OmniChannels.ai mengirim pesan gambar, video, audio, dokumen, dan stiker WhatsApp lewat satu API, dengan tautan publik atau file yang diunggah beserta caption, dan menampilkan media serta lampiran di kotak masuk bersama. BroadNet adalah Meta Business Solution Provider resmi, sehingga template dengan header gambar, video, atau dokumen dapat dibuat dan dilacak beserta status persetujuannya. Baca [dokumentasi API WhatsApp](/developers/whatsapp/) dan [error dan batas](/developers/errors-and-limits/), atau lihat [kanal WhatsApp](/id/channels/whatsapp-business-api/).