خطأ 132012 في واتساب API (صيغة المتغيرات خاطئة): السبب والحل

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

الإجابة المختصرة: الخطأ 132012 تصفه Meta بعبارة «Variable parameter values formatted incorrectly»، أي أن قيم المتغيرات في طلبك لا تستخدم الصيغة المحددة في القالب المعتمد. العدد قد يكون صحيحاً لكن النوع خطأ، وأشهر مثال قالب هيدره صورة يُرسل بلا صورة أو بنص بدلها، فترد Meta بأنها كانت تنتظر IMAGE. الحل: افتح القالب بلغته، ولاحظ نوع الهيدر وصيغة المتغيرات، وابنِ كل مكوّن بالنوع نفسه.

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

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

في صفحة أكواد الأخطاء الرسمية من Meta يقع الكود 132012 في جدول «أخطاء أخرى» بالتفاصيل «Variable parameter values formatted incorrectly.»، أي: قيم المتغيرات بصيغة غير صحيحة. والشرح الذي تكتبه Meta: قيم المتغيرات المرسلة في الطلب لا تستخدم الصيغة المحددة في القالب.

والفرق عن الخطأ 132000 واضح: هناك عدد القيم خطأ، وهنا قد يكون العدد صحيحاً لكن نوع القيمة أو شكلها لا يطابق ما اعتمدته Meta في القالب.

مثال حقيقي منشور (منتدى أسئلة Microsoft، 20 يناير 2025): مطوّر أرسل قالباً عربياً باسم bulk_promo بلغة ar وفي هيدره صورة، لكن طلبه لم يحمل الهيدر أصلاً، فرجع:

(#132012) Parameter format does not match format in the created template. header: Format mismatch, expected IMAGE, received UNKNOWN

  • اقرأ التفاصيل: في المثال حدد الرد المكوّن (header) والنوع الذي ينتظره القالب (IMAGE). وتقول Meta إن حقل error_data.details يصف الخطأ وأرجح سبب له.
  • قد يصلك بطريقتين: في رد الـ API فوراً، أو عبر Webhook الرسائل، فراقب الاثنين.
  • لا تدفع ثمنه: Meta تحاسب على الرسائل المُسلَّمة فقط.
  • إعادة المحاولة بالطلب نفسه لا تفيد: القالب ينتظر الصيغة نفسها في كل مرة.

ما المقصود بـ«الصيغة المحددة في القالب»؟

صفحة الأخطاء لا تعدد الحالات، لكن توثيق القوالب من Meta يحدد لكل مكوّن شكل قيمته عند الإرسال. هذا جدول الفحص، مكوّناً مكوّناً:

المكوّن في القالب المعتمد ما ترسله عند الإرسال الخطأ الشائع
هيدر نصي فيه متغيرمكوّن header بقيمة نوعها textوضع قيمة الهيدر داخل body
هيدر صورةمكوّن header بقيمة نوعها image ومعها link أو idلا مكوّن header أصلاً، أو قيمة text فيها رابط الصورة
هيدر فيديو أو مستندالنوع video أو document بالطريقة نفسهاإرسال image لقالب هيدره فيديو أو PDF
هيدر موقعالنوع location ومعه خط العرض وخط الطول والاسم والعنوانإرسال العنوان نصاً عادياً
نص بمتغيرات مرقّمة {{1}}قيم text بترتيب ظهور المتغيرات، بلا parameter_nameترتيب مختلف، أو أسماء لمتغيرات مرقّمة
نص بمتغيرات مسمّاة {{customer_name}}قيم text ومع كل منها parameter_name مطابق حرفياًنسيان parameter_name أو كتابته Customer_Name
زر رابط ينتهي بمتغيرمكوّن button بنوع url وترتيب الزر index وقيمة نصية للجزء المتغيررموز خاصة بلا ترميز، وتقول Meta إن الرابط قد يفشل التحقق ويفشل الإرسال

حسب توثيق Meta لأساسيات القوالب ومكوناتها والوسائط فيها (اطّلعنا عليه في 5 نوفمبر 2026). ربط كل خطأ شائع بالكود 132012 تقديرنا، فاقرأ حقل التفاصيل لتعرف المكوّن الذي اعترضت عليه Meta.

وفي الوسائط تتيح Meta طريقتين: أن ترفع الملف وتستخدم معرّفه (id)، وهي الطريقة التي توصي بها، أو أن تضع رابطاً على خادمك (link) بشرط أن يكون متاحاً للعامة، وإلا يفشل الإرسال.

مثال: لماذا فشلت رسائل عرض متجر عطور في الرياض؟

متجر عطور أنشأ قالب Marketing باسم friday_offer بلغة ar: هيدره صورة العرض، ونصه «أهلاً {{1}}، خصم 25% على العطور الشرقية حتى الجمعة. اطلب من الزر بالأسفل.». ونسخ مطوّر المتجر كود قالب قديم بلا صورة، فأرسل اسم العميل فقط في مكوّن body، ففشلت الحملة كلها بالخطأ 132012 كما في المثال الحقيقي أعلاه. هذا هو الطلب الصحيح:

{
  "messaging_product": "whatsapp",
  "to": "966501234567",
  "type": "template",
  "template": {
    "name": "friday_offer",
    "language": { "code": "ar" },
    "components": [
      { "type": "header",
        "parameters": [
          { "type": "image",
            "image": { "link": "https://example.com/friday-offer.jpg" } } ] },
      { "type": "body",
        "parameters": [ { "type": "text", "text": "نورة" } ] }
    ]
  }
}

لاحظ أن الصورة جزء من كل طلب: الصورة التي رفعتها عند إنشاء القالب ترافقه كمثال (example) للمراجعة، أما عند الإرسال فتحدد الصورة في الطلب نفسه. لذلك تستطيع تغيير صورة العرض كل أسبوع بنفس القالب، بشرط أن يبقى النوع صورة.

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

المتغيرات المرقّمة أم المسمّاة: كيف تعرف صيغة قالبك؟

تتيح Meta صيغتين للمتغيرات عند إنشاء القالب، وإذا لم تحدد الصيغة يصبح القالب مرقّماً تلقائياً:

الصيغة شكلها في القالب قواعد Meta عند الإرسال
مرقّمة (positional){{1}} {{2}}أرقام متتالية تبدأ من 1القيم بترتيب ظهور المتغيرات في النص، بلا parameter_name
مسمّاة (named){{customer_name}}حروف إنجليزية صغيرة وشرطة سفلية، وكل اسم مرة واحدةالقيم بأي ترتيب، ومع كل قيمة parameter_name بالاسم نفسه

حسب توثيق Meta لأساسيات القوالب (Parameter formats)، اطّلعنا عليه في 5 نوفمبر 2026.

مواضع الخلط الشائعة:

  • نظام مبرمج على الأرقام وقالب جديد بالأسماء: أنشأ الفريق القالب من WhatsApp Manager بمتغيرات مثل {{patient_name}}، ونظام الحجز ما زال يرسل قيماً مرتبة بلا أسماء.
  • اسم لا يطابق حرفياً: الاسم في القالب order_number والطلب يرسل Order Number.
  • نسخة لغة أخرى: Meta لا تترجم القوالب، وكل رمز لغة نسخة مستقلة، فراجع متغيرات النسخة التي ترسل رمزها (ar مثلاً) لا النسخة الإنجليزية.

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

  1. اقرأ حقل التفاصيل: أي مكوّن؟ header أم body أم button؟ وما النوع الذي ينتظره القالب؟
  2. افتح القالب في WhatsApp Manager بالاسم ورمز اللغة نفسيهما، ودوّن: نوع الهيدر (نص أو صورة أو فيديو أو مستند أو موقع)، وصيغة المتغيرات، وهل فيه زر رابط ينتهي بمتغير.
  3. ابنِ كل مكوّن بنوعه: image أو video أو document أو location للهيدر حسب نوعه، وtext لمتغيرات النص، وparameter_name للمتغيرات المسمّاة.
  4. للوسائط: ارفع الملف واستخدم معرّفه كما توصي Meta، أو ضع رابطاً عاماً يفتح بلا تسجيل دخول.
  5. بعد أي تعديل على القالب أو نسخة جديدة منه حدّث نظامك قبل أن يرسل بها، ولا تفترض أن الشكل القديم سيعمل.
  6. جرّب ثم وسّع: أرسل لرقم اختبار غير رقم نشاطك حتى لا يظهر الخطأ 131021، ثم لعينة صغيرة قبل الحملة.

للمطورين:

  • اقرأ مكوّنات القالب من GET //message_templates، وابنِ الطلب منها بدل كتابته يدوياً.
  • حوّل نوع الهيدر إلى نوع القيمة: IMAGE → image، وVIDEO → video، وDOCUMENT → document، وLOCATION → location، وTEXT → text.
  • إذا كانت متغيرات القالب بأسماء فأرسل parameter_name لكل قيمة، وإلا فرتّب القيم حسب ظهورها.
  • شفّر الرموز الخاصة في قيمة زر الرابط (Percent-encoding) كما تطلب Meta.
  • صنّف 132012 خطأً دائماً لا تُعاد محاولته، وسجّل الكود وحقل التفاصيل واسم القالب ولغته مع كل فشل.
الكود المعنى حسب Meta الحل
132012قيم المتغيرات بصيغة غير صحيحةابنِ كل قيمة بالصيغة المحددة في القالب
132000عدد قيم المتغيرات لا يطابق متغيرات القالبأرسل قيمة لكل متغير (شرح 132000)
132005النص المترجم أطول من المسموحقصّر القيم أو القالب (شرح 132005)
132001القالب غير موجود باللغة المحددة أو لم يُعتمدصحّح الاسم ورمز اللغة (شرح 132001)
131053تعذّر رفع الوسائط المستخدمة في الرسالةراجع نوع الملف ورابطه (شرح 131053)
100الطلب فيه معامل غير مدعوم أو مكتوب خطأراجع أسماء الحقول في مرجع الـ API
132007محتوى القالب يخالف سياسة واتسابعدّل المحتوى (شرح 132007)

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

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

  • الهيدر يُبنى من نوع القالب: في الحملات وواجهة API يبني مظبوت مكوّن الهيدر حسب نوع هيدر القالب (صورة أو فيديو أو مستند) من الملف أو الرابط الذي تحدده، ويرسل قيم النص كنص، ويضيف اسم المتغير (parameter_name) للمتغيرات المسمّاة.
  • مزامنة القوالب: بعد أي تعديل في WhatsApp Manager اضغط زر المزامنة، فيُحدّث مظبوت مكوّنات القالب وحالته ويبني الإرسال عليها.
  • قيم نظيفة في الحملات: المتغيرات تُملأ من اسم جهة الاتصال أو رقمها أو قيمة تكتبها، مع استبدال الأسطر الجديدة والمسافات المتكررة بمسافة واحدة، ووضع N/A للقيمة الفارغة.
  • لا إعادة محاولة عمياء: يعامل مظبوت 132012 كخطأ دائم فلا يعيد إرسال الرسالة نفسها تلقائياً، وإذا وصل إشعار فشل به أثناء حملة يوقفها ويكتب السبب بجوار حالتها.
  • بدون عمولة على أسعار Meta، وتستطيع إرسال الكود وحقل التفاصيل لفريقنا عبر صفحة تواصل معنا.

أسئلة شائعة

ما الفرق بين الخطأ 132000 والخطأ 132012؟

132000 مشكلة عدد: قيم أقل أو أكثر من متغيرات القالب. و132012 مشكلة صيغة: نوع القيمة أو شكلها لا يطابق ما اعتمدته Meta، مثل نص أو لا شيء مكان صورة الهيدر.

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

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

رفعت صورة عند إنشاء القالب، فلماذا يطلبها الإرسال؟

الصورة التي رفعتها عند الإنشاء مثال يرافق القالب للمراجعة. وعند الإرسال تأخذ Meta الصورة من الطلب نفسه برابط أو معرّف، والطلب الذي لا يحملها رجع في المثال الحقيقي بالخطأ 132012 وتفاصيل «expected IMAGE».

هل أستطيع إرسال صورة مختلفة لكل عميل بنفس القالب؟

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

قالبي هيدره صورة، فهل أرسل فيه فيديو؟

لا. نوع الوسائط يجب أن يطابق القالب المعتمد. لإرسال فيديو أنشئ قالباً هيدره فيديو وانتظر اعتماده.

المصادر

قوالبك تُرسل بالشكل الذي اعتمدته Meta

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

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