تسجيل الدخولابدأ الفترة التجريبية المجانية
Meta Tech Provider

رموز أخطاء WhatsApp Cloud API

هذه كل رموز أخطاء WhatsApp Cloud API التي نوثقها، في جدول واحد، مع معنى كل رمز وما إذا كانت إعادة المحاولة مفيدة. معظمها لا يفيد معه ذلك، لأنها حتمية، فالطلب نفسه يفشل بالطريقة نفسها، وتحوّل حلقة إعادة المحاولة الطلب الخاطئ إلى تجاوز لمعدل الطلبات.

تراقب EasyCoexistence الاتصال باستمرار، وتسجل أحداث الحساب والجودة من Meta في المخطط الزمني للاتصال، فتظهر الأخطاء الناتجة عن حالة الرقم قبل فشل الإرسال لا بعده.

من دون تخزين للرسائل افتراضيًاتطبيق الأعمال + Cloud APIMCP لـ Claude وChatGPTجاهز خلال دقيقتين

الطلب

الرمزمعناهإعادة المحاولة
100معامل غير مدعوم أو مكتوب بشكل خاطئ أو بصيغة غير صحيحة.لا
131008لم يُضمَّن معامل مطلوب على الإطلاق.لا
131009المعامل موجود لكن بقيمة ترفضها نقطة النهاية.لا
131021المرسل والمستلم هما الرقم نفسه.لا
131051نوع الرسالة غير مدعوم، وغالبًا ما يكون ذلك من حدود Coexistence.لا
131052تعذّر على Meta تنزيل وسائط أرسلها العميل.لا
131053تعذّر على Meta رفع وسائط أرسلتها. السبب الحجم أو الصيغة أو إمكانية الوصول.لا

القالب

الرمزمعناهإعادة المحاولة
132000عدد المعاملات لا يطابق القالب.لا
132001لا يوجد قالب بهذا الاسم وهذه اللغة معًا.لا
132007القالب يخالف سياسة المراسلة. أعد كتابته وأرسله للمراجعة من جديد.لا
132012صيغة المعامل لا تطابق ما يحدده القالب.لا
132015القالب متوقف مؤقتًا بعد تراجع جودته. الحالة مؤقتة.انتظر
132016القالب معطّل نهائيًا ولن يعود.لا

النافذة والمستلم

الرمزمعناهإعادة المحاولة
131047نافذة خدمة العملاء ذات الـ 24 ساعة مغلقة. أرسل قالبًا.لا
131026لا يمكن للمستلم استلام الرسالة إطلاقًا.لا
131050ألغى الشخص الاشتراك. لا توجد طريقة للالتفاف على ذلك، وهذا مقصود.لا
130497المراسلة إلى ذلك البلد مقيدة لحسابك.لا

التسجيل ورمز PIN

الرمزمعناهإعادة المحاولة
131045لم يُسجَّل الرقم قط للمراسلة عبر Cloud API.لا
133010الرقم غير مسجل. يجب إكمال التسجيل.لا
133006يجب التحقق من الرقم قبل أن يمكن تسجيله.لا
133005رمز PIN للتحقق بخطوتين كان خاطئًا. توقف عن التخمين.لا
133008محاولات كثيرة لرمز PIN. التسجيل مقفل لفترة.انتظر

الوصول والحساب

الرمزمعناهإعادة المحاولة
190انتهت صلاحية رمز الوصول أو أُبطل.لا
368الحساب مقيد بعد مخالفة للسياسات.لا
131031الحساب مقيد، أو أن بياناته لا تطابق بيانات Meta.لا
131042مشكلة في الدفع على الحساب التجاري تمنع الإرسال.لا
131049حظرت Meta الرسالة لحماية سلامة المنظومة.لا

حدود المعدل

الرمزمعناهإعادة المحاولة
130429بلغ الحساب حد سعة المراسلة.انتظر
131048تم بلوغ حد معدل الرسائل المزعجة. السبب هو الجودة، لا الحجم.لا
131056رسائل كثيرة جدًا بين رقمك ومستلم واحد.لا
80007بلغ الحساب حد استدعاءات الإدارة، وغالبًا بسبب الاستطلاع المتكرر.انتظر

أخطاء عابرة

الرمزمعناهإعادة المحاولة
131016إحدى خدمات Meta غير متاحة مؤقتًا.نعم
131000فشل غير مصنف. أعد المحاولة مرة واحدة، ثم صعّد المشكلة مع معرّف التتبع.نعم

مزامنة Coexistence

الرمزمعناهإعادة المحاولة
2593107تم تجاوز حد مزامنة سجل المحادثات.لا
2593108جرت محاولة مزامنة خارج نافذة المزامنة البالغة 24 ساعة.لا

كيفية قراءة عمود إعادة المحاولة

يحتوي على ثلاث قيم، والاختيار الخاطئ بينها هو أغلى خطأ في هذا المرجع كله.

تعني «لا» أن الفشل حتمي. ما فشل هو الطلب أو القالب أو حالة المستلم، وإرسال الطلب نفسه مرة أخرى ينتج الخطأ نفسه ويستهلك سعة ستحتاج إليها لاحقًا. وتعني «نعم» أن الفشل كان من جهة Meta، وأن التراجع التدريجي يحله فعليًا. أما «انتظر» فتعني أن الحالة حقيقية لكنها مؤقتة، مثل حد أو قفل يزول تلقائيًا، حيث لا تفيد إعادة المحاولة قبل زوالها وقد تطيل مدتها.

لماذا لا يمكن إعادة محاولة معظم هذه الرموز

لأن المنصة تعيد رموزًا محددة بدلًا من الرموز العامة. فالمعامل غير الصحيح، أو القالب غير الموجود، أو نافذة المراسلة المغلقة، أو المستلم الذي ألغى الاشتراك، كلها حالات يمكن معرفتها لحظة الاستجابة، لذلك تسميها Meta بدلًا من الفشل بطريقة مبهمة.

  • مشكلة الطلب لا تصبح صحيحة في المحاولة الثانية.
  • مشكلة القالب موجودة في القالب نفسه، ولا يستطيع الطلب تغييرها.
  • مشكلة النافذة أو إلغاء الاشتراك تتعلق بحالة المستلم، لا بحالتك.
  • تقييد الحساب قرار، وإعادة المحاولة ليست استئنافًا.

ما الذي يجب تسجيله عند وصول أحد هذه الرموز

ما يكفي لتشخيص المشكلة من دون إعادة إنتاجها، وهذا هو الفارق بين إصلاح يستغرق خمس دقائق ويوم كامل من التخمين.

  • استجابة الخطأ الكاملة، بما فيها trace id، وهو ما يطلبه دعم Meta.
  • نص الطلب كما أُرسل، لا كما قصدته. الفجوة بين الاثنين هي المشكلة عادةً.
  • معرّف رقم الهاتف، لتمييز مشكلة رقم واحد من مشكلة تشمل الحساب كله.
  • الطابع الزمني، لمقارنة الفشل بحالة الاتصال في تلك اللحظة.

الرموز الموجودة فقط في Coexistence

اثنان منها، وهما يربكان الناس لأنهما يبدوان كأنهما فشلا عاديان في الإرسال. يتعلق 2593107 و2593108 بمزامنة سجل المحادثات، وهي الخطوة التي تنسخ المحادثات الحديثة من تطبيق WhatsApp Business عند اتصال الرقم لأول مرة.

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

الأسئلة الشائعة

ما الأخطاء التي ينبغي إعادة المحاولة بشأنها؟

131016 و131000، مع تراجع تدريجي أُسّي. تزول 130429 و132015 و133008 تلقائيًا عند الانتظار. أما البقية فحتمية.

هل يعني رمز الخطأ أن رقمي غير متصل؟

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

ما هو trace id؟

معرّف في استجابة الخطأ يتيح لدعم Meta العثور على الطلب المحدد. سجّله عند كل فشل، فمن دونه لا يمكن معالجة طلب الدعم.

هل هذه الرموز متطابقة لدى كل مزود؟

نعم. تأتي من Cloud API لدى Meta، لذا فهي متطابقة أيًا كان المزود الذي وصل الرقم. ولا يستطيع المزود تغيير سوى مدى وضوح وصولها إليك.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

ابدأ الفترة التجريبية المجانيةلن تُفرض أي رسوم لمدة 3 أيام. ألغِ في أي وقت.

تابع القراءة