قاعدة الـ 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صراحة.