آخر تحديث: 3 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر: صفحة أكواد الأخطاء الرسمية من Meta
الإجابة المختصرة: كل رسالة تفشل في واتساب بيزنس API ترجع برقم خطأ، والرقم هو المهم لأن Meta قد تغيّر نص العنوان. أشهرها:
- 131047: انتهت نافذة الـ 24 ساعة، فأرسل قالباً.
- 131026: تعذّر التسليم؛ الرقم ليس على واتساب أو تطبيقه قديم.
- 131049: Meta حجبت رسالة تسويق للحفاظ على تفاعل المستخدم.
- 131050: العميل أوقف رسائل التسويق منك.
- 131042: مشكلة في وسيلة الدفع.
- 368 و131031: الحساب مقيّد.
محتوى المقال:
- أشهر 10 أخطاء وحلها السريع
- أخطاء وصول الرسالة للعميل
- أخطاء القوالب
- أخطاء الحساب والسياسات والدفع
- أخطاء تسجيل الرقم والتحقق
- أخطاء الصلاحيات ورمز الوصول والحدود
- أخطاء نقل الرقم من منصة أخرى
- قواعد ذهبية قبل إعادة المحاولة
- أسئلة شائعة
أشهر 10 أخطاء في واتساب API وحلها السريع
| الكود | المعنى | الحل |
|---|---|---|
| 131047 | مرّ أكثر من 24 ساعة على آخر رسالة من العميل. | أرسل قالباً معتمداً بدلاً من الرسالة العادية. |
| 131026 | تعذّر تسليم الرسالة. | تأكد بوسيلة أخرى أن العميل يستخدم واتساب على هذا الرقم، ووافق على شروط واتساب الجديدة، وحدّث التطبيق. |
| 131049 | لم تُسلَّم الرسالة للحفاظ على تفاعل صحي (حد رسائل التسويق لكل مستخدم). | لا تُعِد المحاولة فوراً؛ انتظر 24 ساعة على الأقل، وراجع موافقة العميل وملاءمة الرسالة. |
| 131050 | العميل أوقف استقبال رسائل التسويق منك. | لا تُعِد الإرسال له. يمكنك متابعة اشتراكه عبر Webhook تفضيلات المستخدم. |
| 131048 | قيود على عدد الرسائل من رقمك بسبب حظر أو بلاغات سبام سابقة. | راجع تقييم جودة الرقم في WhatsApp Manager وحسّن المحتوى والاستهداف. |
| 131056 | رسائل كثيرة لنفس العميل في وقت قصير. | انتظر ثم أعد المحاولة. يمكنك مراسلة أرقام أخرى فوراً. |
| 132000 | عدد قيم المتغيرات لا يطابق متغيرات القالب. | أرسل قيمة لكل متغير في القالب ({{1}} و{{2}}…). |
| 132001 | القالب غير موجود بهذه اللغة أو غير معتمد. | تأكد من اسم القالب ورمز اللغة وأن حالته Approved. |
| 131042 | مشكلة في وسيلة الدفع. | اضبط الفوترة في WhatsApp Manager (وسيلة الدفع، العملة، المنطقة الزمنية). |
| 368 / 131031 | الحساب مقيّد أو معطّل لمخالفة سياسة (أو بيانات غير مطابقة مثل رمز PIN خاطئ في 131031). | راجع صفحة جودة الحساب واطلب مراجعة، واستخدم Health Status لمعرفة السبب. |
أخطاء وصول الرسالة للعميل
هذه الأخطاء تعني أن الرسالة خرجت من نظامك لكنها لم تصل للعميل:
| الكود | المعنى | الحل |
|---|---|---|
| 131026 | تعذّر تسليم الرسالة. الأسباب: الرقم ليس على واتساب، أو العميل لم يوافق على الشروط الجديدة، أو نسخة التطبيق قديمة. | تواصل مع العميل بوسيلة أخرى ليتأكد أنه يستطيع مراسلتك، ويوافق على الشروط، ويحدّث التطبيق. لا تُعِد الإرسال تلقائياً. |
| 131047 | مرّ أكثر من 24 ساعة على آخر رد من العميل. | أرسل قالباً معتمداً. الرسائل العادية مسموحة فقط داخل نافذة الـ 24 ساعة. |
| 131049 | لم تُسلَّم الرسالة للحفاظ على تفاعل صحي. | إن كان السبب حد التسويق لكل مستخدم فانتظر 24 ساعة على الأقل. التفاصيل: حل مشكلة «لم يتم إرسال الرسالة». |
| 131050 | العميل اختار إيقاف رسائل التسويق منك. | لا تُعِد المحاولة، فلن تصله الرسائل. |
| 131056 | رسائل كثيرة من رقمك لنفس رقم العميل في فترة قصيرة. | انتظر قبل إعادة الإرسال لنفس الرقم، وأرسل للأرقام الأخرى عادي. |
| 131051 | نوع رسالة غير مدعوم. | استخدم نوع رسالة مدعوماً ثم أعد المحاولة. |
| 131052 | تعذّر تنزيل الوسائط التي أرسلها العميل. | اطلب من العميل إرسال الملف بطريقة أخرى. |
| 131053 | تعذّر رفع الوسائط في رسالتك (غالباً نوع ملف غير مدعوم). | تأكد من نوع الملف (MIME) وأنه من الأنواع المدعومة. |
| 131021 | رقم المرسل والمستقبل متطابقان. | أرسل إلى رقم مختلف عن رقم الشركة. |
أخطاء القوالب (Templates)
تظهر عند إرسال قالب غير معتمد، أو بمتغيرات ناقصة، أو بجودة منخفضة:
| الكود | المعنى | الحل |
|---|---|---|
| 132000 | عدد قيم المتغيرات في الطلب لا يطابق المتغيرات في القالب. | أرسل قيمة لكل متغير يحتاجه القالب. |
| 132001 | القالب غير موجود باللغة المحددة أو لم يُعتمد. | تحقق من اسم القالب ورمز اللغة (مثل ar أو ar_EG) وحالة الاعتماد. |
| 132005 | النص المترجم أطول من المسموح. | راجع ترجمة القالب في WhatsApp Manager. |
| 132007 | محتوى القالب يخالف سياسة واتساب. | راجع أسباب رفض القوالب وعدّل المحتوى. |
| 132012 | صيغة قيم المتغيرات غير صحيحة. | التزم بالصيغة المحددة لكل متغير في القالب. |
| 132015 | القالب متوقف مؤقتاً بسبب انخفاض جودته. | عدّل القالب لتحسين جودته، ثم أرسله بعد اعتماده من جديد. |
| 132016 | القالب أُوقف نهائياً بعد تكرار إيقافه لانخفاض الجودة. | أنشئ قالباً جديداً بمحتوى مختلف. |
| 132068 / 132069 | الـ Flow محظور، أو مقيّد بعد إرسال 10 رسائل به خلال ساعة. | صحّح الـ Flow. |
أخطاء الحساب والسياسات والدفع
هذه الأخطاء الأخطر لأنها توقف الإرسال من الرقم كله، فعالجها فوراً:
| الكود | المعنى | الحل |
|---|---|---|
| 368 | حساب واتساب للأعمال المرتبط بالتطبيق مقيّد أو معطّل لمخالفة سياسة. | راجع وثيقة تطبيق السياسات (Policy Enforcement) واطلب مراجعة من جودة الحساب. |
| 131031 | الحساب مقفل لمخالفة سياسة، أو بيانات الطلب لا تطابق الحساب (مثل رمز PIN خاطئ). | راجع سياسات الإنفاذ، واستخدم Health Status API لمعرفة السبب. |
| 131042 | مشكلة في وسيلة الدفع: حساب دفع غير مربوط، أو تجاوز حد الائتمان، أو عملة أو منطقة زمنية غير مضبوطة، أو حساب محذوف أو موقوف. | اضبط الفوترة في WhatsApp Manager وتأكد من ربط وسيلة دفع فعّالة. |
| 131048 | قيود على عدد الرسائل من هذا الرقم، غالباً لأن رسائل سابقة كثيرة حُظرت أو بُلّغ عنها كسبام. | راجع تقييم الجودة في WhatsApp Manager. اقرأ نصائح للحفاظ على رقم واتساب API. |
| 131057 / 2494100 | الحساب أو الرقم في وضع الصيانة، وقد يكون ذلك بسبب ترقية سعة الإرسال. | انتظر بضع دقائق ثم أعد المحاولة. |
أخطاء تسجيل الرقم والتحقق
تظهر غالباً أثناء ربط رقم جديد أو إعادة تسجيله. للتجهيز الصحيح اقرأ شروط رقم الهاتف لتفعيل واتساب API.
| الكود | المعنى | الحل |
|---|---|---|
| 131045 | فشل الإرسال بسبب خطأ في تسجيل رقم الهاتف. | سجّل الرقم أولاً ثم أعد المحاولة. |
| 133000 | محاولة سابقة لإلغاء تسجيل الرقم فشلت. | ألغِ تسجيل الرقم مرة أخرى قبل تسجيله. |
| 133005 | رمز PIN للتحقق بخطوتين غير صحيح. | تأكد من الرمز، أو عطّل التحقق بخطوتين ثم ضع رمزاً جديداً. |
| 133006 | يجب التحقق من الرقم قبل تسجيله. | أكمل التحقق من الرقم ثم سجّله. |
| 133008 / 133009 | محاولات PIN كثيرة، أو أُدخل الرمز بسرعة كبيرة. | انتظر المدة المذكورة في تفاصيل الخطأ ثم أعد المحاولة. |
| 133010 | الرقم غير مسجل على منصة واتساب للأعمال. | سجّل الرقم ثم أعد المحاولة. |
| 133015 | الرقم حُذف مؤخراً ولم يكتمل الحذف بعد. | انتظر 5 دقائق ثم أعد المحاولة. |
| 133016 | محاولات تسجيل أو إلغاء تسجيل كثيرة في وقت قصير، فحُظر الرقم مؤقتاً. | انتظر حتى يُرفع الحظر ثم أعد المحاولة. |
| 131037 | رقم الاختبار (555) ليس له اسم عرض معتمد. | غيّر اسم العرض. اقرأ دليل اسم العرض في واتساب API. |
أخطاء الصلاحيات ورمز الوصول والحدود
تهم المطورين ومن يربطون أنظمتهم بالـ API مباشرة:
| الكود | المعنى | الحل |
|---|---|---|
| 0 / 190 | تعذّر التحقق من المستخدم أو انتهت صلاحية رمز الوصول (Access Token). | أنشئ رمز وصول جديداً. |
| 200 | لم يُرسل رمز وصول مع الطلب. | أضف رمز وصول صالحاً للطلب. |
| 3 / 10 / 131005 | مشكلة في الصلاحيات: غير ممنوحة أو أُزيلت. | راجع صلاحيات التطبيق بأداة Access Token Debugger. |
| 4 | التطبيق وصل لحد عدد طلبات الـ API. | خفّف عدد الطلبات وأعد المحاولة لاحقاً. |
| 130429 | وصلت لحد سرعة الإرسال (Throughput) في Cloud API. | أبطئ معدل الإرسال وأعد المحاولة لاحقاً. |
| 100 / 131008 / 131009 / 135000 | معامِلات ناقصة أو غير صحيحة أو بصيغة خاطئة في الطلب. | راجع صيغة الطلب والمعاملات المطلوبة في مرجع الـ API. |
| 131000 | فشل الإرسال لخطأ غير معروف. | أعد المحاولة، وإن تكرر الخطأ افتح تذكرة دعم مع Meta. |
| 131016 / 133004 | الخدمة غير متاحة مؤقتاً. | راجع صفحة حالة منصة واتساب للأعمال قبل إعادة المحاولة. |
| 130472 | الرسالة لم تُرسل لأن الرقم ضمن تجربة تسويقية تجريها Meta. | راجع «تجارب رسائل التسويق» في توثيق Meta. |
أخطاء نقل الرقم من منصة أخرى (2388103)
يأتي الكود 2388103 بعدة رسائل مختلفة، والرسالة هي ما يحدد الحل:
| الكود | المعنى | الحل |
|---|---|---|
| 2388103 | «Registered name should be present and approved»: اسم العرض للرقم غير معتمد أو عليه طلب تغيير معلّق. | احصل على اعتماد اسم العرض أولاً، ثم أعد محاولة النقل. |
| 2388103 | «Please add this phone number in your WhatsApp account»: الرقم مؤهل للإضافة المباشرة. | أضف الرقم وسجّله مباشرة بدون واجهات النقل. |
| 2388103 | «There was an error migrating this phone number»: حدث خطأ أثناء النقل. | أعد المحاولة بعد فترة، وإن استمر تواصل مع الدعم. |
| 2388103 | «Cannot migrate phone number» ورسائل مشابهة. | Meta تذكر أن نقل الرقم بهذه الطريقة غير مدعوم للحسابات على نموذج حساب واتساب الجديد. |
للخطوات الكاملة: نقل رقم WhatsApp Cloud API من منصة أخرى إلى مظبوت.
قواعد ذهبية قبل إعادة المحاولة
- لا تُعِد الإرسال تلقائياً للأخطاء 131026 و131047 و131049 و131050. إعادة المحاولة هنا لا توصل الرسالة، وقد تضر بجودة رقمك.
- مع 130429 و131056: أبطئ الإرسال وانتظر، فالمشكلة في السرعة وليست في المحتوى.
- مع 131048: افتح تقييم الجودة في WhatsApp Manager قبل أي حملة جديدة.
- احفظ الكود وتفاصيله (الحقل error_data.details) في سجلاتك، فهو أسرع طريق للحل مع الدعم.
- اعتمد على الرقم لا النص: Meta تقول إن عناوين الأخطاء قد تتغير، فاربط أي منطق في نظامك برقم الكود.
كيف يساعدك مظبوت؟
مظبوت يتحقق من صلاحية رقمك ورمز الوصول قبل إرسال أي حملة، فيمنع فشلها بالكامل بسبب الربط. وإذا ظهر لك أي خطأ، أرسل رقم الخطأ لفريق دعم مظبوت على ماسنجر وسنساعدك في حله.
أسئلة شائعة
ما الفرق بين الخطأ 131047 والخطأ 131026؟
131047 يعني أن الرسالة العادية أُرسلت بعد انتهاء نافذة الـ 24 ساعة، والحل إرسال قالب. أما 131026 فيعني أن الرسالة لم تصل للعميل نفسه، لأن رقمه ليس على واتساب أو تطبيقه قديم أو لم يوافق على الشروط.
لماذا يظهر 131049 مع أن رقم العميل سليم؟
لأن Meta تحدّ من عدد رسائل التسويق التي يستقبلها كل مستخدم لحماية تجربته. الحل أن تنتظر 24 ساعة على الأقل، وتركّز التسويق على العملاء المتفاعلين.
هل أدفع على الرسائل الفاشلة؟
نظام Meta يحاسب على الرسائل المُسلَّمة. الرسالة التي فشلت ولم تصل لا تدخل في حصة رسائل الخدمة المجانية ولا في المحاسبة. التفاصيل في تغييرات أسعار واتساب API من أكتوبر 2026.
ما أول خطوة إذا ظهر الخطأ 368؟
افتح جودة الحساب في Meta Business Suite أو WhatsApp Manager، واعرف المخالفة، ثم اطلب مراجعة. وأوقف أي حملات حتى تُحل المشكلة.
هل تتغير أكواد الأخطاء؟
تضيف Meta أكواداً جديدة وتحدّث الأوصاف من وقت لآخر، ونحن نراجع هذا الدليل دورياً مقابل المرجع الرسمي.
المصادر
- Meta: WhatsApp Cloud API error codes (اطّلعنا عليها في 3 نوفمبر 2026)
- حالة منصة واتساب للأعمال (Meta Status)
واتساب API بدون صداع
مع مظبوت: ربط رسمي لرقمك الحالي، وتحقق تلقائي قبل كل حملة، وفريق دعم يتكلم عربي. أول شهر مجاناً.
