رموز أخطاء WhatsApp API: القائمة الكاملة مع الأسباب والحلول (2026)

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

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

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

أ) أخطاء التفويض: تحدث أخطاء المصادقة عندما يتعذر على نظام WhatsApp API التحقق من بيانات اعتماد المستخدم أو التطبيق الذي يرسل الطلبات أو من صلاحياته.

الرمز	الوصف	الحل المحتمل
0	AuthException يتعذر على Meta مصادقة مستخدم التطبيق؛ وقد يكون الرمز المميز منتهي الصلاحية أو تغيير صلاحية الوصول إلى البيانات من الأسباب المحتملة .	أعِد التحقق من أذونات التطبيق أو أنشئ رمز وصول هنا ، أو استفسر من مزوّد الحلول عن الخطوات.
3	طريقة API عدم توفر الأذونات اللازمة لإجراء استدعاء API أو وجود خطأ في إعداد استدعاء API	راجع إعدادات API أو أعِد إنشاء رمز الوصول. تواصل مع مزوّد الحلول إذا كنت تستخدم أحدهم.
10	تم رفض الإذن لم تُمنح أذونات كافية لتطبيقك، أو أُزيلت صلاحية الوصول. رقم هاتف غير معتمد: رقم الهاتف غير معتمد أو غير مدرج ضمن الأرقام المسموح بها لحساب WhatsApp API	أعِد التحقق من رمز API للتأكد من وجود أذونات التطبيق اللازمة هنا. راجع مزوّد الحلول لمعرفة الخطوات اللازمة إذا كنت تستخدم أحدهم. تحقق من تسجيل رقم الهاتف واعتماده بشكل صحيح في حساب WhatsApp Business. أكمِل التسجيل والاعتماد إذا لم ينفّذهما مزوّد الحلول.
190	تم رفض الإذن انتهت صلاحية رمز الوصول، وتم حظر الوصول إلى API	احصل على رمز وصول جديد للتطبيق المعني للتأكد من تفعيل جميع الأذونات. ويمكن لمزوّد الحلول إرشادك إلى الخطوات.
200-299	أخطاء أذونات API أذونات مفقودة أو ملغاة: تقييد الوصول إلى ميزات API محددة	تحقق من رمز API للحصول على أذونات التطبيق اللازمة هنا. راجع مزوّد الحلول لمعرفة الخطوات المطلوبة إذا كنت تستخدم حلّه.

ب) أخطاء تحديد المعدل: تحدث عندما يتجاوز تطبيقك الحد المخصص لمعدل استدعاءات API المحدد لحسابك.

الرمز	الوصف	الحل المحتمل
4	عدد استدعاءات API كبير جدًا تجاوز التطبيق الحد الأقصى لمعدل استدعاءات API	راقب معدلات استدعاءات API وحسّنها استباقيًا. وخطّط مسبقًا للتعامل مع حدود معدل API
80007	مشكلات حدود المعدل بلغ حساب WhatsApp API حد المعدل الخاص به	حاول مرة أخرى لاحقًا أو قلّل عدد استدعاءات API.
130429	تم بلوغ حد المعدل تم تجاوز حد معدل إرسال الرسائل.	عليك تقليل وتيرة إرسال الرسائل، أو إعادة المحاولة لاحقًا
131048	تم بلوغ حد معدل الرسائل غير المرغوب فيها قد يحدث ذلك بسبب القيود المفروضة على حجم الرسائل المرسلة من رقم الهاتف في حساب API. وقد يرجع ذلك إلى سجل سابق من الإبلاغ عن الرسائل كرسائل غير مرغوب فيها وحظر المستلمين لها.	تحقق من حالة الجودة في WhatsApp Manager وقلّل وتيرة إرسال الرسائل.
131056	تم بلوغ حد معدل الإرسال إلى المستلِم إرسال عدد كبير من الرسائل في فترة قصيرة من رقم هاتف المُرسِل إلى مستلِم لديه رقم هاتف محدد.	انتظر ثم أعد محاولة إرسال الرسائل إلى رقم هاتف المستلِم نفسه. لا توجد قيود على إرسال الرسائل إلى أرقام هواتف أخرى.
133016	تم تجاوز حد تسجيل أرقام الهواتف وإلغاء تسجيلها تحد WhatsApp عدد محاولات التسجيل أو إلغاء التسجيل إلى 10 خلال فترة 72-hour	انتظر قليلًا ثم حاول مرة أخرى بعد انقضاء فترة الحظر البالغة 72-hour.

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

الرمز	الوصف	الحل المحتمل
368	حظر مؤقت بسبب انتهاك السياسات حساب WhatsApp Business المرتبط مقيّد أو محظور بسبب انتهاك إحدى سياسات المنصة.	راجع سياسات WhatsApp لفهم الانتهاكات وحلها، أو استشر مزوّد حلول WhatsApp لمعالجة المشكلة.
130497	قيود على المراسلة في بعض البلدان: يُحظر على حساب WhatsApp Business مراسلة المستخدمين في بلدان محددة بسبب قيود الفئات أو السياسات المحلية	راجع سياسة WhatsApp الجغرافية وقيود المراسلة حسب البلد هنا. لمزيد من التفاصيل، تواصل مع دعم WhatsApp أو مزوّد الحلول.
131031	الحساب مقفل حساب WhatsApp Business مقيّد أو معطّل بالكامل بسبب انتهاك سياسة المنصة أو سياسة التجارة. وقد يرجع ذلك إلى عدم التحقق الكافي من محتوى الرسائل أو البيانات.	راجع إرشادات سلامة المراسلة أو سياسة المنصة المتعلقة بـ التصدي للرسائل غير المرغوب فيها.

د) أخطاء قوالب الرسائل: مشكلات تتعلق بقوالب الرسائل المنظّمة والمحددة مسبقًا، وقد تنتج عن عوامل مثل انتهاك السياسات أو المحتوى المحظور أو حدود المعدل أو مشكلات التنسيق.

الرمز	الوصف	الحل المحتمل
132000	عدم تطابق عدد معلمات القالب لا يتطابق عدد المعلمات المتغيرة في الرسالة مع عدد المتغيرات المحددة في القالب المعتمد	راجع الرسالة واطّلع على إرشادات القوالب، وتأكد من تعريف جميع المعلمات المتغيرة
132001	القالب غير موجود إما أن القالب غير معتمد أو أنه غير متوفر باللغة المحددة.	تأكد من اعتماد قالب الرسالة وصحة اسم الرسالة وإعدادات اللغة المحلية. لمزيد من التفاصيل، راجع سياسة قوالب المراسلة
132005	القالب المترجم يتجاوز الحد الأقصى لعدد الأحرف تتجاوز القوالب التفاعلية، بما فيها جميع الأزرار والردود السريعة والأحرف النصية الأخرى، الحدود المسموح بها عند ترجمتها.	راجع محتوى القالب، وبسّطه وقلّل عدد الأحرف، ويُفضّل استخدام محتوى موجز. راجع حالة القالب لاتخاذ إجراء إضافي.
132007	مخالفة سياسة تنسيق القالب يحدث هذا الخطأ إذا احتوى المحتوى على أحرف غير مدعومة أو تنسيق غير صحيح أو عناصر أخرى لا تتوافق مع إرشادات WhatsApp.	راجع سبب الرفض وعدّل محتوى القالب مجددًا.
132012	عدم تطابق تنسيق معلمات القالب إرسال معلمات غير صحيحة (مثل صورة بدلًا من فيديو) في رسالة القالب، بحيث لا تطابق تنسيق القالب المعتمد.	تأكد من تطابق معلمات القالب مع تنسيق القالب المعتمد. استعِن بمزوّد حلول WhatsApp عند الحاجة.
132015	إيقاف القالب مؤقتًا تم إيقاف القالب مؤقتًا بسبب انخفاض تقييم الجودة، ولا يمكن لحساب API إرسال رسائل بهذا القالب إلى المستخدمين.	عدّل القالب وحسّن جودته، ثم حاول إرساله مجددًا.
132016	تعطيل القالب إذا تم إيقاف القالب مؤقتًا عدة مرات بسبب انخفاض الجودة، فسيعطّله WhatsApp.	يُستحسن إنشاء قالب جديد وتعديل محتواه والتأكد من جودته.

e) خطأ في تسليم الرسالة: يتعلق هذا بتعذّر تسليم الرسالة إلى المستلِم بسبب المحتوى أو الإعدادات أو مشكلات من جهة المستلِم.

الرمز	الوصف	الحل المحتمل
131026	تعذّر تسليم الرسالة قد تشمل الأسباب ما يلي -لا يوجد رقم WhatsApp صالح للمستلِم -يستخدم المستلِم إصدارًا قديمًا من تطبيق WhatsApp -لم يوافق المستلِم على شروط الخدمة وسياسة الخصوصية الجديدة في WhatsApp	يجب على المستلِم الموافقة على شروط وأحكام WhatsApp T&Cs، أو تسجيل حساب WhatsApp، أو تحديث إصدار التطبيق.
131047	رسالة إعادة التفاعل مرّت أكثر من 24 ساعة منذ آخر رد للمستلِم.	استخدم قالب رسالة تبدأها الشركة لبدء محادثة جديدة مع المستخدم.
131049	لم يسلّم Meta الرسالة اختار Meta عدم تسليم الرسالة للحفاظ على تفاعل صحي ضمن المنظومة.	قد يعود ذلك إلى الحد الأقصى لرسائل التسويق لكل مستخدم (اقرأ مزيدًا من التفاصيل هنا). أعد المحاولة بعد فترة زمنية معينة.
131051	نوع الرسالة غير مدعوم محاولة إرسال رسائل بتنسيق قالب (وسائط أو بيانات أخرى) لا يدعمها WhatsApp.	تحقّق من أنواع الرسائل المدعومة في وثائق WhatsApp.

f) أخطاء الوسائط: أخطاء في معالجة ملفات الوسائط

الرمز	الوصف	الحل المحتمل
131052	خطأ في تنزيل الوسائط يتعذّر على WhatsApp تنزيل الوسائط المضمّنة في رسالة مستخدم WhatsApp.	يُستحسن أن يُطلب من المستخدم إرسال ملف الوسائط عبر قناة غير WhatsApp.
131053	خطأ في تحميل الوسائط تعذّر على WhatsApp تحميل الوسائط لأسباب مثل ملف وسائط غير مدعوم	راجع قائمة تنسيقات ملفات الوسائط التي يدعمها WhatsApp

g) خطأ في WhatsApp Flows: مشكلات متعلقة بميزة WhatsApp Flows

الرمز	الوصف	الحل المحتمل
100	قد يكون السبب إحدى المشكلات العديدة التي قد تحدث أثناء إدارة التدفقات اسم التدفق غير فريد المعرّف المحدد غير موجود JSON أو عنوان URL لنقطة النهاية غير صالح	أدخل اسمًا صالحًا وفريدًا، وتأكد من صحة المعرّف المحدد وعنوان URL كما هو مطبّق. اقرأ المزيد عن معالجة
139000	الحظر بسبب مشكلات النزاهة ربما رصد WhatsApp مشكلات تتعلق بالنزاهة في حساب النشاط التجاري، ما يمنع إنشاء تدفقاتك أو نشرها	تواصل مع دعم Whatsapp أو مزوّد الحلول لحل المشكلة.
139001	لا يمكن تحديث التدفقات لا يمكن تحديث التدفقات بعد نشرها، وستؤدي محاولات ذلك إلى ظهور هذا الخطأ.	استنسخ التدفق، ثم حدّثه وأعِد نشره. استخدم التدفق الجديد بدلًا من القديم.
139002	نشر التدفقات مع تفاصيل غير مكتملة سيؤدي نشر تدفقات بتفاصيل غير مكتملة أو غير صحيحة إلى ظهور هذا الخطأ. وقد يكون السبب أحد الأسباب العديدة التالية تفاصيل غير صالحة أخطاء التحقق المفتاح العام مفقود نقطة النهاية مفقودة الحساب غير مشترك في Flows لا يوجد رقم هاتف في حساب النشاط التجاري	حدّد التفاصيل الناقصة في التدفقات. أضف التفاصيل ذات الصلة باستخدام الحل المناسب، ثم حاول النشر مجددًا.
139003	إيقاف تدفق قد يحدث خطأ أثناء محاولة إيقاف تدفق للأسباب التالية لم يُنشر التدفق بعد تم إيقاف التدفق بالفعل	راجع هذا الدليل حول إيقاف تدفق
139004	لا يمكن حذف تدفق منشور حدث خطأ أثناء حذف تدفق منشور، إذ لا يُسمح بذلك	بعد نشر التدفق، لا يمكن حذفه، جرّب إيقافه بدلاً من ذلك
139006	الحد الأدنى لمقاييس التدفقات لا توجد بيانات كافية لعرض مقاييس التدفق	انتظر حتى تتوفر بيانات كافية في التدفقات لإنشاء المقاييس
132068	تم حظر التدفق تم حظر تنفيذ تدفقات WhatsApp بسبب انتهاكات السياسات أو بلاغات المستخدمين.	راجع التدفق وتحقق من عدم وجود انتهاكات للسياسات أو عدد مفرط من بلاغات المستخدمين.
132069	تم تقييد التدفق تم تقييد قدرة تدفق محدد على WhatsApp مؤقتًا على معالجة الرسائل، إذ تم إرسال 10 رسائل بالفعل خلال ساعة واحدة	راقب أداء التدفق وصححه. اطلب المساعدة من دعم WhatsApp أو من مزود الحلول الذي تتعامل معه.

h) أخطاء متنوعة أخرى:

الرمز	الوصف	الحل المحتمل
131000	حدث خطأ ما تعذر إرسال الرسالة بسبب خطأ غير معروف	أعِد المحاولة أو تواصل مع الدعم. تواصل مع مزود حلول WhatsApp عند الحاجة
131005	تم رفض الوصول لم يمنح WhatsApp الإذن أو ألغاه	جرّب استكشاف الأخطاء وإصلاحها باستخدام هذا الدليل.
131008	المَعلمة المطلوبة غير متوفرة:	راجع المرجع الخاص بنقطة النهاية لمعرفة المعلمات المطلوبة.
131009	قيمة المَعلمة غير صالحة	استخدم المعلمات المدعومة فقط. راجع هذا لمعرفة أنواع المعلمات المدعومة.
131016	الخدمة غير متاحة خدمة WhatsApp غير متاحة مؤقتًا	تواصل مع مزود حلول WhatsApp للحصول على مزيد من التفاصيل، أو تحقق من حالة منصة WhatsApp Business هنا
131021	لا يمكن أن يكون المستلِم هو المُرسِل رقم المُرسِل والمستلِم واحد	استخدم رقمين مختلفين لإرسال الرسالة
131037	اسم العرض غير متوفر يلزم اعتماد اسم عرض في WhatsApp API لإرسال الرسائل. لا يمكن إرسال الرسالة إذا لم تتم الموافقة على اسم العرض	جرّب تغيير اسم العرض والحصول على الموافقة عليه باستخدام هذا الدليل
131042	مشكلة في أهلية النشاط التجاري للدفع حدث خطأ في طريقة الدفع المرتبطة بحساب WhatsApp Business الخاص بك. وقد تشمل الأسباب المحتملة تجاوز حد الائتمان، أو عدم وجود حساب دفع، أو عدم إعداد الدفع أو حد الائتمان، وغير ذلك.	تحقق من تفاصيل الفوترة و طريقة الدفع في WhatsApp Manager للتأكد من إعداد الفوترة بشكل صحيح.
131045	الشهادة غير صحيحة تعذر إرسال الرسائل بسبب خطأ في تسجيل هاتف النشاط التجاري	جرّب تسجيل رقم الهاتف مجددًا، ثم أعد المحاولة
131057	الحساب في وضع الصيانة	تواصل مع دعم WhatsApp أو مزود الحلول الذي تتعامل معه للحصول على مزيد من التفاصيل.