Kısa yanıt
Meta'nın belgeleri, yazı tarihinde WhatsApp Cloud API medyası için şu azami boyutları listeler: görsel 5 MB (JPEG, PNG, statik WebP), video 16 MB (H.264 ve AAC'li MP4 veya 3GPP), ses 16 MB, belge 100 MB, animasyonlu çıkartma 500 KB ve statik çıkartma 100 KB. Bağlantı yerine dosyayı yükleyip medya kimliğini gönderin ve MIME türünün dosyayla eşleştiğini kontrol edin.
Medya türüne göre boyut sınırları
Cloud API'de herhangi bir medya için üst sınır 100 MB'tır. Bir dosya boyut sınırını karşılasa da biçimi nedeniyle reddedilebilir; örneğin H.264 ve AAC sesli olmayan bir video veya 8 bit RGB ya da RGBA olmayan bir görsel.
| Medya türü | Azami boyut | Notlar |
|---|---|---|
| Görsel | 5 MB | Yalnızca 8 bit RGB veya RGBA |
| Video | 16 MB | H.264 video, AAC ses |
| Ses | 16 MB | AAC, AMR, MP3, M4A, Opus kodlu OGG |
| Belge | 100 MB | Office, PDF ve metin dosyaları |
| Çıkartma (animasyonlu) | 500 KB | Yalnızca WebP |
| Çıkartma (statik) | 100 KB | Yalnızca WebP |
Yükleme mi bağlantı mı, kimlikler ne kadar geçerli?
Meta, daha iyi performans için dosyayı yükleyip medya kimliğini göndermeyi önerir. Yüklemeden dönen kimlikler 30 gün, gelen webhook'larda alınan kimlikler 7 gün geçerlidir; bu yüzden müşteri dosyalarını hemen indirin. İndirme URL'si 5 dakika sonra sona erer.
Görsel, video ve belge açıklamaları 1.024 karaktere kadar olabilir. Ses ve çıkartma mesajlarında açıklama yoktur.
Sık yapılan hatalar
- Yalnızca boyuta bakıp codec veya renk biçimini göz ardı etmek.
- Dosyayla eşleşmeyen bir MIME türüyle sunmak; 131053 hatasının olağan nedenidir.
- 30 günden eski bir medya kimliğine güvenmek.
- Animasyonlu WebP'yi görsel olarak göndermek; reddedilir.
Resmî kaynaklar
- 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