أخطاء القوالب
قائمة الأخطاء المتعلقة بالقوالب في حل WhatsApp Business API
تظهر أخطاء القوالب عند إنشاء قالب WhatsApp أو تعديله أو إرساله. ترد أخطاء الإرسال أولاً أدناه (وهي الأكثر شيوعاً)، ثم أخطاء الإنشاء والتعديل، وأخطاء Flow، وإحصاءات القوالب.
الخطأ 132012 - عدم تطابق تنسيق المتغير
ما الذي يتعطل: إرسال هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: قيم المتغيرات
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132012، بسبب عدم تطابق تنسيق المعلمة.
تشخيص مبسّط: لا تتوافق إحدى القيم مع النوع الذي يتوقعه القالب؛ مثل إدخال نص بدلاً من صورة في الترويسة، أو استخدام تنسيق تاريخ أو عملة غير صحيح، أو ترك قيمة فارغة.
الحل 1 – النهج المقترح
1. افتح القالب وتحقق مما يتوقعه كل متغير والترويسة.
2. اربط كل عنصر بقيمة من النوع الصحيح، من دون ترك حقول فارغة.
3. أرسل رسالة اختبار إلى نفسك قبل الإرسال الجماعي الكامل.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132000 - عدم تطابق عدد المتغيرات
ما الذي يتعطل: إرسال هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: ربط المتغيرات
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132000، بسبب عدم تطابق عدد المعلمات.
تشخيص مبسّط: تم إرسال عدد من القيم أكبر أو أقل من عدد متغيرات القالب (في الترويسة والنص والأزرار مجتمعة).
الحل 1 – النهج المقترح
1. احسب عدد المتغيرات في الترويسة والنص والأزرار.
2. اربط قيمة بكل متغير في الإرسال الجماعي أو خطوة الروبوت، ثم أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132001 - القالب غير موجود أو غير معتمد
ما الذي يتعطل: هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: قوالب Chakra، وWhatsApp Manager
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132001، إذ لا يوجد اسم القالب في الترجمة.
تشخيص مبسّط: لا يتطابق اسم القالب أو لغته مع قالب معتمد؛ فقد يكون قيد المراجعة أو مرفوضاً أو محذوفاً أو معتمداً بلغة أخرى.
الحل 1 – النهج المقترح
1. تحقق من أن القالب معتمد باللغة التي ترسل بها.
2. أعد مزامنة القوالب في Chakra، ثم أعد الإرسال.
3. إذا حُذف القالب، فأنشئ قالباً جديداً باسم جديد (لا يمكن إعادة استخدام الأسماء المحذوفة لمدة 30 يوماً تقريباً).
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132015 - إيقاف القالب مؤقتاً بسبب انخفاض الجودة
ما الذي يتعطل: هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: محتوى القالب والجمهور
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132015، إذ تم إيقاف القالب مؤقتاً.
تشخيص مبسّط: حظر هذا القالب عدد كبير جداً من المستلمين أو أبلغوا عنه، لذا أوقفته Meta مؤقتاً.
الحل 1 – النهج المقترح
1. عدّل القالب ليكون أوضح وأكثر ملاءمة، ثم أعد تقديمه.
2. أرسله فقط إلى جهات الاتصال المتفاعلة التي وافقت على تلقي الرسائل.
3. استخدم قالباً آخر معتمداً في هذه الأثناء.
تجنّب ما يلي: لا تستأنف الإرسال إلى الجمهور نفسه من دون أي تغيير؛ فتكرار الإيقاف المؤقت يؤدي إلى التعطيل نهائياً (132016).
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132016 - تعطيل القالب
ما الذي يتعطل: هذا القالب نهائياً · هل تفيد إعادة المحاولة؟ لا · موضع الإصلاح: إنشاء قالب جديد
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132016، إذ تم تعطيل القالب.
تشخيص مبسّط: أُوقف القالب مؤقتاً بسبب انخفاض الجودة مرات كثيرة، لذا عطلته Meta نهائياً.
الحل 1 – النهج المقترح
1. أنشئ قالباً جديداً بمحتوى مختلف بوضوح واسم جديد.
2. اختبره على جمهور صغير ومتفاعل قبل الإرسال إلى الجمهور كله.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132005 - النص المترجم طويل جداً
ما الذي يتعطل: إرسال هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: قيم المتغيرات أو نص القالب
ما الذي يظهر لك: يفشل إرسال قالب مع الخطأ 132005، لأن النص المترجم طويل جداً.
تشخيص مبسّط: بعد إدخال قيم المتغيرات (أو في النسخة المترجمة)، يتجاوز طول الرسالة الحد الذي تسمح به WhatsApp، وهو 1,024 حرفاً للنص.
الحل 1 – النهج المقترح
1. اختصر قيم المتغيرات الطويلة (مثل أوصاف المنتجات أو العناوين).
2. تحقق من ترجمات القالب في WhatsApp Manager واختصر النص الطويل.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132007 - مخالفة سياسة القوالب
ما الذي يتعطل: هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: محتوى القالب
ما الذي يظهر لك: رُفض القالب أو فشل إرساله مع الخطأ 132007، بسبب مخالفة سياسة الأحرف في التنسيق.
تشخيص مبسّط: يخالف محتوى القالب إحدى سياسات WhatsApp، مثل الترويج لمنتجات محظورة أو استخدام صياغة مضللة.
الحل 1 – النهج المقترح
1. اقرأ سبب الرفض في WhatsApp Manager.
2. عدّل المحتوى ليتوافق مع سياسات WhatsApp التجارية وسياسات المراسلة، ثم أعد تقديمه.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388019 - تم بلوغ الحد الأقصى للقوالب
ما الذي يتعطل: إنشاء قوالب جديدة · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: قائمة القوالب
ما الذي يظهر لك: يفشل إنشاء قالب مع الخطأ 2388019، بسبب تجاوز الحد الأقصى لقوالب الرسائل.
تشخيص مبسّط: بلغ حساب WhatsApp Business الحد الأقصى للقوالب (تذكر صفحة أخطاء Meta أن الحد هو 250). وتُحتسب القوالب المرفوضة والموقوفة مؤقتاً أيضاً.
الحل 1 – النهج المقترح
1. احذف القوالب غير المستخدمة أو المرفوضة أو القديمة (وتأكد من عدم استخدام أي حملة لها).
2. أكمل عملية التحقق من النشاط التجاري؛ فقد تحصل الأنشطة التجارية التي تم التحقق منها على حد أعلى.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388039 - تعذّر تغيير حالة القالب
ما الذي يتعطل: تعديل هذا القالب · هل تفيد إعادة المحاولة؟ نعم، بعد الانتظار · موضع الإصلاح: حالة القالب / الانتظار
ما الذي يظهر لك: يفشل تعديل قالب مع الخطأ 2388039، مع ظهور رسالة تفيد بتعذّر تغيير حالته.
تشخيص مبسّط: لا يزال القالب قيد المراجعة، أو أنك بلغت الحد الأقصى لتعديلات القوالب المعتمدة.
الحل 1 – النهج المقترح
1. إذا كانت حالته «قيد المراجعة»، فانتظر حتى تتم الموافقة عليه أو رفضه.
2. إذا عدّلته اليوم بالفعل، فانتظر 24 ساعة ثم أعد تعديله.
هل الأمر عاجل؟ أنشئ قالباً جديداً باسم جديد.
تجنّب ما يلي: لا تحذفه لإعادة إنشائه بالاسم نفسه؛ إذ لا يمكن إعادة استخدام الأسماء المحذوفة لمدة 30 يوماً تقريباً.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388040 - تجاوز حد الأحرف
ما الذي يتعطل: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: نص القالب
ما الذي يظهر لك: يفشل تقديم قالب مع الخطأ 2388040.
تشخيص مبسّط: أحد أجزاء القالب طويل جداً. الحدود: النص 1,024 حرفاً؛ نص الترويسة 60؛ التذييل 60؛ نص الزر 25.
الحل 1 – النهج المقترح
1. اختصر الجزء المذكور في الخطأ (تُحتسب المسافات والرموز التعبيرية وعلامات الترقيم).
2. أعد تقديم القالب.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388299 - وجود متغير في بداية النص أو نهايته
ما الذي يتعطل: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: نص القالب
ما الذي يظهر لك: يفشل تقديم قالب مع الخطأ 2388299.
تشخيص مبسّط: يقع متغير في أول النص تماماً أو في آخره تماماً.
الحل 1 – النهج المقترح
1. أضف كلمات قبل المتغير وبعده؛ مثلاً: “مرحباً {{1}}، شكراً لطلبك.”
2. أعد تقديم القالب.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388293 - عدد كبير جدًا من المتغيرات مقارنة بطول النص
ما الذي يتعطل: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: نص القالب
ما الذي تراه: يفشل إرسال القالب مع ظهور الخطأ 2388293.
تشخيص مبسط: يحتوي القالب على متغيرات كثيرة جدًا مقارنة بالنص الثابت فيه.
الحل 1 – النهج المقترح
1. أضف مزيدًا من النص الثابت، أو أزل المتغيرات التي لا يلزم تغييرها.
2. أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388047 - تنسيق الترويسة غير صحيح
ما الذي يمنعه: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: ترويسة القالب
ما الذي تراه: يفشل إرسال القالب مع ظهور الخطأ 2388047.
تشخيص مبسط: تخالف الترويسة إحدى قواعد التنسيق: وجود أكثر من متغير، أو وجود متغير في البداية أو النهاية، أو استخدام التنسيق العريض/المائل.
الحل 1 – النهج المقترح
1. استخدم متغيرًا واحدًا على الأكثر في الترويسة، مع كلمات حوله.
2. أزل التنسيق العريض والمائل والرموز التعبيرية من الترويسة، ثم أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388072 - تنسيق النص الأساسي غير صحيح
ما الذي يمنعه: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: النص الأساسي للقالب
ما الذي تراه: يفشل إرسال القالب مع ظهور الخطأ 2388072.
تشخيص مبسط: توجد مشكلة في تنسيق النص الأساسي – غالبًا ما تكون المتغيرات غير مرتبة ({{1}}، {{3}} من دون {{2}}) أو أقواسًا غير متطابقة.
الحل 1 – النهج المقترح
1. رقّم المتغيرات بالترتيب بدءًا من {{1}}، مع وضع كل متغير بين قوسين معقوفين مزدوجين.
2. استخدم تنسيقات WhatsApp فقط (*عريض*، _مائل_، ~يتوسطه خط~)، ثم أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 2388073 - تنسيق التذييل غير صحيح
ما الذي يمنعه: إنشاء هذا القالب · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: تذييل القالب
ما الذي تراه: يفشل إرسال القالب مع ظهور الخطأ 2388073.
تشخيص مبسط: يحتوي التذييل على متغير أو تنسيق؛ يجب أن يكون نصًا عاديًا لا يتجاوز 60 حرفًا.
الحل 1 – النهج المقترح
1. اجعل التذييل نصًا عاديًا من دون متغيرات، ثم أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132068 - تم حظر التدفق
ما الذي يمنعه: القوالب التي تستخدم هذا التدفق · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: التدفق
ما الذي تراه: يفشل قالب يحتوي على زر تدفق مع ظهور الخطأ 132068.
تشخيص مبسط: تم حظر تدفق WhatsApp المرتبط بالقالب، غالبًا بسبب أخطاء أو مشكلة في السياسات.
الحل 1 – النهج المقترح
1. افتح التدفق في WhatsApp Manager وأصلح المشكلة المذكورة.
2. انشره مجددًا، وتحقق من ظهور الحالة «منشور»، ثم أعد الإرسال.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 132069 - تم تقييد معدل التدفق
ما الذي يمنعه: القوالب التي تستخدم هذا التدفق · هل تفيد إعادة المحاولة؟ نعم، بعد الانتظار · موضع الإصلاح: التدفق
ما الذي تراه: يفشل إرسال بعض قوالب التدفق مع ظهور الخطأ 132069.
تشخيص مبسط: قيّدت Meta التدفق إلى 10 رسائل في الساعة، وغالبًا ما يحدث ذلك لأنه جديد أو تظهر فيه أخطاء.
الحل 1 – النهج المقترح
1. انتظر رفع التقييد، ثم أعد الإرسال لاحقًا.
2. إذا استمرت المشكلة، فتحقق من وجود أخطاء في التدفق وأصلحها.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 200005 - إحصاءات القالب غير متاحة
ما الذي يمنعه: إحصاءات القالب فقط · هل تفيد إعادة المحاولة؟ لاحقًا · موضع الإصلاح: لا شيء لإصلاحه
ما الذي تراه: يفشل تفعيل إحصاءات القالب مع ظهور الخطأ 200005.
تشخيص مبسط: لم تفعّل Meta إحصاءات القالب لهذا الحساب بعد. لا يتأثر الإرسال.
الحل 1 – النهج المقترح
1. لا يلزم اتخاذ أي إجراء؛ حاول مجددًا لاحقًا.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 200006 - لا يمكن إيقاف إحصاءات القالب
ما الذي يمنعه: لا شيء – للمعلومات فقط · هل تفيد إعادة المحاولة؟ لا · موضع الإصلاح: لا شيء لإصلاحه
ما الذي تراه: يفشل إيقاف إحصاءات القالب مع ظهور الخطأ 200006.
تشخيص مبسط: بعد تفعيل الإحصاءات، لا تسمح Meta بإيقافها. ولا تؤثر في الإرسال.
الحل 1 – النهج المقترح
1. لا يلزم اتخاذ أي إجراء.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
الخطأ 200007 - إحصاءات القالب غير مفعّلة
ما الذي يمنعه: إحصاءات القالب فقط · هل تفيد إعادة المحاولة؟ بعد الإصلاح · موضع الإصلاح: WhatsApp Manager
ما الذي تراه: يفشل طلب إحصاءات القالب مع ظهور الخطأ 200007.
تشخيص مبسط: لم يتم تفعيل إحصاءات القالب لهذا الحساب.
الحل 1 – النهج المقترح
1. فعّل إحصاءات القالب للحساب (راجع رابط Meta أدناه)، ثم أرسل الطلب مجددًا.
الحل 2 – تم التحقق منه بواسطة Chakra: جارٍ التحقق. إذا لم يحل الحل 1 المشكلة، فأرسل تذكرة إلى دعم Chakra.
ما زلت تواجه مشكلة؟
أرسل تذكرة دعم إلى Chakra تتضمن اسم القالب ورمز الخطأ الدقيق ولقطة شاشة. مراجع Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes · https://developers.facebook.com/documentation/business-messaging/whatsapp/analytics#confirming-template-analytics