خطأ WhatsApp 132012: عدم تطابق تنسيق معلمات القالب

ما الذي يجب أن يتطابق

كل شيء، وبصمت. لا يوجد تطابق جزئي.

• العدد: وجود ثلاثة مواضع بديلة في النص يعني إرسال ثلاث معلمات للنص، لا أكثر ولا أقل.
• الترتيب: المعلمات موضعية، لذلك يؤدي تبديل اثنتين إلى إرسال رسالة بقيم في مواضع خاطئة، أو إلى ظهور هذا الخطأ إذا اختلف النوعان.
• النوع: لمعلمة العملة أو التاريخ بنية كائن محددة، ولا يمكن إرسالها كنص عادي.
• المكوّنات: معلمات العنوان والنص والزر قوائم منفصلة، ولا يمكن دمجها في قائمة واحدة.

التعديل الذي يعطّل الإنتاج

يعدّل القوالب أشخاص ليسوا هم من يستدعي واجهة برمجة التطبيقات (API). يضيف أحدهم متغيرًا لتوضيح الرسالة، ثم يُعاد اعتماد القالب، فتبدأ كل عملية إرسال من التكامل الذي لم يتغير بالفشل.

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

الأخطاء الشائعة

• إرسال معلمة إضافية احتياطًا. فالزيادة خاطئة مثل النقص.
• التعامل مع المعلمات الموضعية كأنها مسماة. إذ تتم مطابقتها حسب الموضع فقط.
• تعديل قالب دون فحص الشفرة التي ترسله.

الأسئلة الشائعة

تابع القراءة