قوالب Meta

الطريقة الوحيدة لبدء محادثة جديدة خارج الـ 24 ساعة.

قاعدة الـ 24 ساعة
Meta تسمح بالرد على العميل بأي نص خلال 24 ساعة من آخر رسالة منه. بعد ذلك، لإرسال أوّل رسالة، يجب استخدام قالب معتمد.

أنواع القوالب

  • Marketing — عروض، ترويج، أخبار. الأصعب موافقةً.
  • Utility — تأكيدات، تذكيرات، تحديثات. أسهل موافقة.
  • Authentication — OTP فقط. أسرع موافقة.

إنشاء قالب

من business.facebook.com → WhatsApp Manager → Message Templates → Create Template. املأ: الاسم، الفئة، اللغة، النص (يدعم متغيّرات {{1}}، {{2}}). الموافقة من ساعات إلى يومين.

الإرسال من Operix

curl -X POST \
  https://operix.operixdigital.com/api/whatsapp/send/template \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "966500000000",
    "templateName": "welcome_v1",
    "lang": "ar",
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "أحمد" }]
    }]
  }'
نصيحة
النظام يخزّن محتوى القالب المُرسَل في WhatsAppMessage.content فتشاهد رسائل القوالب في واجهة الـ chat كأي رسالة عادية.

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

  • Template name does not exist — تأكّد القالب معتمد (موافقة Meta) ولغته مطابقة.
  • Number of parameters mismatch — عدد {{n}} في القالب لازم يطابق عدد parameters.
  • Component type missing — لازم تذكر header / body / footer صراحة.