> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# اخطاء الواتساب

> اخطاء الواتساب

عند استخدام قناة واتساب في **كرزون**، قد تواجه أحياناً فشلاً في إرسال أو تسليم بعض الرسائل. تعتمد كرزون على الربط الرسمي مع Meta (WhatsApp Business API/Cloud API)، وبالتالي فإن الأخطاء التي تظهر تعكس حالة الحساب أو سياسات Meta.

تستعرض هذه المقالة أشهر أخطاء الرسائل (Message Errors)، وأسبابها، وكيفية حلها لضمان وصول رسائلك للعملاء بنجاح.

***

## 1. أخطاء الرسائل غير القابلة للتسليم (Undeliverable Messages)

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

| كود الخطأ (Meta)             | رسالة الخطأ                              | السبب المحتمل | الحل |
| ---------------------------- | ---------------------------------------- | ------------- | ---- |
| **131026**                   | **Unable to deliver message**            |               |      |
| (غير قادر على تسليم الرسالة) | - رقم المستلم ليس عليه حساب واتساب فعال. |               |      |

* المستلم لم يوافق على شروط الخدمة الجديدة لواتساب.
* المستلم يستخدم إصداراً قديماً جداً من تطبيق واتساب. | تواصل مع العميل عبر قناة أخرى (مثل البريد الإلكتروني أو SMS) واطلب منه التأكد من تفعيل رقمه على واتساب وتحديث التطبيق لآخر إصدار. |
  \| **130403** | **Business has blocked the end user**
  (النشاط التجاري حظر المستخدم) | قمت بحظر هذا العميل من حسابك التجاري على واتساب. | لا تحاول إعادة الإرسال. يجب عليك رفع الحظر عن المستخدم أولاً لتتمكن من مراسلته مجدداً. |
  \| **131021** | **Sender and recipient phone number is the same** | تحاول إرسال رسالة من رقمك التجاري إلى نفس الرقم. | تأكد من أنك ترسل الرسالة إلى رقم عميل مختلف، ولا تختبر الإرسال إلى رقمك التجاري نفسه. |
  \| **131045** | **Phone number registration error** | حدث خطأ في تسجيل رقم هاتفك التجاري. | يجب إعادة التحقق من تسجيل الرقم (Registration) في إعدادات واتساب قبل المحاولة مرة أخرى. |

***

## 2. أخطاء الحساب المحظور أو المقيد (Account Blocked / Restricted)

هذه الأخطاء تعني أن حسابك التجاري أو رقمك تعرّض لقيود أو حظر من قِبل Meta بسبب مخالفة السياسات.

| كود الخطأ (Meta)                                            | رسالة الخطأ                                                                                                             | السبب المحتمل                                                                                          | الحل |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ---- |
| **368**                                                     | **Account restricted or disabled for violating policy**                                                                 |                                                                                                        |      |
| (الحساب مقيد أو معطّل لمخالفة السياسة)                      | تم تقييد حساب WABA الخاص بك بسبب مخالفة سياسات Meta (مثل إرسال محتوى مخالف أو نسبة حظر عالية من المستخدمين).            | راجع سياسات Meta وقدّم طلب مراجعة (Appeal) من خلال **Business Support Home** في Meta Business Suite.   |      |
| **131031**                                                  | **Account restricted or disabled / PIN verification failed**                                                            |                                                                                                        |      |
| (الحساب مقيد أو فشل التحقق من الـ PIN)                      | - الحساب مقيد بسبب مخالفة السياسة.                                                                                      |                                                                                                        |      |
| - أو: رمز التحقق الثنائي (2-Step PIN) الذي أدخلته غير صحيح. | تحقق من صحة رمز الـ PIN. إذا كانت المشكلة في القيود، استخدم **Health Status API** لمعرفة السبب الدقيق وقدّم طلب مراجعة. |                                                                                                        |      |
| **130497**                                                  | **Account restricted from messaging in certain countries**                                                              |                                                                                                        |      |
| (الحساب مقيد من المراسلة في دول معينة)                      | نشاطك التجاري ينتمي لفئة تخضع لقيود جغرافية في بعض الدول وفق سياسة واتساب للأعمال.                                      | راجع سياسة واتساب للأعمال (WhatsApp Business Messaging Policy) للتحقق من الدول المسموح بها لفئة نشاطك. |      |
| **131057**                                                  | **Business Account is in maintenance mode**                                                                             |                                                                                                        |      |
| (الحساب في وضع الصيانة)                                     | حساب واتساب للأعمال يمر بعملية صيانة أو ترقية (مثل ترقية سرعة الإرسال Throughput).                                      | انتظر بضع دقائق وأعد المحاولة. إذا استمرت المشكلة أكثر من ساعة، تواصل مع دعم Meta.                     |      |
| **131042**                                                  | **Payment method error**                                                                                                |                                                                                                        |      |
| (خطأ في طريقة الدفع)                                        | مشكلة في حساب الدفع المرتبط بـ WABA (مثل: تجاوز حد الائتمان، عدم وجود طريقة دفع نشطة، أو الحساب معلق).                  | راجع إعدادات الفوترة في Meta Business Suite وتأكد من وجود طريقة دفع صالحة ونشطة.                       |      |

***

## 3. أخطاء النظام البيئي والتفاعل (Ecosystem & Engagement)

### ما هو "النظام البيئي" في واتساب؟

تحرص Meta على أن تبقى تجربة المستخدم على واتساب **إيجابية وخالية من الإزعاج**. لذلك طوّرت نظاماً يُسمى **"حماية النظام البيئي" (Ecosystem Protection)**، وهو نظام ذكي يراقب مدى تفاعل المستخدمين مع الرسائل التسويقية الواردة إليهم من الشركات.

> **المبدأ الأساسي:** التقييد ليس عقوبة لك وحدك، بل هو حماية للمستخدم. إذا كان عميل معين يتلقى رسائل تسويقية كثيرة من **عدة شركات مختلفة** في نفس الوقت، يتدخل النظام ويوقف وصول المزيد من الرسائل التسويقية إليه — حتى لو كانت رسالتك أنت ذات جودة عالية.

**مثال توضيحي:**

تخيّل أن عميلاً اشترك في نشرات بريدية لـ 10 متاجر مختلفة على واتساب. في يوم واحد، أرسلت له 7 متاجر رسائل ترويجية. في هذه الحالة، قد يقرر نظام Meta إيقاف وصول الرسالة الثامنة والتاسعة والعاشرة — بغض النظر عن هوية المرسل أو جودة رسالته. هذا هو الخطأ **131049**: لم يتم التسليم ليس لأن رسالتك سيئة، بل لأن هذا العميل تجاوز حد الاستيعاب التسويقي اليومي.

| كود الخطأ (Meta)                                                                                                                                                          | رسالة الخطأ                                                                                                                                                                                                                                                                                                                | السبب المحتمل                                                                                                                                                           | الحل |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| **131049**                                                                                                                                                                | **Not delivered to maintain healthy ecosystem engagement**                                                                                                                                                                                                                                                                 |                                                                                                                                                                         |      |
| (لم يتم التسليم للحفاظ على تفاعل صحي في النظام البيئي)                                                                                                                    | تجاوز هذا المستخدم الحد الأقصى لرسائل التسويق التي يمكنه استقبالها من جميع الشركات مجتمعةً في فترة زمنية محددة. التقييد يشمل **جميع الشركات**، وليس شركتك فقط.                                                                                                                                                             | **لا تحاول إعادة الإرسال فوراً.** انتظر 24 ساعة على الأقل. فكّر في تقليل تكرار حملاتك التسويقية وتحسين استهداف الشرائح لإرسال رسائل أكثر صلة بكل عميل.                  |      |
| **131050**                                                                                                                                                                | **Recipient chose to stop receiving marketing messages**                                                                                                                                                                                                                                                                   |                                                                                                                                                                         |      |
| (اختار المستلم إيقاف الرسائل التسويقية)                                                                                                                                   | العميل اختار صراحة التوقف عن تلقي رسائل تسويقية من نشاطك التجاري عبر زر "إيقاف الرسائل" في واتساب.                                                                                                                                                                                                                         | **توقف فوراً عن مراسلة هذا العميل بالرسائل التسويقية.** يمكنك الاشتراك في **User Preferences Webhook** لتلقي إشعار تلقائي عند توقف أي عميل أو استئنافه لاستقبال رسائلك. |      |
| **131048**                                                                                                                                                                | **Restrictions on how many messages can be sent**                                                                                                                                                                                                                                                                          |                                                                                                                                                                         |      |
| (قيود على عدد الرسائل الممكن إرسالها من هذا الرقم)                                                                                                                        | تم تقييد رقمك التجاري تحديداً لأن نسبة عالية من رسائلك السابقة تم حظرها أو الإبلاغ عنها كـ "مزعجة" (Spam) من قبل عملاء متعددين. هذا التقييد يخص رقمك أنت. كما قد يظهر هذا الخطأ عند تجاوز الحد اليومي لعدد الأرقام المسموح بمراسلتها بحسب مستوى حسابك (Tier): Tier 1: 1,000 رقم يومياً • Tier 2: 10,000 • Tier 3: 100,000. | 1️⃣ راجع جودة قوالبك (Template Quality) في WhatsApp Manager وحسّن محتوى رسائلك.                                                                                         |      |
| 2️⃣ لرفع حد الإرسال اليومي والانتقال لمستوى Tier أعلى، **قم برفع توثيق نشاطك التجاري (Business Verification) عبر كرزون** من خلال الإعدادات ← توثيق حافظة الأعمال في ميتا. |                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                         |      |
| **131056**                                                                                                                                                                | **Too many messages sent in a short period**                                                                                                                                                                                                                                                                               |                                                                                                                                                                         |      |
| (إرسال رسائل كثيرة جداً لنفس الرقم في وقت قصير)                                                                                                                           | إرسال عدد كبير من الرسائل إلى **نفس رقم العميل** في فترة زمنية قصيرة جداً.                                                                                                                                                                                                                                                 | انتظر قليلاً قبل محاولة إرسال رسالة أخرى لنفس العميل. يمكنك مراسلة عملاء آخرين دون مشكلة.                                                                               |      |

***

## 4. أخطاء قوالب الرسائل (Template Errors)

عند بدء محادثة جديدة مع عميل (أو بعد مرور 24 ساعة على آخر رسالة منه)، يجب استخدام "قالب رسالة" (Message Template) معتمد.

| كود الخطأ (Meta)                                                                                                                                                  | رسالة الخطأ                                                                                                                                                              | السبب المحتمل                                                                                   | الحل |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | ---- |
| **131047**                                                                                                                                                        | **More than 24 hours have passed**                                                                                                                                       |                                                                                                 |      |
| (مر أكثر من 24 ساعة)                                                                                                                                              | تحاول إرسال رسالة حرة (نص عادي) لعميل مر أكثر من 24 ساعة على آخر رد منه.                                                                                                 | يجب إرسال **قالب رسالة (Template)** معتمد بدلاً من الرسالة الحرة لفتح نافذة الـ 24 ساعة مجدداً. |      |
| **132001**                                                                                                                                                        | **Template does not exist or not approved**                                                                                                                              |                                                                                                 |      |
| (القالب غير موجود أو غير معتمد)                                                                                                                                   | القالب الذي تحاول استخدامه لم تتم الموافقة عليه بعد، أو أنك تستخدم اسم/لغة خاطئة.                                                                                        | تأكد من حالة القالب في WhatsApp Manager وأنه يحمل حالة "Approved". تأكد من تطابق اللغة تماماً.  |      |
| **132000**                                                                                                                                                        | **Number of variable parameters did not match**                                                                                                                          |                                                                                                 |      |
| (عدد المتغيرات لا يتطابق)                                                                                                                                         | القالب يحتوي على متغيرات (مثل `{{1}}`) ولكنك لم تمرر قيماً لها، أو مررت قيماً ناقصة.                                                                                     | تأكد من تعبئة جميع المتغيرات المطلوبة في القالب قبل الإرسال.                                    |      |
| **132015**                                                                                                                                                        | **Template is paused due to low quality**                                                                                                                                |                                                                                                 |      |
| (تم إيقاف القالب بسبب الجودة المنخفضة)                                                                                                                            | القالب تم الإبلاغ عنه كثيراً كرسالة مزعجة (Spam) وتم إيقافه مؤقتاً.                                                                                                      | قم بتعديل القالب لتحسين جودته وجعله أكثر فائدة للعملاء، وانتظر إعادة الموافقة عليه.             |      |
| **132016**                                                                                                                                                        | **Template permanently disabled**                                                                                                                                        |                                                                                                 |      |
| (تم تعطيل القالب نهائياً)                                                                                                                                         | تم إيقاف القالب مؤقتاً أكثر من مرة بسبب الجودة المنخفضة، وأصبح معطلاً بشكل دائم.                                                                                         | لا يمكن استعادة هذا القالب. قم بإنشاء قالب جديد بمحتوى مختلف.                                   |      |
| **2388019**                                                                                                                                                       | **Message Template Limit Exceeded**                                                                                                                                      |                                                                                                 |      |
| (تجاوزت الحد الأقصى لعدد قوالب الرسائل)                                                                                                                           | وصل حسابك للحد الأقصى المسموح به من عدد القوالب في حساب واتساب للأعمال (WABA). تسمح Meta بعدد محدود من القوالب لكل حساب، ويرتفع هذا الحد بعد إتمام توثيق النشاط التجاري. | 1️⃣ احذف القوالب القديمة أو غير المستخدمة من WhatsApp Manager لتوفير مساحة لقوالب جديدة.        |      |
| 2️⃣ لرفع الحد الأقصى لعدد القوالب المسموح بها، **قم برفع توثيق نشاطك التجاري (Business Verification) عبر كرزون** من خلال الإعدادات ← توثيق حافظة الأعمال في ميتا. |                                                                                                                                                                          |                                                                                                 |      |
| **132007**                                                                                                                                                        | **Template content violates a WhatsApp policy**                                                                                                                          |                                                                                                 |      |
| (محتوى القالب يخالف سياسة واتساب)                                                                                                                                 | القالب يحتوي على محتوى مخالف لسياسات Meta (مثل محتوى مضلل أو ممنوع).                                                                                                     | راجع سياسة مراجعة القوالب لدى Meta وأعد صياغة القالب ليتوافق مع الإرشادات.                      |      |

***

## 5. أخطاء الوسائط والملفات (Media Errors)

تحدث هذه الأخطاء عند محاولة إرسال أو استقبال صور، فيديوهات، أو مستندات.

| كود الخطأ (Meta)                         | رسالة الخطأ                                                                            | السبب المحتمل                                                                                        | الحل |
| ---------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---- |
| **131051**                               | **Unsupported message type**                                                           |                                                                                                      |      |
| (نوع رسالة غير مدعوم)                    | نوع الملف أو الرسالة الذي تحاول إرساله غير مدعوم في WhatsApp API.                      | تأكد من إرسال أنواع ملفات مدعومة (مثل JPG, PNG, PDF, MP4).                                           |      |
| **131053**                               | **Unable to upload the media**                                                         |                                                                                                      |      |
| (تعذر رفع الوسائط)                       | فشل النظام في رفع الملف المرفق بالرسالة (غالباً بسبب الحجم الزائد أو صيغة غير مدعومة). | تحقق من حجم الملف (يجب ألا يتجاوز الحدود المسموحة) وتأكد من أن صيغة الملف (MIME Type) مدعومة رسمياً. |      |
| **131052**                               | **Unable to download media sent by user**                                              |                                                                                                      |      |
| (تعذر تنزيل الوسائط المرسلة من المستخدم) | أرسل العميل ملفاً ولكن فشل النظام في تنزيله.                                           | اطلب من العميل إعادة إرسال الملف أو إرساله عبر وسيلة أخرى.                                           |      |

***

## 6. أخطاء حدود الإرسال (Rate Limits & Throttling)

| كود الخطأ (Meta)                     | رسالة الخطأ                                                                          | السبب المحتمل                                                                         | الحل |
| ------------------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ---- |
| **130429**                           | **Rate limit hit / Throughput reached**                                              |                                                                                       |      |
| (تم الوصول للحد الأقصى للسرعة)       | حسابك وصل للحد الأقصى لعدد الرسائل المسموح إرسالها في الثانية.                       | قم بتقليل سرعة إرسال الرسائل الجماعية (Broadcasts) أو انتظر قليلاً وأعد المحاولة.     |      |
| **131064**                           | **Messaging limit reached due to violations**                                        |                                                                                       |      |
| (الوصول لحد المراسلة بسبب المخالفات) | تم تقييد حسابك بسبب مخالفة تصنيفات القوالب (مثل إرسال رسائل تسويقية في قوالب خدمات). | راجع تصنيف قوالبك في WhatsApp Manager. يتم رفع هذا التقييد تلقائياً بعد فترة العقوبة. |      |
| **80007**                            | **WhatsApp Business Account rate limit reached**                                     |                                                                                       |      |
| (تم الوصول لحد معدل الطلبات للحساب)  | حساب WABA تجاوز الحد الأقصى لعدد طلبات API في فترة زمنية محددة.                      | قلل من تكرار طلبات API وانتظر قبل إعادة المحاولة.                                     |      |

***

## 7. أخطاء الدفع والفوترة (Payment Errors)

| كود الخطأ (Meta)                     | رسالة الخطأ                                                                                        | السبب المحتمل                                                                                  | الحل |
| ------------------------------------ | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---- |
| **131042**                           | **Payment method error**                                                                           |                                                                                                |      |
| (خطأ في طريقة الدفع)                 | مشكلة في حساب الدفع المرتبط بـ WABA: لا توجد طريقة دفع نشطة، أو تجاوز حد الائتمان، أو الحساب معلق. | راجع إعدادات الفوترة في Meta Business Suite وتأكد من وجود طريقة دفع صالحة ونشطة مرتبطة بحسابك. |      |
| **134011**                           | **WhatsApp Payments terms of service acceptance pending**                                          |                                                                                                |      |
| (قبول شروط خدمة مدفوعات واتساب معلق) | لم يتم قبول شروط خدمة مدفوعات واتساب لهذا الحساب بعد.                                              | اقبل شروط خدمة مدفوعات واتساب عبر الرابط المرفق في رسالة الخطأ.                                |      |

***

## 8. أخطاء تقنية وعامة (Technical & General Errors)

| كود الخطأ (Meta)                   | رسالة الخطأ                                     | السبب المحتمل                                                                                                          | الحل |
| ---------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---- |
| **131000**                         | **Unknown error**                               |                                                                                                                        |      |
| (خطأ غير معروف)                    | خطأ غير محدد أثناء إرسال الرسالة.               | أعد المحاولة. إذا استمر الخطأ، تواصل مع دعم Meta عبر Direct Support مع ذكر الـ `fbtrace_id`.                           |      |
| **131016**                         | **Service temporarily unavailable**             |                                                                                                                        |      |
| (الخدمة غير متاحة مؤقتاً)          | انقطاع مؤقت في خدمة واتساب Cloud API.           | تحقق من صفحة حالة خدمة واتساب على [metastatus.com](https://metastatus.com/whatsapp-business-api) وأعد المحاولة لاحقاً. |      |
| **1**                              | **Invalid request or server error**             |                                                                                                                        |      |
| (طلب غير صالح أو خطأ في الخادم)    | خطأ في صياغة الطلب أو انقطاع مؤقت في الخادم.    | تحقق من صفحة حالة الخدمة. إذا لا توجد انقطاعات، راجع صياغة الطلب.                                                      |      |
| **2**                              | **Temporary error due to downtime or overload** |                                                                                                                        |      |
| (خطأ مؤقت بسبب انقطاع أو ضغط زائد) | الخادم مثقل أو يمر بانقطاع مؤقت.                | انتظر وأعد المحاولة. تحقق من صفحة حالة الخدمة.                                                                         |      |
| **135000**                         | **Unknown error with request parameters**       |                                                                                                                        |      |
| (خطأ غير معروف في معاملات الطلب)   | خطأ في معاملات الطلب غير محدد بدقة.             | راجع توثيق الـ API للتأكد من صحة الصياغة. تواصل مع الدعم إذا استمر الخطأ.                                              |      |

***

### نصائح عامة لتجنب أخطاء واتساب:

1. **احصل على موافقة العملاء (Opt-in):** لا ترسل رسائل إلا للعملاء الذين وافقوا مسبقاً على تلقي رسائل منك.

2. **راقب جودة الحساب:** قم بزيارة **WhatsApp Manager** بانتظام للتحقق من جودة رقمك (يجب أن تكون خضراء/High).

3. **احترم نافذة الـ 24 ساعة:** استخدم قوالب الرسائل (Templates) دائماً لفتح المحادثات الجديدة.

4. **لا تُفرط في الإرسال التسويقي:** وزّع حملاتك على أيام متعددة وتجنب إرسال رسائل كثيرة لنفس الشريحة في يوم واحد.

5. **استهدف بدقة:** الرسالة الصحيحة للشخص الصحيح في الوقت الصحيح تقلل من نسبة الحظر وتحمي تقييم حسابك.


## Related topics

- [نظرة عامة على مدير الواتساب](/ar/help-center/guides/whatsapp/doc-1890487.md)
- [ما هو الواتساب المؤسسي (API)؟](/ar/help-center/guides/whatsapp/getting-started/api-1890472.md)
- [الاسعار وطريقة عمل تسعير الواتساب](/ar/help-center/guides/whatsapp/pricing/doc-1890483.md)
- [طرق الربط مع الواتساب المؤسسي API](/ar/help-center/guides/whatsapp/getting-started/api-1890475.md)
- [استكشاف الأخطاء](/ar/mcp-server/guides/troubleshooting.md)