انتقل إلى المحتوى
OmniChannels.ai
القائمة

WhatsApp Business API

ما حدود حجم ملفات الوسائط في واجهة WhatsApp API؟

آخر تحديث

الإجابة المختصرة

تحدد وثائق Meta هذه الأحجام القصوى لوسائط WhatsApp Cloud API وقت كتابة هذا المحتوى: الصور 5 ميغابايت (JPEG وPNG وWebP ثابت)، والفيديو 16 ميغابايت (MP4 أو 3GPP بترميز H.264 وAAC)، والصوت 16 ميغابايت، والمستندات 100 ميغابايت، والملصقات المتحركة 500 كيلوبايت والثابتة 100 كيلوبايت. ارفع الملف وأرسل معرّف الوسائط بدلاً من الرابط، وتأكد من تطابق نوع MIME مع الملف.

حدود الحجم حسب نوع الوسائط

الحد الأقصى في Cloud API لأي وسائط هو 100 ميغابايت. وقد يستوفي الملف حد الحجم ويُرفض مع ذلك بسبب صيغته، مثل فيديو ليس بترميز H.264 مع صوت AAC، أو صورة ليست RGB أو RGBA بعمق 8 بتات.

نوع الوسائطالحجم الأقصىملاحظات
صورة5 ميغابايتRGB أو RGBA بعمق 8 بتات فقط
فيديو16 ميغابايتفيديو H.264 وصوت AAC
صوت16 ميغابايتAAC وAMR وMP3 وM4A وOGG بترميز Opus
مستند100 ميغابايتملفات Office وPDF والنصوص
ملصق (متحرك)500 كيلوبايتWebP فقط
ملصق (ثابت)100 كيلوبايتWebP فقط

الرفع أو الرابط، ومدة صلاحية المعرّفات

توصي Meta برفع الملف وإرسال معرّف الوسائط لأداء أفضل. تبقى المعرّفات الناتجة عن الرفع صالحة 30 يوماً، والمعرّفات المستلمة في webhooks الواردة 7 أيام، لذا نزّل ملفات العملاء سريعاً. وينتهي رابط التنزيل بعد 5 دقائق.

يمكن أن تصل تعليقات الصور والفيديو والمستندات إلى 1,024 حرفاً. أما رسائل الصوت والملصقات فلا تحتمل تعليقاً.

أخطاء شائعة

  • الحكم بالحجم وحده وتجاهل الترميز أو صيغة الألوان.
  • تقديم ملف بنوع MIME لا يطابقه، وهو سبب معتاد للخطأ 131053.
  • الاعتماد على معرّف وسائط مضى عليه أكثر من 30 يوماً.
  • إرسال WebP متحرك كصورة، فيُرفض.

المصادر الرسمية