Medya gönderme: görseller, video, ses ve belgeler
Medya iki şekilde gönderilir: dosyayı önce yükleyip döndürülen kimliğe başvurabilir veya Meta'ya alması için herkese açık bir bağlantı verebilirsiniz. Yükleme daha güvenilirdir ve boyut sınırları türe göre, beklenmedik sorunlara yol açacak şekilde değişir.
Cloud API'de görseller için boyut sınırı.
Video ve ses için boyut sınırı.
Belgeler için boyut sınırı.
Türe göre sınırlar
Her tür için farklıdır. Sınırı aşmak, açıklayıcı bir yanıt yerine 131053 hata kodunu döndürür.
- Görseller: 5 MB. JPEG ve PNG.
- Video: 16 MB. H.264 video ve AAC ses içeren MP4 ve 3GPP.
- Ses: 16 MB. AAC, AMR, MP3, MP4 ses ve Opus içeren OGG.
- Belgeler: 100 MB. PDF ve Office biçimleri dahil en yaygın belge türleri.
- Çıkartmalar: animasyonlu 100 KB, statik 500 KB, yalnızca WebP.
Yükleme ve bağlantı verme
Aynı dosyayı göndermenin iki yolu vardır ve farklı şekillerde başarısız olurlar.
Yükleme, dosyayı önce Meta'ya gönderir ve gönderim sırasında başvuracağınız bir medya kimliği döndürür. Bağlantı vermek ise Meta'ya gönderim sırasında alacağı bir URL sağlamaktır. Bağlantı yolu daha basit görünür, ancak göremediğiniz bir hata olasılığı ekler: tarayıcınızda açılan bir URL, coğrafi kısıt, güvenlik duvarı kuralı veya tarayıcınızın zaten tuttuğu oturum çerezi nedeniyle Meta'nın altyapısından erişilemez olabilir.
Yükleyin. Bu, yalnızca bir ek istek oluşturur ve bütünüyle bir hata sınıfını ortadan kaldırır.
Medya alma
Gelen medya, baytlar yerine bir medya kimliği olarak gelir. İşleyiciniz, bu kimliği kullanarak dosyayı ayrı bir istekle alır.
- Hemen alın. Kimlikler süresiz olarak geçerli kalmaz.
- Başarısız bir alma işlemi 131052 hata kodunu döndürür. Bu genellikle gönderenin yüklemesinin tamamlanmadığı anlamına gelir.
- Daha sonra ihtiyacınız olacaksa dosyayı kendiniz saklayın. Meta bir arşiv değildir.
- Medya alınamasa bile mesajı kaydedin; böylece metin ve bağlam korunur.
Coexistence neyi değiştirir
Coexistence numarasındaki medya, aynı sınırlarla diğer tüm Cloud API numaralarındaki gibi çalışır.
Bilinmesi gereken tek fark geçmişle ilgilidir. Bir numara ilk kez bağlandığında Meta, WhatsApp Business uygulamasındaki son mesajları senkronize eder. Bu senkronizasyon, tam bir medya arşivi yerine mesaj metnini kapsar. Bağlantıdan önceki medya, her zaman olduğu gibi telefonda kalır.
Yaygın hatalar
- Daha basit göründüğü için bağlantı göndermek. Meta'nın ağı sizin tarayıcınız değildir.
- Gelen medyayı saatler sonra almak. Medya kimliklerinin süresi dolar.
- Codec'i kontrol etmeden video dışa aktarmak. Düzenleme yazılımlarının varsayılanları çoğu zaman desteklenmez.
EasyCoexistence, gelen mesaj olaylarını doğrudan Meta'dan uç noktanıza iletir. Böylece medya kimlikleri sisteminize hemen ulaşır ve geçerlilikleri sürerken alınabilir.
Sık sorulan sorular
Gönderebileceğim en büyük dosya nedir?
100 MB ve yalnızca belgeler için. Video ve ses 16 MB, görseller 5 MB ile sınırlıdır.
Yükleme mi yapmalıyım, yoksa URL mi göndermeliyim?
Yükleyin. Erişilebilirlik sorunlarını bir hata nedeni olmaktan çıkarır.
Bir medya kimliği ne kadar süre geçerlidir?
Süresiz değildir. Bu nedenle gelen medya, olay ulaşır ulaşmaz alınmalıdır.
Bağlandığımda eski medya senkronize edilir mi?
Hayır. Geçmiş senkronizasyonu son mesaj içeriğini kapsar; bağlantıdan önceki medya telefonda kalır.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi