وحدة الواتساب – إعدادات كاملة (عملية إعداد بثلاث مراحل)
 

وحدة الواتساب في Biz1 هي نظام تواصل قابل للتخصيص بالكامل اللي تسمح للمؤسسة تربط واتساب، تدير أرصدة (كريديت)، ترسل مستندات، وتتواصل مع العملاء والمجموعات مباشرةً من المنصة.
 

إعدادات الواتساب مطبقة كـعملية إعداد بثلاث خطوات. هالخطوات تحدد كيف يشتغل الواتساب من الناحية التقنية والتشغيلية داخل النظام. بدون ما تكمّل هالـ إعدادات، صفحة الواتساب ما تقدر تتصل، ترسل رسائل أو تستخدم قوالب.
 

هالمستند يقدم وصف مفصل وكامل لعملية إعدادات الواتساب، بما في ذلك وين تطلع، وش تسوي كل خطوة، كل تفاصيل الإعدادات، وكيف تستخدمها صفحة الواتساب.
 

---

1. إعدادات الواتساب – الهدف العام
 

عملية إعدادات الواتساب اللي فيها 3 خطوات مسؤولة عن إعداد:
 

1. أرصدة (كريديت) واشتراكات (كم رسالة واتساب ممكن ترسلها)

2. قوالب الرسائل (أي محتوى ينرسل مع المستندات)

3. اتصال المزوّد (كيف Biz1 يتصل بالواتساب)
    

هالإعدادات تشغّل صفحة الواتساب (dashboard/whatsappweb) بشكل مباشر، واللي يستخدمها المستخدمين عشان يدردشون فعلياً مع العملاء والمجموعات.
 

باختصار:
 

الإعدادات تحدد الإمكانيات → صفحة الواتساب تستخدم هالإمكانيات

 

---

2. وين تطلع إعدادات الواتساب
 

إعدادات الواتساب متوفرة من خلال إعدادات المشرف (الأدمن).
 

• الموقع:
  
  dashboard/admin/settings
   

• المشغل (التفعيل):
  
  الضغط على “واتساب” في الشريط الجانبي للإعدادات يفتح نافذة إعدادات الواتساب.
   

• معرف النافذة:
  
  #modal_whatsapp
   

• شرط الظهور:
  
  إعدادات الواتساب تطلع بس لما تكون وحدة الواتساب مفعّلة للمؤسسة
  ($whatsapp_lists_module == '1').
   

• الوصول:
  
  متوفر عادةً لأصحاب المؤسسات أو للمستخدمين اللي عندهم صلاحيات المشرف/الإعدادات.
   

لما ينفتح، النافذة تحمل تلقائياً كل بيانات الواتساب ذات الصلة عن طريق استدعاء
whatsapp_data_display().
 

---

3. عملية إعدادات الواتساب – هيكل عالي المستوى
 

الإعدادات مترتبة على ثلاثة خطوات متتالية، معروضة بمؤشر تقدم:
 

1. اختر خطة واتساب (الخطوة 1 من 3)

2. قوالب الواتساب (الخطوة 2 من 3)

3. مزود الواتساب (الخطوة 3 من 3)
    

كل خطوة تبني على اللي قبلها.
 

---

الخطوة 1 – اختر خطة واتساب (وصف مفصل وكامل)
 

هدف الخطوة 1
 

الخطوة 1 تحدد كم رسالة واتساب تقدر المؤسسة ترسل.
 

رسائل الواتساب في Biz1 مبنية على الأرصدة (الكريديت). كل رسالة واتساب صادرة تستهلك أرصدة من باقة نشطة. هالـ أرصدة تنشرى عن طريق خطط اشتراك واتساب.
 

هالخطوة تخدم هدفين:
 

• عرض خطط الواتساب المتوفرة

• عرض الباقات اللي تم شراؤها من قبل ("باقاتي")
   

---

نظرة عامة على واجهة المستخدم للخطوة 1
 

• العنوان: اختر خطة واتساب

• مؤشر التقدم: 1/3

• أيقونة المساعدة

• زر الإغلاق

• قسم بطاقات الخطط

• جدول باقاتي

• زر إضافة اشتراك

• زر التالي
   

---

بطاقات الخطط المتوفرة
 

بطاقات الخطط تعرض وش خطط الواتساب المتوفرة للشراء.
 

• الخطط يتم تحميلها من جدول email_sms_plans

• بس الصفوف اللي فيها type = 'whatsapp' هي اللي تنعرض
   

كل بطاقة خطة تعرض:
 

• النوع / البيانات: عدد رسائل الواتساب (مثلاً 500، 1000)

• الصلاحية: مدة الخطة (مثلاً شهر واحد)

• السعر: تكلفة الخطة
   

هالبطاقات معلوماتية لين يتم إضافة اشتراك.
 

---

أضف اشتراك
 

الضغط على “أضف اشتراك” يفتح نافذة فرعية (sub-window) يقدر فيها المستخدم:
 

• يختار وحدة من خطط الواتساب

• يكمل الدفع أو التأكيد

• يرسل عملية الشراء
   

مع النجاح:
 

• يتم إدخال سجل جديد في جدول email_sms_plans_paid

• جدول باقاتي يتحدث تلقائياً
   

---

باقاتي (مهم جداً)
 

جدول باقاتي يعرض كل أرصدة الواتساب اللي تملكها المؤسسة حالياً.
 

كل صف يمثل باقة واتساب تم شراؤها.
 

الحقول الرئيسية:
 

• النوع: واتساب

• السعر: السعر المدفوع

• البيانات: إجمالي أرصدة الرسائل اللي تم شراؤها

• الرسائل المتبقية: الرسائل المتبقية (البيانات − المستخدمة)

• الصلاحية: مدة الصلاحية

• التاريخ: تاريخ الإنشاء أو الانتهاء
   

كيف تستخدم الأرصدة
 

في كل مرة:
 

• يرسل مستخدم رسالة واتساب

• أتمتة ترسل رسالة واتساب

• مستند ينرسل عن طريق الواتساب
   

النظام ينقص "الرسائل المتبقية" من الباقة النشطة.

إذا كانت الرسائل المتبقية = 0، ممكن تنحظر أو تتقيد عملية إرسال الواتساب.
 

---

التنقل من الخطوة 1
 

• التالي → ينتقل إلى قوالب الواتساب (الخطوة 2)

• إغلاق → يطلع من نافذة الإعدادات
   

---

الخطوة 2 – قوالب الواتساب (وصف مفصل وكامل)
 

هدف الخطوة 2
 

الخطوة 2 تحدد وش المحتوى اللي ينرسل لما تتم مشاركة المستندات عن طريق الواتساب.
 

قوالب الواتساب هي قوالب رسائل جاهزة تستخدم عند إرسال:
 

• عروض أسعار

• أوامر شراء

• فواتير

• إيصالات

• سندات تسليم

• وأنواع مستندات ثانية
   

بدون قوالب، رسائل الواتساب اللي تعتمد على المستندات ما تقدر تتنسق صح.
 

---

نظرة عامة على واجهة المستخدم للخطوة 2
 

• العنوان: قوالب الواتساب

• مؤشر التقدم: 2/3

• أيقونة المساعدة

• زر الإغلاق

• زر إضافة قالب

• جدول القوالب

• التنقل للخلف / للأمام
   

---

إضافة أو تعديل قوالب
 

المستخدمين يقدرون:
 

• يضيفون قالب واتساب جديد

• يعدّلون قالب موجود

• يمسحون قوالب
   

كل قالب يحدد:
 

• معرف القالب

• اسم القالب

• نص الرسالة

• أي أنواع مستندات تنطبق عليها
   

القوالب تنحفظ في جدول whatsapp_templates وتترتب حسب position.
 

---

كيف تستخدم القوالب
 

لما يتم إرسال مستند عن طريق الواتساب من أي مكان في Biz1:
 

1. النظام يتعرف على نوع المستند

2. يدور على القالب المطابق في whatsapp_templates

3. محتوى الرسالة يتطبق

4. رسالة الواتساب تنرسل باستخدام هالـ قالب
    

هذا ينطبق على:
 

• الإرسالات اليدوية

• الإرسالات التلقائية

• رسائل المستندات اللي أنشأها النظام
   

---

التنقل من الخطوة 2
 

• الخلف → يرجع لـالخطوة 1 – اختر خطة واتساب

• التالي → ينتقل إلى الخطوة 3 – مزود واتساب
   

---

الخطوة 3 – مزود واتساب (وصف مفصل وكامل)
 

هدف الخطوة 3
 

الخطوة 3 تحدد كيف Biz1 يتصل بالواتساب نفسه.
 

هذه هي طبقة الاتصال التقنية. بدون مزوّد محدد، صفحة الواتساب ما تقدر:
 

• تحمّل دردشات

• ترسل رسائل

• تستقبل رسائل
   

---

المزودين المدعومين
 

Biz1 تدعم كذا مزود واتساب، منها:
 

• Green API

• Message Bird

• Whapi

• Higents (للمؤسسات المختارة)
   

المزوّد المختار يحدد كيف الرسائل تنرسل وتستقبل.
 

---

Green API (الحالة الأكثر شيوعاً)
 

لما يتم اختيار Green API:
 

• ممكن إعداد نسخة أو أكثر (instances)

• كل نسخة تمثل رقم واتساب
   

إعداد النسخة يتضمن:
 

• idInstance

• apiTokenInstance

• رقم الجوال

• علم النسخة الافتراضية

• حالة الترخيص
   

كذا نسخة تسمح بـ:
 

• أرقام واتساب متعددة

• موازنة التحميل

• الاستخدام القائم على الفريق
   

---

حفظ إعدادات المزوّد
 

لما يتم حفظ المزوّد والنسخ:
 

• الإعدادات تنحفظ على مستوى المستخدم/المؤسسة

• صفحة الواتساب تستخدم هالـ إعدادات على طول
   

---

التنقل من الخطوة 3
 

• الخلف → يرجع لـالخطوة 2 – قوالب الواتساب

• ما فيه زر التالي (هذي آخر خطوة)

• إغلاق النافذة يكمل الإعداد
   

---

الربط مع صفحة الواتساب (جداً مهم)
 

صفحة الواتساب (dashboard/whatsappweb) تعتمد بشكل كامل على هالإعدادات.
 

الخطوة 1 → أرصدة (كريديت)
 

يتحكم في هل ممكن ترسل رسائل وكم.
 

الخطوة 2 → المحتوى
 

يتحكم في وش قوالب الرسائل اللي تستخدم لما يتم إرسال المستندات.
 

الخطوة 3 → الاتصال
 

يتحكم في كيف Biz1 يتصل بالواتساب وأي رقم يستخدم.
 

إذا أي خطوة ناقصة أو ما اكتملت:
 

• ممكن صفحة الواتساب ما تحمل الدردشات

• الرسائل ممكن تفشل

• المستندات ممكن ما تنرسل
   

---

سير العمل من البداية للنهاية
 

1. المشرف يفتح إعدادات → واتساب

2. الخطوة 1: يراجع الخطط، يشتري باقات، يشيك على الأرصدة المتبقية

3. الخطوة 2: يضبط قوالب إرسال المستندات

4. الخطوة 3: يختار مزوّد ويحفظ اتصال الواتساب

5. المستخدمين يفتحون صفحة الواتساب

6. الدردشات تحمل عن طريق المزوّد

7. الرسائل تستهلك أرصدة

8. المستندات تستخدم قوالب
    

---

الخلاصة النهائية
 

الـإعدادات الكاملة للواتساب (سير العمل المكون من 3 خطوات) هي الـأساس لوحدة الواتساب في Biz1.
 

• الخطوة 1 تتحكم في الـأرصدة

• الخطوة 2 تتحكم في هيكل الرسالة

• الخطوة 3 تتحكم في الاتصال التقني
   

مع بعض، هالخطوات تضمن إن صفحة الواتساب تشتغل بشكل موثوق، آمن وعلى نطاق واسع.