رموز أخطاء WhatsApp Cloud API
هذه كل رموز أخطاء WhatsApp Cloud API التي نوثقها، في جدول واحد، مع معنى كل رمز وما إذا كانت إعادة المحاولة مفيدة. معظمها لا يفيد معه ذلك، لأنها حتمية، فالطلب نفسه يفشل بالطريقة نفسها، وتحوّل حلقة إعادة المحاولة الطلب الخاطئ إلى تجاوز لمعدل الطلبات.
تراقب EasyCoexistence الاتصال باستمرار، وتسجل أحداث الحساب والجودة من Meta في المخطط الزمني للاتصال، فتظهر الأخطاء الناتجة عن حالة الرقم قبل فشل الإرسال لا بعده.
الطلب
| الرمز | معناه | إعادة المحاولة |
|---|---|---|
| 100 | معامل غير مدعوم أو مكتوب بشكل خاطئ أو بصيغة غير صحيحة. | لا |
| 131008 | لم يُضمَّن معامل مطلوب على الإطلاق. | لا |
| 131009 | المعامل موجود لكن بقيمة ترفضها نقطة النهاية. | لا |
| 131021 | المرسل والمستلم هما الرقم نفسه. | لا |
| 131051 | نوع الرسالة غير مدعوم، وغالبًا ما يكون ذلك من حدود Coexistence. | لا |
| 131052 | تعذّر على Meta تنزيل وسائط أرسلها العميل. | لا |
| 131053 | تعذّر على Meta رفع وسائط أرسلتها. السبب الحجم أو الصيغة أو إمكانية الوصول. | لا |
القالب
| الرمز | معناه | إعادة المحاولة |
|---|---|---|
| 132000 | عدد المعاملات لا يطابق القالب. | لا |
| 132001 | لا يوجد قالب بهذا الاسم وهذه اللغة معًا. | لا |
| 132007 | القالب يخالف سياسة المراسلة. أعد كتابته وأرسله للمراجعة من جديد. | لا |
| 132012 | صيغة المعامل لا تطابق ما يحدده القالب. | لا |
| 132015 | القالب متوقف مؤقتًا بعد تراجع جودته. الحالة مؤقتة. | انتظر |
| 132016 | القالب معطّل نهائيًا ولن يعود. | لا |
النافذة والمستلم
التسجيل ورمز PIN
الوصول والحساب
حدود المعدل
أخطاء عابرة
مزامنة Coexistence
كيفية قراءة عمود إعادة المحاولة
يحتوي على ثلاث قيم، والاختيار الخاطئ بينها هو أغلى خطأ في هذا المرجع كله.
تعني «لا» أن الفشل حتمي. ما فشل هو الطلب أو القالب أو حالة المستلم، وإرسال الطلب نفسه مرة أخرى ينتج الخطأ نفسه ويستهلك سعة ستحتاج إليها لاحقًا. وتعني «نعم» أن الفشل كان من جهة Meta، وأن التراجع التدريجي يحله فعليًا. أما «انتظر» فتعني أن الحالة حقيقية لكنها مؤقتة، مثل حد أو قفل يزول تلقائيًا، حيث لا تفيد إعادة المحاولة قبل زوالها وقد تطيل مدتها.
لماذا لا يمكن إعادة محاولة معظم هذه الرموز
لأن المنصة تعيد رموزًا محددة بدلًا من الرموز العامة. فالمعامل غير الصحيح، أو القالب غير الموجود، أو نافذة المراسلة المغلقة، أو المستلم الذي ألغى الاشتراك، كلها حالات يمكن معرفتها لحظة الاستجابة، لذلك تسميها Meta بدلًا من الفشل بطريقة مبهمة.
- مشكلة الطلب لا تصبح صحيحة في المحاولة الثانية.
- مشكلة القالب موجودة في القالب نفسه، ولا يستطيع الطلب تغييرها.
- مشكلة النافذة أو إلغاء الاشتراك تتعلق بحالة المستلم، لا بحالتك.
- تقييد الحساب قرار، وإعادة المحاولة ليست استئنافًا.
ما الذي يجب تسجيله عند وصول أحد هذه الرموز
ما يكفي لتشخيص المشكلة من دون إعادة إنتاجها، وهذا هو الفارق بين إصلاح يستغرق خمس دقائق ويوم كامل من التخمين.
- استجابة الخطأ الكاملة، بما فيها trace id، وهو ما يطلبه دعم Meta.
- نص الطلب كما أُرسل، لا كما قصدته. الفجوة بين الاثنين هي المشكلة عادةً.
- معرّف رقم الهاتف، لتمييز مشكلة رقم واحد من مشكلة تشمل الحساب كله.
- الطابع الزمني، لمقارنة الفشل بحالة الاتصال في تلك اللحظة.
الرموز الموجودة فقط في Coexistence
اثنان منها، وهما يربكان الناس لأنهما يبدوان كأنهما فشلا عاديان في الإرسال. يتعلق 2593107 و2593108 بمزامنة سجل المحادثات، وهي الخطوة التي تنسخ المحادثات الحديثة من تطبيق WhatsApp Business عند اتصال الرقم لأول مرة.
ليسا خطأين في المراسلة، ولا يعنيان فشل الاتصال. فإذا تجاوزت المزامنة حدها أو جرت خارج نافذتها، يبقى الرقم متصلًا ويرسل بشكل طبيعي، مع نسخ سجل أقل من المتوقع. واعتبارهما دليلًا على تعطل الاتصال يدفع الناس إلى فصل الرقم والبدء من جديد، ما يؤدي إلى فقدان سجل أكبر بدلًا من استعادته.
الأسئلة الشائعة
ما الأخطاء التي ينبغي إعادة المحاولة بشأنها؟
131016 و131000، مع تراجع تدريجي أُسّي. تزول 130429 و132015 و133008 تلقائيًا عند الانتظار. أما البقية فحتمية.
هل يعني رمز الخطأ أن رقمي غير متصل؟
غالبًا لا. تتعلق معظم هذه الرموز بالطلب أو القالب أو المستلم. وتظهر مشكلات الاتصال على شكل خطافات ويب للحساب والجودة، لا كأخطاء إرسال.
ما هو trace id؟
معرّف في استجابة الخطأ يتيح لدعم Meta العثور على الطلب المحدد. سجّله عند كل فشل، فمن دونه لا يمكن معالجة طلب الدعم.
هل هذه الرموز متطابقة لدى كل مزود؟
نعم. تأتي من Cloud API لدى Meta، لذا فهي متطابقة أيًا كان المزود الذي وصل الرقم. ولا يستطيع المزود تغيير سوى مدى وضوح وصولها إليك.
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةلن تُفرض أي رسوم لمدة 3 أيام. ألغِ في أي وقت.