---
title: "رموز أخطاء WhatsApp Cloud API: معانيها وطرق إصلاحها"
description: "أكثر رموز أخطاء WhatsApp Cloud API شيوعًا، من 131047 و131026 إلى 132001 و130429: معنى كل رمز، وطريقة إصلاحه، ومتى لا يجوز إعادة المحاولة."
canonical: "https://omnichannels.ai/ar/blog/whatsapp-api-error-codes-troubleshooting/"
language: "ar"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
category: "whatsapp"
primaryQuery: "whatsapp cloud api error codes"
keywords: ["خطأ واتساب 131047", "خطأ واتساب 131026", "خطأ واتساب 131049", "خطأ واتساب 132001", "فشل إرسال رسالة واتساب API", "خطأ 130429 حد معدل الإرسال واتساب", "خطأ واتساب 131048"]
published: "2026-10-10"
author: "OmniChannels.ai Editorial Team"
reviewer: "BroadNet Messaging Solutions Team"
readingMinutes: 8
answer: "تنقسم أخطاء WhatsApp Cloud API إلى عدة عائلات: المصادقة (0 و190 و10)، والنزاهة (368 و131031)، وتقييد المعدل (4 و80007 و130429 و131048 و131049 و131056)، ومشكلات القوالب (من 132000 إلى 132016)، ومشكلات المستلم (131026 و131047 و131050)، ومشكلات الطلب (131008 و131009). اقرأ الرمز وتفاصيل error_data، ثم قرّر: أصلح وأعد المحاولة، أو انتظر وأعد المحاولة، أو انتقل إلى قالب أو قناة أخرى، أو لا تعد المحاولة أبدًا."
takeaways: ["الخطأ 131047 يعني أن نافذة خدمة العملاء البالغة 24 ساعة قد أُغلقت؛ أرسل قالبًا معتمدًا بدل الرسالة الحرة.", "الخطأ 131050 يعني أن المستخدم أوقف الرسائل التسويقية؛ وتنص Meta على عدم إعادة المحاولة.", "الخطأ 131049 حد تسويقي لكل مستخدم؛ وتنصح Meta بالانتظار 24 ساعة على الأقل قبل إعادة الإرسال.", "الخطأان 132000 و132012 ينتجان في الغالب عن عدم تطابق عدد المتغيرات أو تنسيقها مع القالب المعتمد.", "بعض الأخطاء تعود مباشرة في استجابة الـ API، وبعضها يصل لاحقًا في webhooks الحالة بقيمة failed، لذا يجب تسجيل الحالتين."]
faq: 
  - q: "ما معنى خطأ WhatsApp رقم 131047؟"
    a: "يعني الخطأ 131047 أن أكثر من 24 ساعة مرّت منذ آخر رسالة أرسلها المستلم إلى رقمك، أي أن نافذة خدمة العملاء مغلقة. لم تعد الرسائل النصية الحرة والوسائط والرسائل التفاعلية مسموحة. أرسل قالب رسالة معتمدًا بدلًا منها، ويُفضّل قالبًا من فئة تحديثات المعاملات (Utility) يدعو العميل إلى الرد، فيعيد ردّه فتح النافذة."
  - q: "لماذا يظهر الخطأ 131026 رغم أن الرقم موجود على WhatsApp؟"
    a: "تصف Meta الخطأ 131026 بأنه تعذّر تسليم الرسالة. ومن أسبابه رقم غير مسجَّل على WhatsApp، أو مستلم لم يوافق على أحدث الشروط، أو إصدار قديم من التطبيق. كما أن رمز الدولة الخاطئ أو الصيغة المحلية للرقم سبب متكرر. تحقق من الرقم بالصيغة الدولية، واطلب من العميل تحديث التطبيق، أو استخدم SMS أو البريد الإلكتروني."
  - q: "ما الفرق بين 130429 و131056؟"
    a: "الرمز 130429 يعني أن رقمك بلغ حد سعة الإرسال في Cloud API، أي أنك ترسل بسرعة أكبر من المسموح إجمالًا؛ أبطئ الإرسال واستخدم قائمة انتظار. أما 131056 فيعني أنك أرسلت رسائل كثيرة إلى المستلم نفسه في وقت قصير، ولا يتأثر المستلمون الآخرون. عالج 130429 بضبط المعدل، وعالج 131056 بالمباعدة بين الرسائل الموجهة إلى ذلك المستخدم."
  - q: "هل أعيد محاولة إرسال رسائل WhatsApp الفاشلة تلقائيًا؟"
    a: "فقط في الأخطاء المؤقتة مثل 131000 (غير معروف) و131016 (الخدمة غير متاحة) و130429 (سعة الإرسال) و4 أو 80007 (حدود المعدل)، مع تراجع أسّي في فترات الانتظار. لا تعد المحاولة تلقائيًا أبدًا في 131050 (إلغاء الاشتراك التسويقي)، ولا في 131026 دون تغيير شيء، ولا في أخطاء القوالب أو قيود السياسة 368. إعادة المحاولة العشوائية تهدر المال وتزعج المستخدمين وقد تضر بالجودة."
  - q: "أين أرى تفاصيل الخطأ كاملة؟"
    a: "تعود الأخطاء المتزامنة في استجابة الـ API ومعها code وmessage وerror_data. أما حالات الفشل غير المتزامنة فتصل في webhook الرسائل بحالة failed، ومعها مصفوفة errors تحمل الرمز والعنوان والتفاصيل. سجّل الكائن كاملًا لا الرمز وحده، لأن حقل التفاصيل كثيرًا ما يحدد المعامل أو مشكلة الوسائط بدقة."
sources: 
  - title: "رموز الأخطاء — WhatsApp Cloud API، Meta for Developers"
    url: "https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes"
  - title: "مرجع webhook رسائل الحالة — Meta for Developers"
    url: "https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/reference/messages/status"
  - title: "نبذة عن المنصة: حدود المعدل والتشفير — Meta for Developers"
    url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform"
---

# رموز أخطاء WhatsApp Cloud API: معانيها وطرق إصلاحها

Canonical: https://omnichannels.ai/ar/blog/whatsapp-api-error-codes-troubleshooting/
Language: ar
Publisher: OmniChannels.ai by BroadNet Technologies

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

## أين تظهر أخطاء WhatsApp Cloud API؟

تظهر الأخطاء في موضعين، ويجب التقاطها في الاثنين. أخطاء الطلب تعود فورًا في استجابة الـ API، وأخطاء التسليم تصل لاحقًا في webhook الحالة.

- **الأخطاء المتزامنة.** يُرفض طلب الإرسال وتحتوي الاستجابة على كائن `error` يضم `code` و`message` و`type` وغالبًا `error_data.details`. من أمثلتها الرموز المميزة المنتهية الصلاحية والمعاملات الناقصة وعدم تطابق القوالب.
- **الأخطاء غير المتزامنة.** ينجح طلب الإرسال ويعيد معرّف رسالة، لكن webhook لاحقًا يبلّغ بـ `status: failed` مع مصفوفة `errors`. من أمثلتها نوافذ الخدمة المغلقة والمستلمون الذين يتعذّر الوصول إليهم والحدود التسويقية.

من الأخطاء الشائعة تسجيل استجابة HTTP وحدها. فيظن الفريق أن الحملة نجحت لأن كل طلب أعاد معرّف رسالة، بينما فشلت مئات الرسائل في webhooks. لمعرفة العلاقة بين الحالات، راجع [شرح حالات sent وdelivered وread وfailed](/ar/blog/message-delivery-status-explained/).

## ما أكثر رموز أخطاء WhatsApp شيوعًا؟

يعرض الجدول الرموز التي يصادفها معظم الفرق، مجمّعة بحسب الخطوة التالية. الأوصاف صياغة بتصرف لمرجع Meta.

| الرمز | المعنى | الإصلاح | إعادة المحاولة؟ |
|---|---|---|---|
| 0 | تعذّرت مصادقة مستخدم التطبيق؛ الرمز المميز منتهٍ أو مُلغى | أنشئ رمز وصول جديدًا | بعد الإصلاح |
| 190 | انتهت صلاحية رمز الوصول | استخدم رمز مستخدم نظام غير منتهٍ، وجدّده | بعد الإصلاح |
| 3 و10 و200–299 | صلاحية أو إمكانية ناقصة | افحص صلاحيات الرمز في أداة تصحيح رموز الوصول | بعد الإصلاح |
| 368 | تقييد أو تعطيل حساب WABA بسبب مخالفة للسياسة | راجع إنفاذ السياسات في WhatsApp Manager؛ واستأنف إذا كان القرار خاطئًا | لا |
| 131031 | الحساب مقفل، مثل فشل التحقق من السياسة أو البيانات | افحص حالة صحة الحساب؛ واحسمها مع Meta | لا |
| 4 | بلغ التطبيق حد معدل استدعاءات الـ API | قلّل حجم الطلبات؛ وراجع لوحة تحكم التطبيق | نعم، لاحقًا |
| 80007 | بلغ حساب WABA حد المعدل | قلّل حجم الطلبات؛ وأعد المحاولة لاحقًا | نعم، لاحقًا |
| 130429 | بلغت سعة إرسال Cloud API للرقم | ضع الرسائل في قائمة انتظار وأبطئ الإرسال | نعم، مع تراجع |
| 131048 | حد الرسائل المزعجة: قيود على الرسائل من هذا الرقم | افحص الجودة في WhatsApp Manager؛ وحسّن المحتوى والاستهداف | ليس فورًا |
| 131049 | لم تُسلَّم "للحفاظ على تفاعل صحي في المنظومة" | انتظر 24 ساعة على الأقل قبل إعادة الإرسال | ليس قبل 24 ساعة |
| 131056 | رسائل كثيرة إلى المستلم نفسه في وقت قصير | باعد بين الرسائل الموجهة إلى ذلك المستخدم | نعم، لاحقًا |
| 131000 | خطأ غير معروف | أعد المحاولة؛ وافتح تذكرة دعم إذا استمر | نعم، بحدود |
| 131016 | الخدمة غير متاحة مؤقتًا | افحص صفحة حالة Meta؛ وأعد المحاولة | نعم، مع تراجع |
| 131008 | معامل مطلوب مفقود | قارن الحمولة بمرجع نقطة النهاية | بعد الإصلاح |
| 131009 | قيمة معامل غير صالحة | افحص القيم، مثل صيغة رقم الهاتف أو المعرّفات | بعد الإصلاح |
| 131021 | المرسِل والمستلم هما الرقم نفسه | أرسل إلى رقم مختلف | لا |
| 131026 | تعذّر تسليم الرسالة | تحقق من الرقم، واطلب من المستخدم تحديث WhatsApp، أو استخدم قناة أخرى | ليس كما هي |
| 131042 | مشكلة في وسيلة الدفع | أصلح الفوترة: حساب الدفع وخط الائتمان والعملة | بعد الإصلاح |
| 131045 / 133010 | الرقم غير مسجَّل على المنصة | سجّل رقم هاتف النشاط التجاري | بعد الإصلاح |
| 131047 | مرّت أكثر من 24 ساعة على آخر رد من المستخدم | أرسل قالبًا معتمدًا | كقالب |
| 131050 | أوقف المستخدم الرسائل التسويقية | لا تعد المحاولة؛ واحترم تفضيله | أبدًا |
| 131051 | نوع رسالة غير مدعوم | استخدم نوعًا مدعومًا | بعد الإصلاح |
| 131052 | تعذّر تنزيل وسائط أرسلها المستخدم | اطلب من المستخدم إعادة الإرسال | غير منطبق |
| 131053 | تعذّر رفع وسائط في رسالتك | افحص نوع MIME والحجم والرابط | بعد الإصلاح |
| 131057 | الحساب في وضع الصيانة | انتظر؛ وقد يحدث أثناء ترقية سعة الإرسال | نعم، لاحقًا |
| 132000 | عدد المتغيرات لا يطابق القالب | أرسل العدد نفسه من المعاملات المحدد في القالب | بعد الإصلاح |
| 132001 | القالب غير موجود بتلك اللغة أو غير معتمد | افحص الاسم ورمز اللغة والحالة | بعد الإصلاح |
| 132005 | النص المترجم طويل جدًا | اختصر ترجمة القالب | بعد الإصلاح |
| 132007 | محتوى القالب يخالف السياسة | عدّله وفق قواعد مراجعة القوالب | بعد الإصلاح |
| 132012 | قيم المتغيرات منسّقة بشكل خاطئ | طابق التنسيق المتوقع | بعد الإصلاح |
| 132015 | القالب موقوف بسبب انخفاض الجودة | عدّل المحتوى لتحسين الجودة | بعد التعديل |
| 132016 | القالب معطّل نهائيًا بعد إيقافات متكررة | أنشئ قالبًا جديدًا بمحتوى مختلف | لا |
| 135000 | خطأ غير معروف في معاملات الطلب | افحص صياغة الطلب؛ وتواصل مع الدعم | بعد الإصلاح |

## كيف تعالج الأخطاء المسؤولة عن معظم فشل الحملات؟

عمليًا، تتسبب حفنة من الرموز في معظم حالات الفشل. ولكل منها قاعدة قرار واضحة.

### 131047: نافذة الخدمة مغلقة

كتب العميل آخر رسالة قبل أكثر من 24 ساعة. لا يُسمح بالرسائل النصية الحرة والوسائط والتفاعلية إلا داخل نافذة خدمة العملاء البالغة 24 ساعة؛ وخارجها يجب استخدام قالب معتمد؛ راجع [نافذة خدمة العملاء البالغة 24 ساعة](/ar/blog/whatsapp-24-hour-customer-service-window/). يواجه الموظفون هذا الخطأ كثيرًا عند الرد على محادثة قديمة. اعرض للموظفين حالة النافذة، وقدّم منتقي قوالب عند انتهائها.

### 131026: الرسالة غير قابلة للتسليم

ابدأ بسلامة الأرقام: الصيغة الدولية، ورمز الدولة الصحيح، ودون صفر بادئ بعد الرمز. ثم تقبّل أن بعض الأرقام ببساطة ليست على WhatsApp، أو تعمل بإصدار قديم من التطبيق. وللرسائل الحساسة للوقت مثل OTP، انتقل إلى SMS. راجع [WhatsApp مقابل SMS مقابل RCS](/ar/blog/whatsapp-vs-sms-vs-rcs/).

### 131049 و131050: الحدود التسويقية وإلغاء الاشتراك

يؤثر الاثنان في الرسائل التسويقية. الرمز 131050 هو اختيار المستخدم الصريح بإيقاف الرسائل التسويقية؛ فاستبعده من الإرسال التسويقي واشترك في webhook تفضيلات المستخدم لدى Meta. أما 131049 فيعني أن Meta قررت عدم التسليم حمايةً لتفاعل المستخدمين؛ وتنصح Meta بالانتظار 24 ساعة على الأقل، وغالبًا ما تفشل المحاولات الأسرع من ذلك مجددًا. خفّض التكرار وحسّن الصلة بدلًا من إعادة الإرسال.

### 130429 و131048 و131056: الإرسال بسرعة أو بكمية أكبر من اللازم

الرمز 130429 يتعلق بسعة الإرسال: ضع الرسائل في قائمة انتظار وطبّق التراجع. و131056 على مستوى الزوج: أنت تراسل شخصًا واحدًا بكثرة. و131048 إشارة جودة على رقم المرسِل وتحتاج إلى إصلاح في المحتوى والاستهداف لا إلى إعادة محاولة. راجع [حدود المراسلة وتقييم الجودة](/ar/blog/whatsapp-messaging-limits-quality-rating/).

### 132000 و132001 و132012: عدم تطابق القوالب

هذه في الغالب أخطاء في التكامل. يجب أن يطابق اسم القالب ورمز اللغة (مثل `ar` مقابل `en_US`) وعدد المتغيرات ما اعتُمد تمامًا. ابنِ اختبارًا يرسل كل قالب بقيم تجريبية كلما عدّلته.

## سياسة إعادة محاولة يمكنك تطبيقها

استخدم قائمة التحقق التالية لتصنيف كل فشل تلقائيًا.

1. **سجّل** الرمز والعنوان و`error_data.details` ومعرّف الرسالة والمستلم واسم القالب.
2. **لا تعد المحاولة أبدًا** في 131050 و131021 و132016 و368 و131031. وأبلغ المسؤول فورًا بالرمزين 368 و131031.
3. **أصلح ثم أعد المحاولة** في أخطاء المصادقة (0 و190 و10) والمعاملات (131008 و131009 و135000) والقوالب (من 132000 إلى 132015) والفوترة (131042). ونبّه الفريق المسؤول.
4. **تراجع ثم أعد المحاولة** في 130429 و4 و80007 و131016 و131057 باستخدام تراجع أسّي بسقف أعلى.
5. **غيّر القناة أو نوع الرسالة** في 131047 (قالب) و131026 (SMS أو البريد الإلكتروني).
6. **انتظر 24 ساعة أو أكثر** في 131049 وراجع تكرار الحملات.
7. **أبلغ** عن حالات الفشل بحسب الرمز في تقارير الحملات، لا كإجمالي واحد لـ "failed".

## مثال تطبيقي: حملة ترويجية فاشلة لمتجر في الرياض

هذا مثال افتراضي. ترسل "Najd Home" قالبًا تسويقيًا إلى 20,000 عميل وافقوا على تلقي الرسائل. يقبل الـ API كل الطلبات، لكن webhooks الحالة تُظهر نحو 1,400 حالة فشل.

بعد التجميع بحسب الرمز تتضح الصورة. أكبر مجموعة هي 131049، فيستبعد الفريق هؤلاء المستخدمين من الإرسالين التاليين ويخفّض التكرار الأسبوعي. مجموعة أصغر هي 131026؛ ويُظهر التحليل أن كثيرًا من الأرقام مخزّنة بصفر محلي في البداية، ويحلّ ذلك إصلاح للتوحيد القياسي للأرقام. ويُستبعد عدة مستخدمين من فئة 131050 من الإرسال التسويقي بشكل دائم. أما أخطاء 130429 القليلة فجاءت من دفعة الإرسال الأولى، فيُوزَّع الإرسال الآن عبر قائمة انتظار.

## أخطاء شائعة وحدود صريحة

- **معاملة كل فشل على أنه قابل لإعادة المحاولة.** يهدر الإنفاق وقد يخفض الجودة.
- **تثبيت نصوص Meta برمجيًا.** تحدّث Meta العناوين والأوصاف؛ ابنِ المنطق على الرمز الرقمي واحتفظ بجدول مرجعي قابل للتحديث.
- **تجاهل `error_data.details`.** فهو كثيرًا ما يسمّي المعامل المعيب بدقة.
- **ليس لكل فشل حل.** بعض المستلمين لا يمكن الوصول إليهم عبر WhatsApp، ولا تشرح Meta كل قرار 131049. خطّط لقناة بديلة.

## كيف تساعدك OmniChannels.ai

توفّر OmniChannels.ai، المدعومة من BroadNet Technologies، تقارير تسليم بعرضين موجز ومتقدم، مع عوامل تصفية وتصدير CSV، لتحليل الرسائل الفاشلة بحسب الحملة. ويمكن للتحويل بين القنوات إعادة الإرسال عبر RCS أو SMS عند فشل WhatsApp، وتُعاين القوالب على نموذج هاتف وتُتتبَّع حتى الاعتماد، مما يقلل أخطاء عدم التطابق. وتُبلغ [webhooks](/developers/webhooks/) عن حالتي FAILED وREJECTED بصيغة موحّدة واحدة، وتتضمن [وثائق المطورين](/developers/) العامة مرجعًا لـ [الأخطاء والحدود](/developers/errors-and-limits/).