خطأ 132005 في واتساب API (نص القالب بعد التعبئة أطول من المسموح): السبب والحل

آخر تحديث: 4 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: صفحة أكواد الأخطاء وتوثيق مكونات القوالب من Meta

الإجابة المختصرة: الخطأ 132005 تصفه Meta بعبارة «Translated text is too long»، أي أن نص القالب باللغة المطلوبة أطول من المسموح، وتنصح بمراجعة نسخة القالب بهذه اللغة في WhatsApp Manager. ويحدث غالباً بعد ملء المتغيرات بقيم طويلة، كعنوان كامل أو قائمة منتجات. الحل: اجعل الهيدر بعد التعبئة في حدود 60 حرفاً والنص في حدود 1,024 حرفاً (حدود Meta عند إنشاء القالب)، وقصّر القيم أو القالب، واختبر بأطول بياناتك.

محتوى المقال:

ما معنى الخطأ 132005 في واتساب API؟

في صفحة أكواد الأخطاء الرسمية من Meta يقع الكود 132005 في جدول «أخطاء أخرى» بالتفاصيل «Translated text is too long.»، أي: النص المترجم أطول من المسموح. والحل الذي تكتبه Meta: راجع WhatsApp Manager لتتأكد أن قالبك مترجم، أي أن نسخته باللغة المطلوبة موجودة.

و«المترجم» هنا لا تعني أن Meta تترجم شيئاً؛ فهي تقول إنها لا تترجم نصوص القوالب ولا متغيراتها، وإن القالب الواحد قد يحمل الاسم نفسه بعدة لغات تكتب أنت نص كل منها. فالمقصود نص نسخة القالب باللغة التي أرسلت رمزها، مثل ar أو en_US. وفي سجلات بعض المنصات يظهر الكود بعنوان Template Hydrated Text Too Long، وHydrated تعني النص بعد ملء المتغيرات بقيمها.

المصدر ماذا يقول؟ ماذا يعني لك؟
صفحة أكواد الأخطاءالنص المترجم أطول من المسموحنص نسخة اللغة بعد التعبئة طويل جداً
توثيق أساسيات القوالبMeta لا تترجم النصوص والمتغيرات، والاسم الواحد قد يحمل لغات عدةراجع النسخة التي تطابق رمز اللغة في طلبك
توثيق مكونات القوالبالهيدر 60 حرفاً، والنص 1,024 حرفاً، والتذييل 60حدود كل نسخة عند إنشائها
سجل تغييرات Meta (6 أكتوبر 2022)قيم المتغيرات النصية في قالب من نص (Body) فقط قد تصل مجتمعة إلى 32,768 حرفاًمساحة إضافية للقوالب التي ليس فيها إلا النص

حسب صفحة أكواد الأخطاء وتوثيق القوالب وسجل التغييرات من Meta (اطّلعنا عليها في 4 نوفمبر 2026).

ولا علاقة للخطأ بجودة رقمك أو حدوده، ولا تدفع ثمن الرسالة لأن Meta تحاسب على المُسلَّم فقط، وإعادة الإرسال بالقيم نفسها تفشل مرة أخرى.

ما حدود الأحرف في كل مكوّن من قالب واتساب؟

المكوّن الحد حسب Meta ملاحظة
الهيدر النصي (Header)60 حرفاًيقبل متغيراً واحداً، فقيمته تدخل في الستين
النص (Body)1,024 حرفاًيقبل عدة متغيرات
التذييل (Footer)60 حرفاً—
نص الزر25 حرفاًلأزرار الرد السريع والرابط والاتصال
رابط زر URL2,000 حرفيقبل متغيراً واحداً
رقم زر الاتصال / زر نسخ الكود20 حرفاً لكل منهما—

حسب توثيق مكونات القوالب من Meta (اطّلعنا عليه في 4 نوفمبر 2026)، وهي الحدود نفسها في شرحنا ما هو Template Message (رسالة القالب)؟

وماذا بعد التعبئة؟ الحدود أعلاه حدود إنشاء القالب. ويذكر سجل تغييرات Meta أن القوالب المكوّنة من نص (Body) فقط يمكن أن تصل قيم متغيراتها النصية مجتمعة إلى 32,768 حرفاً، أما القالب الذي فيه هيدر أو تذييل أو أزرار فلا نجد له في صفحات Meta الحالية حداً منفصلاً بعد التعبئة. لذلك نصيحتنا: اعتبر 60 حرفاً للهيدر و1,024 حرفاً للنص سقفاً بعد التعبئة أيضاً، فهذا أبسط طريق لتجنب الخطأ.

ما الذي يجعل نص القالب أطول من المسموح؟

  • متغير يحمل قائمة كاملة: «منتجات طلبك: {{2}}» ومعه 12 منتجاً بأسمائها وأحجامها.
  • حقل حر بلا حد أقصى: «العنوان بالتفصيل» أو «ملاحظات العميل» من نموذج الطلب، وقد يصل لمئات الأحرف.
  • قالب قريب من الحد أصلاً: نص ثابت من 980 حرفاً لا يترك إلا 44 حرفاً لكل المتغيرات.
  • متغير في الهيدر: «عرض خاص لـ {{1}}» يتجاوز 60 حرفاً مع اسم منتج كامل.
  • نسخة لغة أطول: النسخة الإنجليزية من القالب أطول من العربية، ونظامك يرسل رمز en لبعض العملاء.
جزء نص القالب عدد الأحرف
النص الثابت بدون المتغيرات870
{{1}} اسم العميل22
{{2}} قائمة المنتجات145
النص بعد التعبئة1,037، أي أكثر من 1,024

مثال حسابي توضيحي من فريق مظبوت، مقارنةً بحد النص في توثيق Meta (اطّلعنا عليه في 4 نوفمبر 2026).

مثال من الرياض: متجر عطور يرسل قالب Utility لتأكيد الطلب ومعه قائمة المنتجات في متغير. نجح القالب مع الطلبات الصغيرة، وفشل مع طلبات الجملة بالخطأ 132005 لأن القائمة تجاوزت 300 حرف. الحل: متغير بعدد القطع والإجمالي فقط، وزر «تفاصيل الطلب» يفتح صفحة الطلب.

كيف تحسب طول النص العربي وتختصره؟

  • كل ما تراه يُحسب: الحرف العربي حرف واحد، ومعه المسافات وعلامات الترقيم والأسطر الفارغة.
  • التشكيل يزيد العدد: في معظم أدوات العدّ تُحسب الفتحة والضمة والشدة رموزاً مستقلة، فكلمة «مُحَمَّد» تُعدّ 8 رموز لا 4. احذف التشكيل من القوالب.
  • الإيموجي قد تكون أكثر من رمز: بعض الرموز التعبيرية، مثل الأعلام ودرجات لون البشرة، مركّبة من أكثر من رمز، فلا تعتمد عليها في قالب قريب من الحد.
  • قِس قبل الإرسال: الصق النص بعد التعبئة في Google Sheets أو Excel واستخدم الدالة LEN.

وللاختصار:

  1. ضع التفاصيل خلف زر رابط بدل متغير طويل، مثل «تفاصيل الطلب» أو «تتبع الشحنة».
  2. اكتب جملاً قصيرة مألوفة: «طلبك اتشحن» بدل «نود إعلامكم بأنه قد تم شحن طلبكم».
  3. حدّد حداً أقصى لكل متغير في نظامك، مثل 30 حرفاً للاسم و60 لاسم المنتج، واختصر ما يزيد.
  4. قسّم الرسالة الطويلة: أرسل القالب قصيراً، وبعد رد العميل تنفتح نافذة خدمة العملاء 24 ساعة فترسل التفاصيل رسالة عادية تصل حتى 4,096 حرفاً.

مثال من القاهرة: شركة شحن ترسل قالب «شحنتك في الطريق» وفيه عنوان التسليم كاملاً كما كتبه العميل، بأسماء الشوارع والعلامات المميزة، ففشل جزء من الرسائل بالخطأ 132005. اكتفت الشركة بالمنطقة في المتغير، ووضعت العنوان الكامل في صفحة التتبع خلف زر رابط.

كيف تحل الخطأ 132005 خطوة بخطوة؟

  1. حدد القالب ورمز اللغة في الطلب الفاشل، وافتح هذه النسخة في WhatsApp Manager كما تقترح Meta: تأكد أنها موجودة ومعتمدة، وأن نصها هو ما تتوقعه.
  2. أعد بناء النص بعد التعبئة للعميل نفسه الذي فشلت رسالته، وقِس طول الهيدر والنص.
  3. إن كان الطول من المتغيرات: قصّر القيمة، أو ضع لها حداً أقصى، أو انقلها إلى صفحة خلف زر رابط.
  4. إن كان من القالب نفسه: اختصره. تسمح Meta بتعديل القالب المعتمد حتى 10 مرات خلال 30 يوماً أو مرة كل 24 ساعة، ثم يُراجع من جديد؛ أو أنشئ قالباً أقصر باسم جديد.
  5. اختبر بأطول بيانات حقيقية قبل الحملة: أطول اسم وأطول عنوان وأكبر طلب، على رقم اختبار غير رقم نشاطك حتى لا يظهر الخطأ 131021 (المرسل والمستقبل نفس الرقم).
  6. لا تُعِد المحاولة تلقائياً بالقيم نفسها.

للمطورين:

  • احسب الطول بعد استبدال المتغيرات وقبل الإرسال، وعالج القيمة إذا تجاوز الهيدر 60 حرفاً أو النص 1,024 حرفاً.
  • عُدّ بالأحرف لا بالبايت: الحرف العربي بايتان في ترميز UTF-8 لكنه حرف واحد، فاستخدم دالة مثل mb_strlen في PHP لا strlen.
  • نظّف القيم من الأسطر الجديدة والمسافات المتكررة، فهي أحرف تُحسب.
  • سجّل الكود ورمز اللغة وطول النص بعد التعبئة مع كل رسالة فاشلة.
الكود المعنى حسب Meta الحل
132005النص المترجم أطول من المسموحقصّر النص أو القيم، وراجع نسخة اللغة
132000عدد قيم المتغيرات لا يطابق متغيرات القالبأرسل قيمة لكل متغير (شرح 132000)
132001القالب غير موجود باللغة المحددة أو لم يُعتمدصحّح الاسم ورمز اللغة (شرح 132001)
132012قيم المتغيرات بصيغة غير صحيحةالتزم بالصيغة المحددة في القالب
132007محتوى القالب يخالف سياسة واتسابعدّل المحتوى (أسباب رفض القوالب)

حسب صفحة أكواد الأخطاء من Meta (اطّلعنا عليها في 4 نوفمبر 2026). القائمة الكاملة في دليل أكواد أخطاء واتساب API، وإذا فشلت صورة الهيدر لا النص فاقرأ خطأ 131053: تعذّر رفع الميديا.

كيف يساعدك مظبوت؟

  • حدود الإنشاء داخل مظبوت: عند إنشاء قالب يرفض مظبوت النص الأطول من 1,024 حرفاً، والهيدر أو التذييل الأطول من 60 حرفاً، ونص بطاقة الكاروسيل الأطول من 160 حرفاً وأزرارها الأطول من 25 حرفاً، قبل إرساله لمراجعة Meta.
  • متغيرات الحملة: تُملأ من اسم جهة الاتصال أو رقمها أو قيمة تكتبها، ويستبدل مظبوت الأسطر الجديدة والمسافات المتكررة بمسافة واحدة، ويضع N/A إذا كانت القيمة فارغة.
  • إيقاف الحملة عند الخطأ: إذا وصل إشعار فشل بالخطأ 132005 أثناء حملة يوقفها مظبوت ويكتب السبب بجوار حالتها.
  • مزامنة القوالب من Meta: زر المزامنة يحدّث حالة القالب في مظبوت بعد أي تعديل تجريه.
  • إرسال القوالب من نظامك عبر واجهة API في مظبوت وWebhooks، بدون أي عمولة على أسعار Meta.

أسئلة شائعة

هل أدفع على رسالة فشلت بالخطأ 132005؟

لا. Meta تحاسب على الرسائل المُسلَّمة فقط، والرسالة المرفوضة لم تُسلَّم.

القالب قصير، فلماذا يفشل مع بعض العملاء فقط؟

لأن قيم المتغيرات تختلف من عميل لآخر. العميل صاحب الاسم الطويل أو الطلب الكبير يدفع النص فوق الحد، فاختبر دائماً بأطول قيمة حقيقية عندك.

هل تُحسب المسافات والأسطر الجديدة من حد 1,024 حرفاً؟

نعم، كل ما يظهر في النص يُحسب، ومعه علامات التشكيل في معظم أدوات العد. احذف الأسطر الفارغة الزائدة والتشكيل من القوالب الطويلة.

هل أستطيع إرسال نص أطول من 1,024 حرفاً على واتساب؟

نعم كرسالة عادية تصل حتى 4,096 حرفاً داخل نافذة الـ 24 ساعة. وخارجها تحتاج قالباً، والقالب المكوّن من نص فقط يسمح بقيم متغيرات أطول حسب سجل تغييرات Meta.

هل يعود القالب للمراجعة إذا اختصرته؟

نعم. تسمح Meta بتعديل القالب المعتمد حتى 10 مرات خلال 30 يوماً أو مرة كل 24 ساعة، ويُراجع بعد التعديل، ولا تتغير فئته.

المصادر

قوالب في حدود Meta من أول مرة

مع مظبوت تُفحص حدود الأحرف عند إنشاء القالب، وتُنظَّف قيم المتغيرات قبل الحملة، وتتوقف الحملة تلقائياً عند الأخطاء الحرجة مع سبب واضح، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، مع 250,000 توكن ذكاء اصطناعي مجاناً للحسابات الجديدة.

ابدأ تجربتك المجانية