خطأ 131053 في واتساب API (تعذّر رفع الميديا): السبب والحل خطوة بخطوة

آخر تحديث: 4 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: صفحة أكواد الأخطاء وتوثيق الميديا من Meta

الإجابة المختصرة: الخطأ 131053 معناه أن Meta تعذّر عليها رفع الميديا المستخدمة في رسالتك. ومن أسبابه الشائعة حسب Meta نوع ملف غير مدعوم أو لا يطابق امتداده، مثل فيديو MOV من آيفون، وقد يظهر عندما لا تصل Meta إلى رابط الملف. الحل: اقرأ حقل التفاصيل، وحوّل الملف لصيغة مدعومة (الفيديو MP4 بترميز H.264 حتى 16 ميجابايت)، واجعل الرابط عاماً ومباشراً، أو أرسل برقم ميديا كما توصي Meta.

محتوى المقال:

ما معنى الخطأ 131053 في واتساب API؟

في صفحة أكواد الأخطاء الرسمية من Meta يقع الكود 131053 في جدول «أخطاء أخرى» بالتفاصيل «Unable to upload the media used in the message.»، أي: تعذّر رفع الميديا المستخدمة في الرسالة. وتشرح Meta أن الرفع قد يفشل لسبب أو أكثر، مثل نوع ميديا غير مدعوم، وأن السبب بالتفصيل في الحقل error_data.details داخل Webhook الرسائل الذي يصلك عند فشل الإرسال.

المصدر ماذا يقول عن 131053؟ ماذا تفعل؟
صفحة أكواد الأخطاءالرفع فشل لسبب أو أكثر، مثل نوع غير مدعوم، والسبب في error_data.detailsافحص الملف وتأكد أن نوعه (MIME) من الأنواع المدعومة
توثيق الميدياعدم تطابق نوع MIME خطأ شائع يظهر بالكود 131053اجعل امتداد الملف يعكس نوعه الحقيقي، وافحصه بالأمر file -I
سجل تغييرات Meta (2 فبراير 2023)عنوان الخطأ صار Media upload errorابنِ معالجتك على رقم الكود لا على العنوان

حسب صفحة أكواد الأخطاء وتوثيق الميديا وسجل التغييرات من Meta (اطّلعنا عليها في 4 نوفمبر 2026).

  • أين يظهر؟ قد يرجع في رد طلب الإرسال مباشرة، أو يقبل الـ API الطلب ثم يصلك Webhook بحالة failed فيه الكود والعنوان والرسالة وحقل التفاصيل، كما يصف مرجع Webhook الحالة من Meta.
  • مثال حقيقي: في مجتمع مطوري Meta (16 يونيو 2026) نشر مطورون تفاصيل الخطأ هكذا: Downloading media from weblink failed with http code 502، أي أن جلب الملف من الرابط فشل، وعاد الإرسال يعمل في اليوم نفسه حسب المشاركين.

ما أنواع الميديا وأحجامها المسموحة في واتساب API؟

أي ملف خارج هذا الجدول، أو داخله لكن بشروط مختلفة، مرشح للخطأ 131053:

النوع الصيغ الحد الأقصى شروط Meta الإضافية
صورةJPEG, PNG, WebP5 ميجابايت8-bit بألوان RGB أو RGBA، وأقصى ضلع 4,096 بكسل، وWebP المتحركة مرفوضة والثابتة تُحوَّل إلى JPEG
فيديوMP4, 3GPP16 ميجابايتترميز فيديو H.264 وصوت AAC فقط، ومسار صوت واحد أو بلا صوت
صوتAAC, AMR, MP3, M4A, OGG16 ميجابايتملف OGG بترميز OPUS فقط وبقناة واحدة (mono)
مستندPDF, DOC(X), XLS(X), PPT(X), TXT100 ميجابايت—
ملصقWebP100 كيلوبايت ثابت، 500 كيلوبايت متحرك—

حسب جدول الأنواع المدعومة في توثيق الميديا من Meta (اطّلعنا عليه في 4 نوفمبر 2026).

وفي الفيديو توصي Meta بملف H.264 «Main» بدون B-frames أو «Baseline»، وبالخيار -movflags faststart في ffmpeg، لأن ملف «High» مع B-frames لا تدعمه تطبيقات واتساب على أندرويد.

ما أسباب الخطأ 131053؟ 7 أسباب وحل كل منها

السبب مثال من الواقع الحل
امتداد لا يطابق المحتوىصورة HEIC من آيفون غُيّر اسمها إلى photo.jpgحوّلها فعلاً إلى JPEG؛ تغيير الاسم لا يغيّر النوع
صيغة أو ترميز غير مدعومفيديو MOV، أو MP4 بترميز HEVC (H.265)صدّره MP4 بترميز H.264 وصوت AAC
حجم أكبر من الحدفيديو منتج 45 ميجابايت، أو صورة 8 ميجابايتاضغطه تحت 16 ميجابايت للفيديو و5 للصورة
صورة بمواصفات مرفوضةصورة طباعة بألوان CMYK، أو PNG بعمق 16-bit، أو عرضها 6,000 بكسلصدّرها JPEG بألوان RGB وأبعاد أقل من 4,096 بكسل
نوع خارج قائمة Metaملف ZIP أو RAR، أو تسجيل صوتي بصيغة WebMأرسل PDF، وحوّل الصوت إلى MP3 أو OGG بترميز OPUS
رابط لا تصل إليه Metaرابط يحتاج تسجيل دخول، أو رابط مؤقت انتهت صلاحيته، أو رابط مشاركة يفتح صفحة معاينةرابط عام مباشر للملف نفسه (القسم التالي)
عطل مؤقت في جلب الرابطتفاصيل فيها http code 502 أو 500أعد المحاولة بعد قليل، أو أرسل برقم ميديا

الأسباب من توثيق Meta للميديا وميديا القوالب ومثال مجتمع مطوريها (اطّلعنا عليها في 4 نوفمبر 2026)، والأمثلة والحلول من فريق مظبوت.

مثال من جدة: مكتب عقارات يصوّر الوحدات بآيفون ويرسل الفيديو في هيدر قالب لعملائه. الملف بصيغة MOV وبترميز HEVC، ففشلت الرسائل كلها بالخطأ 131053 مع أن الرابط يعمل. بعد تصديره MP4 بترميز H.264 وحجم 12 ميجابايت وصل الفيديو للجميع.

عند الإرسال بالحقل link تجلب Meta الملف من خادمك وقت الإرسال، وتقول في توثيق ميديا القوالب إن الملف يجب أن يكون على خادم متاح للعامة، وإلا يفشل الإرسال. افحص الرابط هكذا:

  1. عام وبلا تسجيل دخول: افتحه في نافذة خاصة (Incognito)؛ يجب أن يظهر الملف أو يبدأ تنزيله فوراً.
  2. مباشر للملف: رابط المشاركة في بعض خدمات التخزين السحابي يفتح صفحة معاينة، فتستلم Meta صفحة ويب بدل صورة.
  3. نوع الملف في رد الخادم: نصيحتنا أن ترد ترويسة Content-Type بنوع الملف الحقيقي، مثل image/jpeg لا text/html، لأن Meta تعدّ عدم تطابق النوع سبباً شائعاً لهذا الخطأ.
  4. صالح وقت الإرسال: الروابط المؤقتة الموقّعة تنتهي بعد مدة، فتأكد أنها ستعمل وقت الحملة المجدولة.
  5. انتبه للنسخة المخزنة: تحتفظ Meta بنسخة من الملف المرسل برابط لمدة 10 دقائق وتعيد استخدامها مع الرابط نفسه، فإذا استبدلت الملف أضف للرابط استعلاماً مثل ?v=2.

للمطورين:

  • افحص رد الخادم بالأمر curl -I "https://example.com/files/offer.jpg": المطلوب 200 وcontent-type: image/jpeg، بلا تحويل لصفحة دخول.
  • افحص الملف نفسه بأمر Meta file -I offer.jpg، وترميز الفيديو بالأداة ffprobe: المطلوب h264 لمسار الفيديو وaac لمسار الصوت.
  • عامل 131053 حسب details: أخطاء الخادم من فئة 5xx قد تنجح بإعادة لاحقة، أما 4xx أو نوع الملف فلا تنجح قبل الإصلاح.

هل الأفضل إرسال الميديا برقم الميديا (Media ID)؟

نعم حسب Meta: توثيق رسائل الصور يقول إن الإرسال بالحقل id لملف مرفوع أفضل أداءً، وتوثيق الفيديو يصف الرابط بأنه «غير موصى به»، وتوثيق ميديا القوالب يقول إن رفع الملف مسبقاً يقلل الأخطاء ويوفر طلبات غير ضرورية على خادمك. والخطوات:

  1. ارفع الملف بطلب POST //media مع الحقول file وtype (نوع MIME) وmessaging_product=whatsapp.
  2. احفظ قيمة id التي ترجع في الرد.
  3. أرسل الرسالة بالصيغة "image": {"id": ""} بدل link، وكذلك للفيديو والصوت والمستند وهيدر القالب.
  4. جدّد الرفع قبل 30 يوماً، لأن Meta تقول إن معرّفات الميديا المرفوعة تنتهي بعد 30 يوماً.

والفرق العملي: الرابط تجلبه Meta من خادمك مع كل إرسال (مع نسخة مخزنة 10 دقائق)، فيفشل إذا تعطل خادمك أو تغيّر الرابط؛ أما رقم الميديا فملف محفوظ عند Meta صالح 30 يوماً، فلا يتوقف الإرسال على خادمك أثناء الحملة.

كيف تحل الخطأ 131053 خطوة بخطوة؟

  1. اقرأ حقل التفاصيل: إن ذكر فشل التنزيل من الرابط (weblink) فصحّح الرابط حسب قائمة الفحص أعلاه، أو أعد المحاولة بعد قليل إن كان رمز الخادم من فئة 5xx.
  2. إن لم يكن الرابط: افحص نوع الملف الحقيقي لا امتداده، ثم حوّله: الصورة إلى JPEG بألوان RGB أقل من 5 ميجابايت، والفيديو إلى MP4 بترميز H.264 وصوت AAC أقل من 16 ميجابايت، والصوت إلى MP3، والملفات المضغوطة إلى PDF.
  3. جرّب على رقم اختبار مختلف قبل الحملة، ولا تجرّب على رقم نشاطك نفسه وإلا ظهر الخطأ 131021 (المرسل والمستقبل نفس الرقم).
  4. في الحملات الكبيرة: ارفع الملف مرة وأرسل برقم الميديا، أو استخدم رابطاً عاماً ثابتاً.
  5. لا تكرر الطلب نفسه بالملف نفسه: سيفشل مرة أخرى ما لم يكن السبب عطلاً مؤقتاً.

مثال من القاهرة: مطبعة ترسل للعميل بروفة التصميم صورة JPEG كما صدّرها المصمم للطباعة بألوان CMYK، فتفشل بالخطأ 131053 بينما تصل صور المنتجات العادية، لأن Meta تشترط صوراً بألوان RGB أو RGBA. الحل: نسخة للواتساب بألوان RGB، والملف الأصلي يُرسل PDF مستنداً.

الكود المعنى حسب Meta الاتجاه ماذا تفعل؟
131053تعذّر رفع الميديا المستخدمة في رسالتكصادرةافحص الملف والرابط
131052تعذّر تنزيل الميديا التي أرسلها العميلواردةاطلب الملف بوسيلة غير واتساب
131051نوع رسالة غير مدعومغالباً واردةاطلب إعادة الإرسال بصيغة مدعومة
131026تعذّر تسليم الرسالةصادرةتأكد بوسيلة أخرى أن العميل يستطيع مراسلتك

حسب صفحة أكواد الأخطاء من Meta (اطّلعنا عليها في 4 نوفمبر 2026). الشرح الكامل في خطأ 131052: تعذّر تنزيل ميديا العميل وخطأ 131051: نوع رسالة غير مدعوم وخطأ 131026: تعذّر تسليم الرسالة، وإذا كان الفشل في نص القالب لا في ميديته فاقرأ خطأ 132005: نص القالب أطول من المسموح.

كيف يرسل مظبوت الميديا ويتعامل مع الخطأ 131053؟

  • الإرسال برابط من مساحة تخزين مظبوت: عند إرسال صورة أو فيديو أو صوت أو مستند من صندوق الوارد أو في حملة، يحفظ مظبوت الملف ثم يرسل لـ Meta رابطه، ويحوّل روابط http إلى https في الصور والفيديو. وفي الحملة يُحفظ ملف الهيدر مرة واحدة ويُستخدم الرابط نفسه لكل العملاء.
  • تجهيز الملف قبل حفظه: يحوّل الصور إلى JPEG ويصغّر الكبيرة منها، ويحاول تحويل الفيديو إلى MP4 بترميز H.264 وصوت AAC في حدود 16 ميجابايت، وإن تعذّر ذلك طلب منك ملفاً أصغر أو مقطعاً أقصر قبل أن يصل الطلب لـ Meta.
  • فحص رابط الفيديو: قبل إرسال فيديو من صندوق الوارد يتأكد مظبوت أن رابطه يعمل، وإذا رجع 131053 لفيديو يعرض رسالة تقترح إعادة ترميزه إلى MP4 بترميز H.264.
  • قوالب بهيدر ميديا: عند إنشاء القالب يرفع مظبوت ملف المثال لـ Meta عبر واجهة الرفع الرسمية لتراجع القالب به.
  • الحملات: إذا وصل إشعار فشل بالخطأ 131053 أثناء حملة يوقفها مظبوت ويكتب السبب بجوار حالتها، ولا يعيد إرسال الرسالة الفاشلة تلقائياً.
  • بدون أي عمولة على أسعار Meta: Start بـ 6$ (بدلاً من 12$).

أسئلة شائعة

هل أدفع على رسالة فشلت بالخطأ 131053؟

لا. Meta تحاسب على الرسائل المُسلَّمة فقط، والرسالة التي فشل رفع ميديتها لم تُسلَّم.

لماذا يفشل فيديو الآيفون بالخطأ 131053؟

غالباً لأنه بصيغة MOV أو بترميز HEVC، وMeta لا تقبل في الفيديو إلا MP4 أو 3GPP بترميز H.264 حتى 16 ميجابايت. صدّره بهذه المواصفات، وللفيديو الأطول أرسل رابط مشاهدة في رسالة نصية.

الملف نفسه وصل أمس ويفشل اليوم، لماذا؟

راجع الرابط أولاً: ربما انتهت صلاحيته أو صار يحتاج تسجيل دخول. وإن كنت ترسل برقم ميديا فربما مرت 30 يوماً على رفعه. وقد يكون عطلاً مؤقتاً في جلب الرابط، كما في مثال يونيو 2026.

هل يعني الخطأ 131053 أن رقمي مقيّد؟

لا. الخطأ يخص ميديا رسالة بعينها، أما قيود الحساب فلها أكواد أخرى مثل الخطأ 368 (الحساب مقيّد مؤقتاً).

المصادر

صورك وفيديوهاتك جاهزة لواتساب قبل الإرسال

مع مظبوت تُجهَّز الصور والفيديو لحدود واتساب قبل أن تصل لـ Meta، ويرى فريقك نص الخطأ بجوار أي رسالة فاشلة، وتتوقف الحملة تلقائياً عند الأخطاء الحرجة مع سبب واضح، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.

ابدأ تجربتك المجانية