إشعارات WhatsApp و SMS

إرسال إشعارات WhatsApp أو SMS لأحداث الطلبات وعربات التسوق المهجورة وغيرها.

---

نظرة عامة

التدفق:

1. يكوّن المسؤول gateway URLs في Settings.
2. ينشئ المسؤول notification templates في Products → Notifications (أو ما شابه).
3. عند تفعيل triggers (مثل order placed، invoice paid، abandoned cart)، ترسل الوحدة طلباً إلى gateway.
4. يقدّم gateway الرسالة عبر WhatsApp أو SMS.

---

التكوين

Gateway URLs

1. انتقل إلى Setup → Settings → Products.
2. ضمن WhatsApp / SMS Notifications:
   • تفعيل الميزة.
   • أدخل SMS Gateway URL - نقطة نهاية webhook/API لمزود SMS.
   • أدخل WhatsApp Gateway URL - نقطة نهاية webhook/API لمزود WhatsApp.
3. احفظ.

تجاوز لكل قالب

يمكن لكل قالب إشعار استخدام global gateway أو custom webhook URL.

---

إنشاء قالب إشعار

1. انتقل إلى Products → Notifications (أو Product Notifications).
2. انقر New Notification.
3. قم بالتكوين:

الحقل	الوصف
Name	اسم داخلي
Channel	WhatsApp أو SMS
Trigger	abandoned_cart، order_placed، order_paid
Recipient	client أو staff
Message template	نص مع merge fields
Webhook URL	تجاوز العام (اختياري)
Webhook method	POST أو GET
Webhook body	قالب JSON للـ API

4. احفظ.

---

Merge Fields

استخدم هذه العناصر النائبة في قالب الرسالة:

الحقل	الوصف
{companyname}	اسم شركتك
{cart_link}	رابط الدفع
{cart_total}	إجمالي السلة (عربة مهجورة)
{client_name}	اسم العميل
{contact_phonenumber}	رقم الهاتف
{order_id}	Order ID
{order_date}	تاريخ الطلب
{total}	إجمالي الطلب
{invoice_number}	رقم الفاتورة
{invoice_link}	رابط الفاتورة

---

أحداث الـ Trigger

• abandoned_cart - عند إرسال cron لتذكيرات عربة التسوق المهجورة.
• order_placed - عند إنشاء طلب/فاتورة.
• order_paid - عند تحديد الفاتورة كمُدفوعة.

---

Webhook Body

عادةً يكون تنسيق الـ body الافتراضي:

{"to":"{contact_phonenumber}","body":"{message}"}

يُستبدل العنصر النائب {message} بالرسالة المُصاغة (مُرمّزة JSON). عدّل قالب الـ body ليتوافق مع متطلبات API لـ gateway الخاص بك.