Mengirim media: gambar, video, audio, dan dokumen
Media dikirim dengan mengunggah file terlebih dahulu lalu merujuk ID yang dikembalikan, atau memberikan tautan publik kepada Meta untuk mengambilnya. Mengunggah lebih andal, dan batas ukurannya berbeda menurut jenis media sehingga sering mengecoh.
Batas menurut jenis media
Batasnya berbeda untuk setiap jenis, dan pelampauan batas mengembalikan kesalahan 131053 tanpa penjelasan yang jelas.
- Gambar: 5 MB. JPEG dan PNG.
- Video: 16 MB. MP4 dan 3GPP, dengan video H.264 dan audio AAC.
- Audio: 16 MB. AAC, AMR, MP3, audio MP4, dan OGG dengan Opus.
- Dokumen: 100 MB. Sebagian besar jenis dokumen umum, termasuk format PDF dan Office.
- Stiker: 100 KB animasi, 500 KB statis, hanya WebP.
Mengunggah dibandingkan menggunakan tautan
Ada dua cara untuk mengirim file yang sama, dan kegagalannya berbeda.
Mengunggah mem-posting file ke Meta terlebih dahulu dan mengembalikan ID media yang Anda rujuk saat mengirim. Menggunakan tautan memberikan URL kepada Meta untuk diambil saat pengiriman. Cara menggunakan tautan terlihat lebih sederhana, tetapi menambahkan jenis kegagalan yang tidak dapat Anda lihat: URL yang dimuat di browser Anda mungkin tidak dapat dijangkau dari infrastruktur Meta karena faktor geografis, aturan firewall, atau cookie sesi yang sudah dimiliki browser Anda.
Unggah file. Ini hanya menambah satu permintaan dan menghilangkan seluruh kategori kegagalan.
Menerima media
Media masuk diterima sebagai ID media, bukan byte. Penangan Anda mengambil file secara terpisah menggunakan ID tersebut.
- Segera ambil. ID tidak tetap valid selamanya.
- Pengambilan yang gagal mengembalikan kesalahan 131052, yang biasanya berarti unggahan pengirim tidak selesai.
- Simpan file sendiri jika Anda membutuhkannya nanti. Meta bukan arsip.
- Catat pesan meskipun pengambilan media gagal, agar teks dan konteks tetap tersimpan.
Perubahan yang dibawa Coexistence
Media pada nomor Coexistence bekerja sama seperti pada nomor Cloud API lainnya, dengan batas yang sama.
Satu perbedaan penting adalah riwayat. Saat nomor pertama kali terhubung, Meta menyinkronkan pesan terbaru dari aplikasi WhatsApp Business, dan sinkronisasi tersebut mencakup teks pesan, bukan arsip media lengkap. Media dari sebelum koneksi tetap berada di ponsel, seperti sebelumnya.
Kesalahan umum
- Mengirim tautan karena terlihat lebih sederhana. Jaringan Meta bukan browser Anda.
- Mengambil media masuk beberapa jam kemudian. ID media kedaluwarsa.
- Mengekspor video tanpa memeriksa codec. Bawaan perangkat lunak penyuntingan sering kali tidak didukung.
EasyCoexistence mengirimkan event pesan masuk langsung dari Meta ke endpoint Anda, sehingga ID media segera sampai ke sistem dan dapat diambil saat masih valid.
Pertanyaan yang sering diajukan
Apa file terbesar yang dapat saya kirim?
100 MB, dan hanya untuk dokumen. Video dan audio dibatasi 16 MB, sedangkan gambar 5 MB.
Sebaiknya saya mengunggah file atau mengirim URL?
Unggah file. Ini menghilangkan keterjangkauan URL sebagai penyebab kegagalan.
Berapa lama ID media valid?
Tidak selamanya. Karena itu, media masuk harus diambil segera setelah event tiba.
Apakah media lama ikut disinkronkan saat saya terhubung?
Tidak. Sinkronisasi riwayat mencakup isi pesan terbaru; media dari sebelum koneksi tetap berada di ponsel.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada