أخطاء واتساب بزنس API: معنى كل رمز وكيفية إصلاحه
عندما تعجز واتساب عن إرسال رسالة أو تسليمها، تعيد ميتا رمز خطأ مثل 131042 أو 131026 مع سبب مختصر. تسرد هذه الصفحة الرموز التي تواجهها متاجر شوبيفاي أكثر من غيرها، بصياغة ميتا نفسها، مع حل لكل منها.
يرسل Whapi، تطبيق شوبيفاي لأتمتة واتساب، رسائلك عبر واتساب بزنس API الرسمية من ميتا، لذا تنطبق هذه الرموز والحلول على كل متجر يستخدم Whapi.
بقلم فريق Whapiآخر تحديث: جرى التحقق منه مع وثائق ميتا للمطورين في
الإجابة المختصرة
- تعيد ميتا رمز خطأ رقميًا وسببًا مختصرًا كلما عجزت واتساب بزنس API عن إرسال رسالة أو تسليمها. وتوصي ميتا بالتصرف بناءً على الرمز، لأن العناوين ستُلغى في النهاية.
- أكثر الأسباب شيوعًا من جانب المتجر: طريقة دفع مفقودة أو فاشلة (131042)، ورقم لا يستطيع استقبال رسائل واتساب (131026)، وردّ بعد إغلاق نافذة 24 ساعة (131047)، ورسالة تسويقية حجبتها ميتا (131049).
- منذ 1 أكتوبر 2026، تحاسب ميتا على رسائل الخدمة بعد 1,000 رسالة مجانية لكل رقم تجاري شهريًا، وتتوقف عن تسليمها للحسابات التي ليس لها طريقة دفع بعد استنفاد الشريحة المجانية.
- تأتي أخطاء الإعداد مثل “Your phone number isn’t eligible to connect to the WhatsApp Business Platform” من مسار التسجيل لدى ميتا، وميتا هي التي تقرر متى تزول.
- الرموز 1 و2 و131016 و133004 تعني عادةً مشكلة من جانب ميتا. تحقق من صفحة حالة ميتا أولًا.
اعثر على مشكلتك
حلول خطوة بخطوة للمشكلات التي تسأل عنها متاجر Whapi أكثر من غيرها.
الخطأ 131042 أو غياب طريقة الدفع
تفشل الرسائل لأن ميتا لا تستطيع محاسبة حسابك. أضف طريقة الدفع أو أصلحها.
رقم الهاتف غير مؤهل
يخبرك تسجيل ميتا بأن رقمك لا يمكن ربطه بعد. اجعل الرقم مؤهلًا.
Coexistence لا تعمل
أخطاء الاقتران ورموز QR والمحادثات المفقودة وانقطاع الاتصال. أصلح Coexistence.
الانتقال من مزوّد آخر
احتفظ برقمك عند ترك Wati أو Zoko أو AiSensy أو Interakt. انقل رقمك إلى Whapi.
قالب مرفوض أو موقوف
اقرأ سبب ميتا، وعدّل ثم أعد الإرسال. أصلح القالب المرفوض.
رسالة تسويقية لم تُسلَّم
حجبت ميتا رسالة تسويقية لحماية التفاعل. الخطأ 131049.
أُغلقت نافذة 24 ساعة
أُرسل ردّ بعد انتهاء نافذة خدمة العملاء. الخطأ 131047.
العميل لا يستطيع استقبال الرسائل
الرقم غير مسجل في واتساب أو أن التطبيق قديم. الخطأ 131026.
توثيق النشاط التجاري
متى تتطلبه ميتا، وما المستندات المقبولة، وماذا تفعل إذا فشل. توثيق النشاط التجاري لدى ميتا.
رموز أخطاء واتساب بزنس API وحلولها
العمود الثاني هو صياغة ميتا نفسها، منسوخة من مرجع رموز الأخطاء ومن وثائقها الخاصة بالتسجيل والاتصال الصوتي وFlows وBSUID في 20 أكتوبر 2026، وتتبعها ترجمة عربية بين قوسين. ابحث في هذه الصفحة عن الرقم الذي يظهر لك.
| الرمز | رسالة ميتا | معناها | ما يجب فعله |
|---|---|---|---|
| 131042 | “There was an error related to your payment method.” (حدث خطأ متعلق بطريقة الدفع الخاصة بك.) | لا تستطيع ميتا محاسبة حساب المراسلة (Messaging account) الذي يرسل رسائلك. | أضف البطاقة أو أصلحها في واتساب Manager. دليل طريقة الدفع |
| 131026 | “Unable to deliver message.” (تعذّر تسليم الرسالة.) | الرقم غير مسجل في واتساب، أو لم يقبل أحدث شروط واتساب، أو يستخدم إصدارًا قديمًا جدًا من التطبيق. | تحقق من الرقم ورمز الدولة. لا تكرر المحاولة باستمرار. الخطأ 131026 |
| 131047 | “More than 24 hours have passed since the recipient last replied to the sender number.” (مرّ أكثر من 24 ساعة منذ آخر مرة ردّ فيها المستلم على رقم المرسل.) | أُرسل ردّ حر النص بعد إغلاق نافذة خدمة العملاء البالغة 24 ساعة. | أرسل قالبًا معتمدًا بدلًا من ذلك. الخطأ 131047 |
| 131049 | “This message was not delivered to maintain healthy ecosystem engagement.” (لم تُسلَّم هذه الرسالة للحفاظ على تفاعل صحي في المنظومة.) | حجبت ميتا قالبًا تسويقيًا موجهًا إلى ذلك العميل. | انتظر 24 ساعة على الأقل قبل إعادة الإرسال. الخطأ 131049 |
| 131050 | “Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business.” (تعذّر تسليم الرسالة. اختار هذا المستلم التوقف عن تلقي الرسائل التسويقية من نشاطك التجاري على واتساب.) | أوقف العميل الرسائل التسويقية من متجرك. | لا تعد محاولة إرسال رسائل تسويقية إلى هذا العميل. أما تحديثات الطلبات المرسلة كقوالب Utility فهي فئة منفصلة. |
| 131048 | “Message failed to send because there are restrictions on how many messages can be sent from this phone number.” (فشل إرسال الرسالة بسبب وجود قيود على عدد الرسائل التي يمكن إرسالها من رقم الهاتف هذا.) | حُظرت رسائل سابقة كثيرة أو أُبلغ عنها كرسائل مزعجة. | تحقق من الجودة في واتساب Manager. الجودة والقيود |
| 130429 | “Cloud API message throughput has been reached.” (تم بلوغ حد إنتاجية رسائل Cloud API.) | أُرسلت الرسائل بسرعة تفوق الإنتاجية المسموح بها للرقم. | أعد المحاولة لاحقًا أو خفّف سرعة الإرسال الجماعي. |
| 131056 | “Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.” (أُرسلت رسائل كثيرة جدًا من رقم المرسل إلى رقم المستلم نفسه خلال فترة قصيرة.) | وصلت عدة رسائل إلى العميل نفسه خلال وقت قصير. | انتظر قبل مراسلة ذلك العميل مجددًا. لا يتأثر العملاء الآخرون. |
| 131037 | “The 555 business phone number used to send the request does not have an approved display name.” (رقم هاتف النشاط التجاري 555 المستخدم لإرسال الطلب ليس له اسم عرض معتمد.) | ينطبق فقط على أرقام +1 555 الأمريكية التي توفرها ميتا أثناء التسجيل، لا على رقم تجلبه بنفسك. | غيّر اسم العرض لرقم 555 هذا في واتساب Manager. رفض اسم العرض |
| 131021 | “Sender and recipient phone number is the same.” (رقم هاتف المرسل والمستلم هو نفسه.) | أُرسلت رسالة تجريبية إلى رقم نشاطك التجاري نفسه. | أرسل الاختبارات إلى رقم واتساب مختلف. |
| 131045 | “Message failed to send due to a phone number registration error.” (فشل إرسال الرسالة بسبب خطأ في تسجيل رقم الهاتف.) | رقم النشاط التجاري غير مسجل للـ API. | أعد ربط الرقم عبر Connect واتساب في Whapi. |
| 133010 | “Phone number not registered on the WhatsApp Business Platform.” (رقم الهاتف غير مسجل في منصة واتساب بزنس.) | السبب نفسه كما في 131045: فقد الرقم تسجيله أو لم يكمله. | أعد ربط الرقم في Whapi، ثم أرسل رسالة تجريبية. |
| 132001 | “The template does not exist in the specified language or the template has not been approved.” (القالب غير موجود باللغة المحددة أو لم تتم الموافقة عليه.) | القالب لا يزال قيد المراجعة، أو رُفض، أو أن اللغة غير مطابقة. | تحقق من حالة القالب. القالب مرفوض |
| 132000 | “The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.” (عدد قيم المتغيرات في الطلب لا يطابق عدد المتغيرات المعرّفة في القالب.) | أرسلت الرسالة متغيرات أقل أو أكثر مما في القالب المعتمد. | اجعل المتغيرات في الرسالة مطابقة للقالب المعتمد، أو أرسل إلى دعم Whapi اسم الأتمتة. |
| 132005 | “Translated text is too long.” (النص المترجم طويل جدًا.) | إحدى النسخ اللغوية للقالب تتجاوز حد الطول لدى ميتا. | اختصر تلك النسخة اللغوية من القالب وأعد إرسالها. |
| 132007 | “Template content violates a WhatsApp policy.” (محتوى القالب ينتهك سياسة واتساب.) | وجدت مراجعة ميتا محتوى لا تسمح به سياساتها. | أعد الصياغة وأعد الإرسال. القالب مرفوض |
| 132015 | “Template is paused due to low quality so it cannot be sent in a template message.” (القالب متوقف مؤقتًا بسبب انخفاض جودته، لذا لا يمكن إرساله في رسالة قالب.) | حظر العملاء هذا القالب أو أبلغوا عنه. | عدّل القالب وأرسله مجددًا بعد أن توافق ميتا على التعديل. |
| 132016 | “Template has been paused too many times due to low quality and is now permanently disabled.” (أُوقف القالب مؤقتًا مرات كثيرة بسبب انخفاض الجودة وأصبح معطلًا نهائيًا.) | لا يمكن استخدام القالب مرة أخرى. | أنشئ قالبًا جديدًا بمحتوى مختلف. |
| 131064 | “Message failed to send because this account has reached its messaging limit due to template classification violations.” (فشل إرسال الرسالة لأن هذا الحساب بلغ حد المراسلة بسبب مخالفات تصنيف القوالب.) | صُنّفت القوالب في فئة خاطئة، مثل إرسال العروض الترويجية كقوالب Utility. | صحّح فئات القوالب؛ وترفع ميتا الحد بعد انتهاء فترة التطبيق. Utility مقابل Marketing |
| 368 | “The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.” (قُيّد حساب واتساب بزنس المرتبط بالتطبيق أو عُطّل لمخالفته سياسة المنصة.) | طبّقت ميتا سياسة واتساب بزنس على الحساب. | راجع التنبيه في Business Support Home وقدّم اعتراضًا إن رأيت أنه خاطئ. |
| 130497 | “The WhatsApp Business Account is restricted from messaging to users in certain countries.” (حساب واتساب بزنس مقيّد من مراسلة المستخدمين في دول معينة.) | لا يمكن لفئة نشاطك التجاري مراسلة العملاء في بعض الدول. | راجع واتساب بزنس Messaging Policy لفئة نشاطك. |
| 131031 | “The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request…” (قُيّد حساب واتساب بزنس المرتبط بالتطبيق أو عُطّل لمخالفته سياسة المنصة، أو تعذّر علينا التحقق من البيانات الواردة في الطلب…) | الحساب مقفل، أو أن بيانات مثل رمز PIN للتحقق بخطوتين لم تتطابق. | تحقق من Business Support Home بحثًا عن قيود، ثم تواصل مع الدعم. |
| 131016 | “A service is temporarily unavailable.” (إحدى الخدمات غير متاحة مؤقتًا.) | مشكلة من جانب ميتا (الرموز 1 و2 و133004 مشابهة). | تحقق من صفحة حالة ميتا وأعد المحاولة لاحقًا. |
| 131000 | “Message failed to send due to an unknown error.” (فشل إرسال الرسالة بسبب خطأ غير معروف.) | لم تستطع ميتا تحديد سبب فشل الرسالة. | أعد المحاولة. وإذا تكرر الأمر، فتواصل مع دعم Whapi مع ذكر الوقت والرقم. |
| 190 | “Your access token has expired.” (انتهت صلاحية رمز الوصول الخاص بك.) | انتهت صلاحية إذن Whapi بالإرسال لحسابك أو أُزيل. | أعد ربط واتساب في Whapi لمنح الوصول مجددًا. |
| 3441045 | “Your phone number isn’t eligible to connect to the WhatsApp Business Platform.” (رقم هاتفك غير مؤهل للاتصال بمنصة واتساب بزنس.) | تحتاج ميتا إلى مزيد من النشاط على تطبيق واتساب بزنس قبل السماح بالربط. | استخدم الرقم بشكل طبيعي ثم أعد المحاولة. الرقم غير مؤهل |
| 2655093 | “The business is already sharing this WhatsApp Business account with a partner.” (النشاط التجاري يشارك بالفعل حساب واتساب بزنس هذا مع شريك.) | رقم تطبيق واتساب بزنس لديك لا يزال مرتبطًا بمزوّد آخر. | افصل ذلك الشريك من التطبيق أولًا. انقل رقمك |
| 4563015 | “Update your WhatsApp Business App to the latest version to use this phone number.” (حدّث تطبيق واتساب بزنس إلى أحدث إصدار لاستخدام رقم الهاتف هذا.) | التطبيق على هاتفك قديم جدًا لـ Coexistence (تشترط ميتا الإصدار 2.24.17 أو أحدث). | حدّث التطبيق ثم أعد المحاولة. حلول Coexistence |
| 138015 | “Calling APIs cannot be enabled for this phone number.” (لا يمكن تفعيل واجهات الاتصال الصوتي (Calling APIs) لرقم الهاتف هذا.) | يتطلب الاتصال الصوتي عبر واتساب حد مراسلة قدره 2,000 أو أكثر. | ارفع حد المراسلة أولًا. الاتصال الصوتي |
| 139000 | “Blocked By Integrity” (محظور بسبب النزاهة) | مشكلة نزاهة في الحساب تمنع إنشاء واتساب Flows أو نشرها. | تحقق من Business Support Home، ثم تواصل مع دعم ميتا. |
| 131062 | “Business-scoped User ID (BSUID) recipients are not supported for this message.” (المستلمون المحددون بمعرّف مستخدم خاص بالنشاط التجاري (BSUID) غير مدعومين لهذه الرسالة.) | وُجّهت الرسالة إلى BSUID، وهو ما لا يقبله هذا النوع من الرسائل. | أرسل إلى رقم هاتف العميل بدلًا من ذلك. |
واتساب بزنس API لا تعمل: تحقق من هذه الأمور الخمسة أولًا
عندما تتوقف كل الرسائل دفعة واحدة، يكون السبب غالبًا واحدًا من خمسة أمور، ويمكنك فحصها جميعًا في دقائق. اتبعها بهذا الترتيب، لأن الفحوصات الأولى تؤثر في كل الرسائل بينما يؤثر الأخير في عملاء بعينهم.
تحقق من صفحة حالة ميتا
افتح صفحة حالة واتساب بزنس API من ميتا. إذا أبلغت ميتا عن مشكلة، فانتظر حتى تُحل قبل تغيير الإعدادات. وتشير إلى ذلك الرموز 1 و2 و131016 و133004.تحقق من حالة رقمك في Whapi
في لوحة تحكم Whapi داخل شوبيفاي، يجب أن تظهر حالة رقم واتساب الخاص بك باللون الأخضر. لا ترسل ميتا الرسائل ولا تستقبلها إلا للأرقام التي حالتها Connected. وإذا لم يكن متصلًا، فانقر على Connect واتساب وأعد ربطه.تحقق من طريقة الدفع في ميتا
افتح واتساب Manager وابحث عن رسالة Add payment method في صفحة Overview. وبدون طريقة دفع صالحة، تفشل رسائل القوالب، غالبًا بالخطأ 131042. اتبع دليل طريقة الدفع.تحقق من حالة القالب
ترسل كل أتمتة في Whapi قالبًا يجب أن توافق عليه ميتا. والقالب الذي لا يزال قيد المراجعة أو المرفوض أو الموقوف مؤقتًا يفشل بالأخطاء 132001 أو 132015 أو 132016. راجع لماذا تُرفض القوالب.تحقق من رقم العميل
إذا كان بعض العملاء فقط لا تصلهم الرسائل، فانظر إلى الرمز على الرسالة الفاشلة. الرمز 131026 يعني أن الرقم لا يستطيع استقبال رسائل واتساب، و131047 يعني أن نافذة 24 ساعة أُغلقت، و131049 و131050 ينطبقان على الرسائل التسويقية.
أخطاء الإعداد والاتصال
تظهر أخطاء الإعداد داخل نافذة التسجيل المنبثقة من ميتا بعد النقر على Connect WhatsApp في Whapi. وهي تأتي من مسار Embedded Signup لدى ميتا، لذا فالصياغة أدناه هي صياغة ميتا، ويتم الحل من جانب ميتا أو واتساب.
“Your phone number isn’t eligible to connect to the WhatsApp Business Platform”
هذا هو الرمز 3441045 من ميتا، ويظهر عند ربط رقم من تطبيق واتساب بزنس. والحل الوحيد الذي تذكره ميتا هو أن تحديد الأهلية يتطلب مزيدًا من النشاط على تطبيق واتساب بزنس، ولا تنشر حدًا أدنى لذلك. ويغطي دليل رقم الهاتف غير المؤهل ما يجب فعله وأخطاء التحقق ذات الصلة.
“This number is registered to an existing WhatsApp account”
تعرض ميتا هذا الخطأ عندما يكون الرقم مستخدمًا بالفعل في واتساب Messenger أو تطبيق واتساب بزنس أو واتساب بزنس API. وإذا كان الرقم على تطبيق واتساب بزنس وتريد مواصلة استخدام التطبيق، فاختر Connect a WhatsApp Business App في إعداد Whapi بدلًا من ذلك (وهذه هي Coexistence في واتساب). ولاستخدام الرقم على الـ API فقط، احذف حساب واتساب على الهاتف أولًا. وتذكر ميتا أن الرقم قد يستغرق حتى 3 دقائق ليصبح متاحًا.
“The business is already sharing this WhatsApp Business account with a partner”
هذا هو الرمز 2655093. رقم تطبيق واتساب بزنس لديك لا يزال مرتبطًا بمزوّد آخر، ولا تدعم ميتا تبديل الشركاء في هذا المسار. افصل الشريك الحالي في تطبيق واتساب بزنس من Settings > Account > Business Platform، وانتظر 15 دقيقة، ثم اربط من جديد. ويغطي دليل نقل رقمك إلى Whapi الأرقام التي تعمل بـ Coexistence والأرقام التي تعمل بالـ API فقط.
نافذة ميتا المنبثقة لا تُفتح أو تُغلق في منتصف العملية
يعمل تسجيل ميتا في نافذة منبثقة. أجرِ إعداد Whapi على جهاز كمبيوتر، واسمح بالنوافذ المنبثقة للوحة تحكم شوبيفاي في المتصفح، وأعد تحميل الصفحة. وإذا قالت ميتا “Your Facebook account is too new to create a business account. Try again in an hour” فانتظر أو سجّل الدخول بحساب Facebook أقدم ونشط. وإذا قالت “User does not have permission to create WhatsApp Business Accounts” فتحتاج إلى صلاحية Admin على محفظة الأعمال التي اخترتها.
رفض اسم العرض
تفحص ميتا اسم العرض في واتساب وفق إرشادات أسماء العرض لديها. وإذا قال التسجيل “Your verified name violates WhatsApp guidelines. Please edit your verified name and try again” فراجع إرشادات أسماء العرض وأدخل اسمًا يتوافق معها. يمكنك تغيير اسم العرض حتى 10 مرات خلال 30 يومًا في واتساب Manager ضمن Account tools > Phone numbers > Profile. ولا ينطبق الخطأ 131037 إلا على أرقام النشاط التجاري 555 التي توفرها ميتا دون اسم عرض معتمد.
توثيق النشاط التجاري وحدود الأرقام
يمكن لمحفظة أعمال جديدة تسجيل رقمي هاتف تجاريين. وترفع ميتا هذا السقف إلى 20 بعد توثيق النشاط التجاري أو بلوغ حد مراسلة قدره 2,000. وإلى أن يكتمل التوثيق، تحدّ ميتا أيضًا من عدد حسابات واتساب بزنس التي يمكنك إنشاؤها (الرمز 2388098). راجع توثيق النشاط التجاري لدى ميتا لواتساب للاطلاع على المستندات والخطوات.
أخطاء الدفع والفوترة
الخطأ 131042، “There was an error related to your payment method”، يعني أن ميتا لا تستطيع محاسبة حساب المراسلة الذي يرسل رسائلك. وتشمل قائمة الأسباب لدى ميتا: عدم ربط حساب دفع، أو تجاوز خط الائتمان حدّه، أو حذف حساب واتساب بزنس أو تعليقه، أو عدم ضبط المنطقة الزمنية أو العملة.
منذ 1 أكتوبر 2026، يؤدي غياب طريقة الدفع أيضًا إلى توقف رسائل الخدمة بعد استنفاد الـ 1,000 رسالة المجانية لكل رقم تجاري شهريًا، وتُحتسب رسوم قوالب Utility المرسلة ضمن نافذة 24 ساعة مفتوحة. ويغطي مقال تغيير الأسعار في أكتوبر 2026 التفاصيل.
يشرح دليل طريقة الدفع كيفية إضافة بطاقة في واتساب Manager وأخطاء البطاقة التي تعرضها ميتا، مثل “Couldn’t save payment method”. وأسعار الرسائل لكل دولة موجودة في صفحة أسعار واتساب API.
أخطاء تسليم الرسائل
تؤثر أخطاء التسليم في عميل واحد أو رسالة واحدة في كل مرة، فتستمر بقية رسائلك في الخروج. تعامل معها كمعلومة عن ذلك العميل، وتجنب إعادة إرسال الرسالة نفسها مرارًا.
131026: رسالة غير قابلة للتسليم
تذكر ميتا ثلاثة أسباب: الرقم ليس رقم واتساب، أو لم يقبل العميل أحدث شروط خدمة واتساب، أو أن تطبيق العميل أقدم من الحد الأدنى الذي تدعمه ميتا. وإذا فشلت رسالة تأكيد طلب، فاتصل بالعميل أو راسله نصيًا بدلًا من ذلك. ويسرد دليل الخطأ 131026 الفحوصات اللازمة.
131047: أُغلقت نافذة 24 ساعة
لا يُسمح بالردود الحرة إلا خلال 24 ساعة من آخر رسالة للعميل. وبعد ذلك، أرسل قالبًا معتمدًا. اقرأ المزيد عن الخطأ 131047 ونافذة خدمة العملاء.
131049 و131050: رسائل تسويقية محجوبة
يعني 131049 أن ميتا قيّدت القوالب التسويقية إلى ذلك العميل “to maintain healthy ecosystem engagement” (للحفاظ على تفاعل صحي في المنظومة)؛ فانتظر 24 ساعة على الأقل قبل إعادة الإرسال. ويعني 131050 أن العميل اختار إيقاف الرسائل التسويقية من نشاطك التجاري، فلا تعد المحاولة. وكلاهما ينطبق على القوالب التسويقية. راجع دليل الخطأ 131049.
130429 و131056: الإرسال بسرعة كبيرة
يعني 130429 أن إنتاجية رسائل الرقم بلغت حدها؛ أعد المحاولة لاحقًا. ويعني 131056 أن رسائل كثيرة جدًا أُرسلت إلى العميل نفسه خلال وقت قصير؛ فانتظر قبل مراسلة ذلك العميل مجددًا، بينما لا يتأثر العملاء الآخرون.
131021: اختبار أُرسل إلى رقم نشاطك التجاري نفسه
لا تسلّم ميتا رسالة من رقم إلى نفسه. وعند استخدام Send Test Message في Whapi، أدخل رقم واتساب شخصيًا يختلف عن رقم النشاط التجاري.
أخطاء القوالب
تعني أخطاء القوالب أن ميتا لم توافق على القالب، أو أن المتغيرات في الرسالة لا تطابقه، أو أن ميتا أوقفته مؤقتًا لأن العملاء حظروه أو أبلغوا عنه. ترسل Whapi القوالب إلى ميتا عند إعداد أتمتة، وميتا هي التي تحدد الفئة والموافقة.
- 132001: القالب غير موجود بتلك اللغة أو غير معتمد. تحقق من حالته في Whapi أو واتساب Manager.
- 132000 و132012: المتغيرات المرسلة لا تطابق عدد متغيرات القالب أو تنسيقها. اجعلها متطابقة، أو أرسل إلى دعم Whapi اسم الأتمتة.
- 132005: الترجمة طويلة جدًا. اختصر تلك النسخة اللغوية.
- 132007: المحتوى ينتهك سياسة واتساب. راجع لماذا ترفض ميتا القوالب.
- 132015 و132016: أُوقف مؤقتًا لانخفاض الجودة، ثم عُطّل نهائيًا بعد تكرار الإيقاف. عدّل القالب الموقوف مؤقتًا؛ واستبدل القالب المعطّل بمحتوى جديد.
- 131064: بلغ الحساب حد مراسلة بسبب مخالفات تصنيف القوالب. تأكد من كتابة تحديثات الطلبات كـ Utility والعروض الترويجية كـ Marketing. ويشرح دليل Utility مقابل Marketing الفرق بينهما.
- 2388019: بلغ الحساب الحد الأقصى وهو 250 قالبًا. احذف القوالب التي لم تعد تستخدمها.
- إعادة تصنيف القالب إلى Marketing: لا يوجد رمز خطأ لهذه الحالة. منذ 9 أبريل 2025، يُعتمد القالب المقدّم كـ Utility كـ Marketing إذا رأت ميتا أنه تسويقي، ويمكن لميتا أيضًا تغيير فئة قالب معتمد لاحقًا. ويُعدّ المحتوى المختلط، مثل تحديث طلب مع رمز خصم، تسويقيًا. ويمكنك طلب مراجعة خلال 60 يومًا من تغيير الفئة.
تقييم الجودة وحدود المراسلة وقيود الحساب
تخفض ميتا الحدود أو تقيّد الرقم عندما يحظر العملاء رسائله أو يبلغون عنها، أو عندما ينتهك النشاط التجاري سياسة واتساب بزنس. تستخدم Whapi واجهة واتساب بزنس API الرسمية من ميتا، مما يتجنب الحظر الذي تتسبب فيه أدوات واتساب Web غير الرسمية، لكن ميتا تستطيع مع ذلك تقييد أي رقم ينتهك سياساتها.
حدود المراسلة
يحدد حد المراسلة عدد العملاء الفريدين الذين يمكنك مراسلتهم خارج نافذة خدمة العملاء خلال فترة 24 ساعة متحركة. ويُضبط لكل محفظة أعمال ويُشترك فيه بين جميع أرقامها. تبدأ المحافظ الجديدة عند 250. وللوصول إلى 2,000، وثّق نشاطك التجاري، أو أرسل 2,000 رسالة مُسلَّمة خارج نوافذ الخدمة إلى عملاء فريدين خلال 30 يومًا باستخدام قوالب عالية الجودة. وبعد ذلك ترفع ميتا الحد تلقائيًا إلى 10,000 ثم 100,000 ثم غير محدود عندما تظل الجودة عالية وتستخدم نصف حدك الحالي على الأقل خلال 7 أيام. تحقق من حدك في واتساب Manager ضمن Account tools > Messaging limits.
131048 و368 و131031: قيود على الإرسال أو الحسابات
يعني 131048 أن الإرسال من الرقم مقيّد لأن رسائل سابقة كثيرة حُظرت أو وُسمت كرسائل مزعجة؛ تحقق من حالة الجودة في واتساب Manager. أما الرمزان 368 و131031 فيعنيان أن الحساب قُيّد أو عُطّل بسبب مخالفة سياسة. اقرأ التنبيه في Business Support Home وقدّم اعتراضًا هناك إن كنت ترى أنه خطأ. ويعني الرمز 130497 أن فئة نشاطك التجاري لا تستطيع مراسلة العملاء في دول معينة.
حافظ على تقييم جودة صحي
- راسل فقط العملاء الذين طلبوا منك أو وافقوا على تلقي الرسائل.
- أرسل تحديثات الطلبات، مثل تأكيدات الطلبات، كقوالب Utility، وأبقِ العروض الترويجية في قوالب Marketing.
- اجعل الرسائل التسويقية ذات صلة وقليلة التكرار، وسهّل إلغاء الاشتراك.
Coexistence والاتصال الصوتي وFlows وأسماء المستخدمين
تأتي هذه الأخطاء من ميزات أحدث في واتساب. ولا تواجهها معظم المتاجر إلا أثناء ربط رقم من تطبيق واتساب Business أو اختبار ميزة لا تزال ميتا تطرحها تدريجيًا.
Coexistence: أخطاء الاقتران وقوائم البث
تربط Coexistence رقم تطبيق واتساب بزنس بالـ API لتواصل المحادثة من هاتفك بينما ترسل Whapi الأتمتات. تعطّل ميتا قوائم البث في التطبيق بعد الربط، وتصبح القوائم الموجودة للقراءة فقط. وتُغطى “Error while pairing Cloud API” وأخطاء الاقتران الأخرى وفقدان سجل المحادثات وانقطاع الاتصال في Coexistence في واتساب لا تعمل.
“Calling APIs cannot be enabled for this phone number”
يعني الخطأ 138015 من ميتا أنه لا يمكن تفعيل الاتصال الصوتي في واتساب بزنس لذلك الرقم بعد. وحل ميتا هو التأكد من أن حد مراسلة الرقم 2,000 أو أكثر. استخدم خطوات حد المراسلة أعلاه للوصول إلى ذلك.
WhatsApp Flows: “Blocked By Integrity”
يعني الخطأ 139000 أن ميتا رصدت مشكلة نزاهة في الحساب تمنع إنشاء Flow أو نشره. تحقق من Business Support Home بحثًا عن قيود على النشاط التجاري، ثم تواصل مع دعم ميتا، وهو السبيل الوحيد الذي تتيحه ميتا لهذا الرمز.
معرّفات المستخدم الخاصة بالنشاط التجاري (BSUID)
تضيف واتساب أسماء مستخدمين اختيارية، لذا صارت ميتا تعرّف العملاء أيضًا بمعرّف مستخدم خاص بالنشاط التجاري (BSUID) فريد لكل محفظة أعمال. ولا يمكن توجيه بعض أنواع الرسائل إلى BSUID، وتعيد ميتا الخطأ 131062، “Business-scoped User ID (BSUID) recipients are not supported for this message.” ويتجنب ذلك الإرسال إلى رقم هاتف العميل. وتحمل طلبات شوبيفاي رقم الهاتف، وهو ما تستخدمه أتمتات الطلبات.
أعطال ميتا وانتهاء صلاحية الوصول
تعني الرموز 2 و131016 و133004 أن خدمة ميتا مثقلة أو غير متاحة لوقت قصير، فالحل هو الانتظار وإعادة المحاولة. وقد يكون الرمز 1 خطأ في الخادم أو طلبًا مشوهًا، ونصيحة ميتا للرموز الأربعة هي التحقق من metastatus.com أولًا. أما 131000 فهو خطأ غير معروف؛ أعد المحاولة مرة واحدة، وأبلغ عنه إن تكرر.
يعني الرمزان 0 و190 أن رمز الوصول الذي يتيح لـ Whapi الإرسال لحسابك انتهت صلاحيته أو أُبطل. وتذكر ميتا أيضًا إعدادًا لدى المستخدم يمنع جميع التطبيقات من الوصول إلى بياناته كأحد الأسباب. وتعني الرموز 10 و200 إلى 299 أن إذنًا أُزيل. وفي كل حالة، أعد ربط واتساب من لوحة تحكم Whapi لتصدر ميتا وصولًا جديدًا.
كيف تحصل على مساعدة بشأن خطأ في واتساب API
أرسل رمز الخطأ أولًا، لأنه يدل الدعم على مكان البحث. يرد دعم Whapi عبر البريد الإلكتروني على info@usewhapi.com وعبر واتساب. أرفق ما يلي:
- رمز الخطأ ورسالة ميتا، أو لقطة شاشة لها؛
- تاريخ حدوثه ووقته مع منطقتك الزمنية؛
- رقم طلب شوبيفاي أو الأتمتة التي فشلت؛
- هل تفشل كل الرسائل أم بعض العملاء فقط.
وفي مشكلات الحساب أو الفوترة أو السياسات التي لا تستطيع حلها سوى ميتا، افتح تذكرة في Meta Direct Support. وفي مشكلات البطاقة تطلب منك ميتا اختيار الموضوع “Dev: Billing, Credit & Pricing” ونوع الطلب “Credit Card Billing”. وإذا لم يظهر لك هذا الموضوع، فتقول ميتا أن تطلب من مزوّدك فتح التذكرة، فراسلنا وسنرفعها نحن. ويمكنك أيضًا التواصل معنا عبر صفحة التواصل.
أسئلة حول أخطاء واتساب API
ما هي رموز أخطاء واتساب بزنس API؟
هي أرقام تعيدها ميتا عندما تعجز واتساب بزنس API عن إرسال رسالة أو تسليمها، مثل 131042 لمشكلة في طريقة الدفع أو 131026 لرسالة غير قابلة للتسليم. ويأتي كل رمز مع عنوان قصير ونص تفاصيل. وتوصي ميتا ببناء الحلول على الرمز والتفاصيل، لأن العناوين ستُلغى في النهاية. وتسرد ميتا كل رمز في مرجع رموز أخطاء واتساب لديها.
لماذا لا تُسلَّم رسائل واتساب الخاصة بي؟
انظر إلى رمز الخطأ على الرسالة الفاشلة. إذا فشلت كل الرسائل، فتحقق من صفحة حالة ميتا وحالة اتصال رقمك وطريقة الدفع (الخطأ 131042). أما إذا كان بعض العملاء فقط لا تصلهم الرسائل، فالرموز المعتادة هي 131026 (الرقم لا يستطيع استقبال رسائل واتساب) و131047 (أُغلقت نافذة 24 ساعة) و131049 (حجبت ميتا رسالة تسويقية) و131050 (أوقف العميل الرسائل التسويقية).
ماذا يعني خطأ واتساب رقم 131049؟
نص ميتا هو “This message was not delivered to maintain healthy ecosystem engagement.” (لم تُسلَّم هذه الرسالة للحفاظ على تفاعل صحي في المنظومة). تحدّ ميتا من عدد رسائل القوالب التسويقية التي يتلقاها العميل الواحد من الأنشطة التجارية، وتحجب بعضها. وتنصح ميتا بالانتظار 24 ساعة على الأقل قبل إعادة الإرسال، لأن إعادة الإرسال قبل ذلك تعيد الخطأ نفسه. وتحديثات الطلبات المرسلة كقوالب Utility فئة مختلفة.
هل تُرسل رسائل واتساب دون طريقة دفع بعد 1 أكتوبر 2026؟
جزئيًا فقط. منذ 1 أكتوبر 2026، تحاسب ميتا على رسائل الخدمة بعد 1,000 رسالة مجانية لكل رقم هاتف تجاري شهريًا. وإذا لم يكن في حساب المراسلة طريقة دفع، فإن ميتا تسلّم رسائل الخدمة ضمن هذه الشريحة المجانية وتتوقف عن تسليمها بعد استنفادها. كما تحتاج رسائل القوالب، مثل تأكيدات الطلبات، إلى طريقة دفع صالحة.
ماذا يعني “Calling APIs cannot be enabled for this phone number”؟
هذا هو الخطأ 138015 من ميتا. لا يمكن تفعيل الاتصال الصوتي في واتساب بزنس إلا لرقم يبلغ حد مراسلته 2,000 أو أكثر. ارفع الحد بإكمال توثيق النشاط التجاري لدى ميتا، أو بإرسال 2,000 رسالة مُسلَّمة خارج نوافذ خدمة العملاء إلى عملاء فريدين خلال 30 يومًا باستخدام قوالب عالية الجودة.
ماذا يعني “Blocked By Integrity” في واتساب Flows؟
هذا هو الخطأ 139000 من ميتا. وجدت ميتا مشكلة نزاهة في الحساب، تمنعك من إنشاء واتساب Flows أو نشرها. تحقق من Business Support Home بحثًا عن قيود على نشاطك التجاري أو حساب واتساب، ثم تواصل مع دعم ميتا لحلها.
ماذا يعني خطأ واتساب رقم 131037؟
يعني الخطأ 131037 أن رقم هاتف النشاط التجاري 555 المستخدم لإرسال الرسالة ليس له اسم عرض معتمد. وهو ينطبق فقط على أرقام +1 555 الأمريكية التي توفرها ميتا أثناء التسجيل، والتي يجب أن يكون لها اسم عرض معتمد قبل أن تتمكن من الإرسال، لذا غيّر اسم العرض لذلك الرقم في واتساب Manager. أما إذا رُفض اسم العرض لرقمك أنت أثناء التسجيل، فتعرض ميتا بدلًا من ذلك “Your verified name violates WhatsApp guidelines”، والحل هو تعديل الاسم ليتوافق مع إرشادات أسماء العرض لدى ميتا.
كيف أتواصل مع دعم ميتا بشأن خطأ في واتساب بزنس API؟
افتح تذكرة على business.facebook.com/direct-support عبر زر Ask a Question. وفي مشكلات البطاقة والفوترة، تطلب منك ميتا اختيار الموضوع “Dev: Billing, Credit & Pricing” ونوع الطلب “Credit Card Billing”. وإذا لم يظهر لك هذا الموضوع، فاطلب من مزوّدك فتح التذكرة نيابةً عنك. ويمكن لعملاء Whapi مراسلة info@usewhapi.com مع ذكر رمز الخطأ والوقت.
المصادر
- ميتا: رموز أخطاء واتساب (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: أخطاء مسار Embedded Signup (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: الدعم للعملاء المسجّلين (الفوترة وأخطاء الدفع) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: أسعار منصة واتساب بزنس (تغييرات سارية من 1 أكتوبر 2026) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: تصنيف القوالب (تغييرات الفئات والمراجعات) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: أسماء العرض (حدود التغيير) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: نظرة عامة على Embedded Signup (أرقام النشاط التجاري 555) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: حدود المراسلة (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: أرقام هواتف الأنشطة التجارية (سقف التسجيل والأهلية) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: إعداد مستخدمي تطبيق واتساب بزنس (Coexistence) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: استكشاف أخطاء الاتصال الصوتي في واتساب (الخطأ 138015) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: رموز أخطاء واتساب Flows (الخطأ 139000) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: معرّفات المستخدم الخاصة بالنشاط التجاري (الخطأ 131062) (تاريخ الاطلاع: 20 أكتوبر 2026)
- ميتا: حالة واتساب بزنس API (تاريخ الاطلاع: 20 أكتوبر 2026)
مقالات المساعدة
- المساعدةأضف طريقة دفع واتساب في ميتا (الخطأ 131042)تفشل رسائلك بالخطأ 131042؟ أضف أو أصلح طريقة الدفع في حساب واتساب بزنس على ميتا خطوة بخطوة، مع نصائح عن البطاقة، وتعود الرسائل للإرسال.اقرأ
- المساعدةرقم الهاتف غير مؤهل لمنصة واتساب بزنسظهرت رسالة أن رقمك غير مؤهل للربط مع منصة واتساب بزنس؟ اعرف معناها وكيف تجعل الرقم مؤهلًا لاستخدام واجهة API، وفق شروط ميتا.اقرأ
- المساعدةواتساب Coexistence لا يعمل؟ الأسباب والحلولحلّ مشكلات إعداد واتساب Coexistence: أخطاء رمز QR، والأرقام غير المؤهلة، وإصدار التطبيق، واختفاء سجل المحادثات، وتأخر المزامنة.اقرأ
- المساعدةانقل رقم واتساب API الخاص بك إلى Whapiتنتقل من Wati أو Zoko أو AiSensy أو مزوّد آخر؟ انقل رقم واتساب بزنس API إلى Whapi دون أن تفقد الرقم، خطوة بخطوة، وبأقل توقف ممكن في الإرسال.اقرأ
- المنتجدليل إعداد Whapi: اربط واتساب بمتجر شوبيفايإعداد خطوة بخطوة: ثبّت Whapi، واربط رقم واتساب بزنس عبر ميتا، وأضف طريقة الدفع، ثم فعّل أولى الأتمتات في متجرك دون تعقيد.اقرأ
- الأسعارأسعار واتساب API لعام 2026: سعر الرسالة حسب الدولةأسعار ميتا لكل رسالة في واتساب بزنس API حسب الدولة لقوالب Marketing وUtility وAuthentication، وما الذي تغيّر في عام 2026.اقرأ
أتمتة واتساب لشوبيفاي على واجهة ميتا الرسمية.
يربط Whapi متجر شوبيفاي الخاص بك بواتساب بزنس API لتأكيدات الطلبات واستعادة صفحات الدفع المتروكة وتحديثات الشحن. ويتم الإعداد عبر تسجيل ميتا نفسه، وتبدأ كل خطة بفترة تجريبية مجانية مدتها 7 أيام.