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

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

الإجابة المختصرة: الخطأ 131052 معناه أن واتساب تعذّر عليه تنزيل الميديا التي أرسلها العميل (صورة أو صوت أو فيديو أو ملف)، فيصلك Webhook رسالة واردة بنوع unsupported بلا ملف. ومن أسبابه الموثّقة ملف أكبر من 100 ميجابايت، وهو أقصى حجم لميديا Cloud API. الحل حسب Meta: اطلب من العميل ملفاً أصغر، أو إرساله بوسيلة غير واتساب. ولا تخلطه بانتهاء رابط الميديا بعد 5 دقائق.

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

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

في صفحة أكواد الأخطاء الرسمية يحمل الكود 131052 التفاصيل «Unable to download the media sent by the user.»، أي: تعذّر تنزيل الميديا التي أرسلها العميل. وتضيف Meta أن سبب الفشل بالتفصيل موجود في الحقل error_data.details داخل Webhook الرسالة، وأن الحل أن تطلب من العميل إرسال الملف بوسيلة أخرى غير واتساب.

وفي توثيق الميديا تذكر Meta سبباً محدداً: أقصى حجم لرسائل الميديا على Cloud API هو 100 ميجابايت، وإذا أرسل العميل ملفاً أكبر يصلك Webhook بالخطأ 131052 وعنوان يقول إن حجم الملف كبير. وتنصح Meta بتنبيه العميل وطلب ملف أصغر من 100 ميجابايت.

المصدر ماذا يقول عن 131052؟ ماذا تفعل؟
صفحة أكواد الأخطاءميديا رسالة العميل لم يمكن تنزيلها، والسبب في error_data.detailsاطلب الملف بوسيلة غير واتساب
توثيق الميديا (قيود تنزيل الميديا)الملف الأكبر من 100 ميجابايت يصلك بالخطأ 131052نبّه العميل واطلب ملفاً أصغر من 100 ميجابايت
مرجع Webhook الرسائلأخطاء الرسائل الواردة تصل داخل الرسالة نفسها بنوع unsupportedافحص نوع الرسالة قبل معالجة محتواها

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

الخلاصة: المشكلة عند واتساب لا في نظامك، والملف لا يصلك أصلاً، والخطأ يخص رسالة بعينها ولا علاقة له بجودة رقمك أو حدوده.

كيف يظهر الخطأ 131052 في Webhook الرسائل الواردة؟

تقول Meta إن أخطاء الرسائل الواردة تظهر داخل مصفوفة messages في الحقل errors، وإن هذه الإشعارات يكون نوعها unsupported. أي أن الرسالة تصلك من العميل بمعرّفها ووقتها، لكن بدون معرّف ميديا ولا رابط:

الحقل ماذا تجد فيه؟
messages[0].typeunsupported بدلاً من image أو video أو document
messages[0].errors[0].code131052
errors[0].error_data.detailsسبب الفشل بالتفصيل، وهو ما تبني عليه ردك
from, id, timestampرقم العميل ومعرّف الرسالة ووقتها، لربطها بالمحادثة

حسب مرجع Webhook الرسائل ومرجع الرسائل غير المدعومة من Meta (اطّلعنا عليهما في 4 نوفمبر 2026).

للمطورين:

  • افحص type == "unsupported" أولاً، ثم errors[0].code، ولا تبحث عن image.id في هذه الرسالة.
  • تنصح Meta ببناء معالجة الأخطاء على الكود وحقل details، لا على العنوان، لأن العناوين سيتوقف استخدامها.
  • لا تعِد محاولة التنزيل: لا يوجد ملف لتنزيله.

فشل تنزيل الميديا من نظامك: متى لا يكون الخطأ 131052؟

كثير من «الصور التي لا تفتح» ليست 131052. فإذا وصلك Webhook عادي بنوع image ومعه معرّف الميديا، ثم فشل نظامك في التنزيل، فالسبب غالباً من هذا الجدول:

ما يحدث السبب حسب Meta الحل
رابط الملف يرجع 404 Not Foundروابط الميديا تنتهي بعد 5 دقائقاطلب رابطاً جديداً بمعرّف الميديا ونزّل فوراً
معرّف الميديا لم يعد يعملمعرّفات الميديا في Webhook متاحة للتنزيل 7 أيام فقطنزّل الملف واحفظ نسخة عند وصول الرسالة
طلب التنزيل يفشل مباشرةالتنزيل يحتاج رمز الوصول في الطلبأرسل الرمز في ترويسة Authorization
404 حتى مع رابط جديدقد يكون رمز الوصول نفسهجدّد رمز الوصول ثم أعد المحاولة

حسب توثيق الميديا من Meta (اطّلعنا عليه في 4 نوفمبر 2026). وتقول Meta إن Webhook الميديا الواردة صار يحمل الرابط في الحقل url، وهي ميزة تصل للمطورين تدريجياً، ورابطه ينتهي أيضاً بعد 5 دقائق.

وهذه أنواع الميديا وأحجامها كما يعرضها جدول Meta، وتفيدك عند إرسال ملفاتك أنت وتجنّب الخطأ 131053:

النوع الصيغ الحد الأقصى
صورةJPEG, PNG, WebP5 ميجابايت
صوتAAC, AMR, MP3, M4A, OGG16 ميجابايت
فيديوMP4, 3GP16 ميجابايت
مستندPDF, DOC(X), XLS(X), PPT(X), TXT100 ميجابايت
ملصقWebP100 كيلوبايت ثابت، 500 كيلوبايت متحرك

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

كيف تتعامل مع الخطأ 131052 خطوة بخطوة؟

  1. استقبل الإشعار وأعد HTTP 200: تعيد Meta إرسال الإشعار الذي لا يُستقبل بـ 200 لمدة تصل إلى 7 أيام، وقد يسبب ذلك رسائل مكررة.
  2. سجّل الكود والتفاصيل: الكود وحقل details ومعرّف الرسالة ووقتها، واربطها بمحادثة العميل.
  3. أظهرها لفريقك: سطر واضح في المحادثة مثل «العميل أرسل ملفاً لم يصلنا» أفضل من إخفائها.
  4. اقرأ السبب قبل الرد: إذا كانت التفاصيل عن حجم الملف فاطلب ملفاً أصغر من 100 ميجابايت، وإلا فاطلب الملف بوسيلة أخرى كما تقترح Meta: بريد إلكتروني، أو نموذج رفع على موقعك، أو رابط من خدمة تخزين سحابي.
  5. اكتب الرد بلطف: داخل نافذة الـ 24 ساعة يكفي رد عادي، وخارجها تحتاج قالباً معتمداً. مثال: «وصلتنا رسالتك لكن الملف لم يظهر لنا لأنه كبير. ممكن ترسل فيديو أقصر، أو ترسله على بريدنا؟» وتفاصيل النافذة في نافذة خدمة العملاء 24 ساعة.
  6. لا تكرر الطلب مع كل رسالة: مرة واحدة لكل ملف تكفي.
  7. إن تكرر الخطأ مع عملاء كثيرين: راجع ما تطلبه منهم. نصيحتنا: اطلب صوراً أو مقطعاً قصيراً بدل فيديو طويل، واكتب ذلك في رسالة الترحيب.

مثال من الرياض: مركز صيانة سيارات يطلب من العملاء تصوير العطل، فيرسل عميل فيديو طويلاً بجودة عالية تجاوز 100 ميجابايت، فيصل للمركز Webhook بالخطأ 131052 بلا فيديو. يرد الموظف: «الفيديو أكبر من المسموح، أرسل لنا مقطعاً أقصر من دقيقة أو ثلاث صور للعطل»، ويضيف المركز هذه الجملة لرسالة الترحيب فيقل تكرار المشكلة.

مثال من القاهرة: مطبعة يرسل لها العملاء ملفات تصميم PDF ثقيلة. عند ظهور 131052 يرسل الموظف رابط نموذج الرفع على موقع المطبعة، ويكمل المحادثة على واتساب بعد استلام الملف.

الكود المعنى حسب Meta الاتجاه ماذا تفعل؟
131052تعذّر تنزيل الميديا التي أرسلها العميلرسالة واردةملف أصغر من 100 ميجابايت أو وسيلة غير واتساب
131053تعذّر رفع الميديا المستخدمة في رسالتك، مثلاً لنوع ملف غير مدعومرسالة صادرةافحص نوع الملف (MIME) وطابقه مع الجدول أعلاه
131051نوع رسالة غير مدعوم، مثل تعديل رسالة أو استطلاعغالباً واردةاطلب إعادة الإرسال بصيغة مدعومة
131060الرسالة غير متاحة حالياً، وتظهر عادة مع أول رسالة لعميل يراسل نشاطاً مربوطاً برقم تطبيق واتساب بيزنسرسالة واردةلا تذكر Meta إجراءً؛ نصيحتنا أن تطلب من العميل إعادة الإرسال

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

كيف يتعامل مظبوت مع ميديا العملاء والخطأ 131052؟

  • ينزّل الملف ويحفظ نسخة عند وصول الرسالة: عندما يرسل العميل صورة أو رسالة صوتية أو فيديو أو مستنداً، يطلب مظبوت الملف من Meta برمز الوصول الخاص بربطك ويحفظ نسخة في مساحة التخزين، فيبقى ظاهراً في صندوق الوارد بعد انتهاء مهلة الأيام السبعة، والمستندات تحتفظ باسمها وامتدادها الأصليين.
  • رسائل 131052 لا تضيع: تظهر في المحادثة كرسالة من العميل مع ملاحظة «نوع الرسالة غير مدعوم حالياً». الملاحظة عامة ولا تعرض الكود نفسه، فاطلب الملف من العميل مباشرة.
  • موظف الذكاء الاصطناعي: يقرأ النصوص والرسائل الصوتية والصور فقط، فلا يرد على الرسائل غير المدعومة ولا على الفيديو والمستندات، وتبقى لفريقك. ويستطيع العميل طلب موظف بكلمات مثل «موظف» أو «دعم»، والشرح في تحويل المحادثة من البوت لموظف.
  • لم تربط رقمك بعد؟ ابدأ من ربط رقم جديد غير مستخدم بواتساب API، أو اربط رقم واتساب بيزنس الحالي بالربط المزدوج.

أسئلة شائعة

هل أستطيع استرجاع الملف الذي ظهر معه الخطأ 131052؟

لا. الإشعار لا يحمل معرّف ميديا ولا رابطاً، فلا شيء لتنزيله. اطلب من العميل ملفاً أصغر أو إرساله بوسيلة أخرى.

ما أقصى حجم ملف يستقبله واتساب API من العميل؟

100 ميجابايت حسب توثيق الميديا من Meta، والملف الأكبر يصلك بالخطأ 131052 بدلاً من الملف.

لماذا لا يفتح رابط صورة العميل بعد دقائق؟

لأن روابط الميديا تنتهي بعد 5 دقائق. اطلب رابطاً جديداً بمعرّف الميديا، والمعرّف نفسه متاح للتنزيل 7 أيام فقط، فاحفظ الملف فور وصوله.

هل أدفع على رسالة وصلت بالخطأ 131052؟

لا، Meta تحاسب على ما ترسله أنت. وردك عليه رسالة خدمة مجانية ضمن أول 1,000 رسالة شهرياً لكل رقم، ثم بسعر دولة العميل: 0.0036$ في مصر و0.0107$ في السعودية (أسعار Meta السارية من 1 أكتوبر 2026).

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

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

المصادر

كل صورة وصوت وملف من عملائك في صندوق وارد واحد

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

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