وحدة واتساب – وصف كامل (Biz1)
 

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

الوحدة هذي تشمل:
 

• مكالمات واتساب مباشرة

• إدارة العملاء والمجموعات

• تصفية على أساس الحالة

• أتمتة على أساس الكلمات المفتاحية

• إجراءات مدعومة بالذكاء الاصطناعي عن طريق Biz1 Agent
   

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

---

1. وحدة واتساب – لإيش يستخدمونها
 

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

• يسولفون مع عملاء ومجموعات الواتساب

• يرسلون ويستقبلون رسايل عن طريق مزودين الواتساب (مثلاً، Green API)

• يصفون الدردشات حسب البحث، عضو الفريق، وحالة الواتساب

• يخصصون ويغيرون حالات الواتساب لكل عميل

• يضبطون ردود تلقائية لمجموعات الواتساب

• يشغلون إجراءات Biz1 Agent تلقائياً باستخدام توجيهات المستخدم

• يديرون إعدادات الواتساب من نافذة منبثقة رئيسية
   

الوحدة تشتغل بـ الوقت الحقيقي وتستجيب لـ Webhooks الواتساب الواردة.
 

---

2. وين تظهر وحدة الواتساب
 

• عنوان الموقع (URL):
  
  dashboard/whatsappweb
   

• موقع الشريط الجانبي:
  
  تظهر تحت قائمة التنقل الرئيسية باسم واتساب
   

• التحكم بالوصول:
  
  الظهور يعتمد على:
   

  • إعدادات مزود الواتساب

  • صلاحيات المستخدم

  • إعدادات وحدة المؤسسة
     

---

3. تصميم صفحة الواتساب (الشاشة الرئيسية)
 

صفحة الواتساب مقسمة إلى ثلاث مناطق وظيفية.
 

اللوحة اليسرى – قائمة المحادثات
 

المنطقة هذي تعرض:
 

• محادثات العملاء

• محادثات المجموعات في واتساب

• معاينة آخر رسالة

• ختم الوقت

• صورة شخصية / أحرف أولى
   

المحادثات تتحمل:
 

• لما تحمل الصفحة

• بالتمرير (حمل المزيد)

• عن طريق الفلاتر (بحث، حالة، عضو فريق)
   

---

اللوحة اليمنى – محادثة نشطة
 

هذي منطقة المحادثة اللي يقدر فيها المستخدمون:
 

• يقرون الرسايل الواردة

• يرسلون نصوص، ملفات، رسايل صوتية

• يغيرون حالة الواتساب للعميل

• يشغلون إجراءات يدوية
   

الرسايل تتحمل بشكل ديناميكي لكل محادثة.
 

---

الشريط العلوي – أدوات التحكم
 

الشريط العلوي يشمل:
 

• خانة بحث (تصفية المحادثات)

• محدد أرقام الواتساب (Green API)

• فلتر عضو الفريق

• زر التحديث

• الإعدادات (أيقونة الترس) → يفتح نافذة إعدادات حالات الواتساب
   

---

4. ميزة حالات الواتساب (نظرة عامة)
 

إذا كانت المؤسسة مفعلة لـ حالات الواتساب (show_whatsapp_status == 1):
 

• العملاء ممكن يكون لهم حالة واتساب (مثلاً: جديد، قيد المعالجة، مغلق)

• مربعات الحالات تظهر فوق قائمة المحادثات

• الضغط على حالة يفلتر المحادثات حسب هذي الحالة

• ممكن تغيير الحالة من داخل المحادثة
   

أيقونة الترس حقت الإعدادات تفتح نافذة إعدادات حالات الواتساب، وهو التركيز الأساسي لهذي الوثيقة.
 

---

إعدادات حالات الواتساب – وصف كامل ومفصل
 

نافذة إعدادات حالات الواتساب هي عملية إعداد متعددة المراحل تتحكم بكيف يتصرف الواتساب في كل النظام.
 

النافذة المنبثقة هذي تتحكم بـ:
 

• حالات الواتساب

• قواعد الرد التلقائي للمجموعات

• توجيهات المستخدم المدعومة بالذكاء الاصطناعي (دمج مع Biz1 Agent)

---

5. كيف تنفتح نافذة حالة الواتساب
 

• تتفعل بالضغط على أيقونة الترس في صفحة الواتساب

• تظهر فوق صفحة الواتساب
   

الخطوة الأولى اللي تطلع تعتمد على الإعدادات والصلاحيات.
 

---

6. منطق الخطوات المتغيرة (مهم جداً)
 

النافذة المنبثقة مو دايم تطلع نفس الخطوات.
 

إيش اللي يتحكم بالخطوات:
 

1. show_whatsapp_status (مفعل/غير مفعل)

2. دور المستخدم (مالك / مسؤول مقابل مستخدم عادي)
    

---

مسارات ممكنة
 

إذا كانت حالة الواتساب مفعلة:
 

• الملاك/المسؤولون → 3 خطوات

• المستخدمون العاديون → خطوتين
   

إذا كانت حالة الواتساب غير مفعلة:
 

• الملاك/المسؤولون → خطوتين

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

واجهة المستخدم تتعدل تلقائياً على مؤشرات التقدم (1/3, 2/2, 1/1).
 

---

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

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

هذي الخطوة تحدد إيش الحالات اللي موجودة وكيف شكلها.
 

---

هدف الخطوة 1
 

حالة الواتساب تستخدم لـ:
 

• ترتيب العملاء بشكل مرئي

• تصفية المحادثات

• تشغيل منطق الأتمتة

• تخصيص توجيهات المستخدم بعدين
   

كل حالة لها:
 

• اسم بالإنجليزي

• اسم بالعبري

• لون

• ترتيب (أولوية)
   

---

إيش اللي يشوفه المستخدم
 

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

• مؤشر تقدم

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

• زر إغلاق

• نموذج إضافة/تعديل حالة

• قائمة بالحالات الموجودة
   

---

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

المستخدم يعبي:
 

• اسم الحالة (إنجليزي)

• اسم الحالة (عبري / لغة ثانية)

• لون الحالة
   

السلوك:
 

• إذا ما فيه ID → تنشأ حالة جديدة

• إذا الـ ID موجود → تتحدث الحالة الموجودة
   

الإرسال يكون عن طريق AJAX، بدون ما تتحدث الصفحة.
 

---

سلوك قائمة الحالات
 

تحت النموذج:
 

• كل الحالات معروضة

• ممكن تعديل كل حالة

• ممكن حذف كل حالة

• ممكن إعادة ترتيب الحالات بالسحب والإفلات
   

الترتيب مهم، لأنه:
 

• يتحكم بأولوية العرض

• يأثر على التصفية وتجربة المستخدم
   

---

تأثير على الواجهة الخلفية
 

الحالات تنحفظ في:
 

• جدول whatsapp_status

• مرتبة حسب status_order
   

تستخدم عن طريق:
 

• فلاتر المحادثات

• تخصيص حالة العميل

• مطابقة توجيهات المستخدم
   

---

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

• الضغط على التالي → يفتح إعدادات المجموعة

• الضغط على إغلاق → يطلع من النافذة المنبثقة
   

---

الخطوة 2 – إعدادات المجموعة (وصف مفصل)
 

هذي الخطوة تحدد الردود التلقائية لمجموعات الواتساب.
 

---

إيش هي إعدادات المجموعة
 

إعدادات المجموعة تخلي Biz1 يرد تلقائياً لما رسالة في مجموعة واتساب تتطابق مع كلمات مفتاحية معينة.
 

مثال:
 

أحد يكتب "مرحباً" في مجموعة → النظام يرد تلقائياً.

 

---

كيف تشتغل إعدادات المجموعة (سير العمل في الواجهة الخلفية)
 

1. الـ Webhook حق الواتساب يستقبل رسالة
    

2. النظام يتحقق من:
    

   • رقم الاستلام

   • معرف المجموعة
      

3. تتطابق الكلمات المفتاحية
    

4. إذا تطابق:
    

   • نص الرد يجهز

   • ينرسل الرد

   • الرد ممكن يكون خاص أو عام (للمجموعة)
      

---

إيش اللي يقدر المستخدم يضبطه
 

لكل قاعدة، المستخدم يحدد:
 

• كلمة مفتاحية وحدة أو أكثر

• نص الرد

• أي مجموعات واتساب

• أي رقم استلام

• أي رقم إرسال

• هل الرد خاص أو عام
   

---

إدارة قواعد المجموعة
 

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

• يضيفون قواعد جديدة

• يعدلون قواعد موجودة

• يحذفون قواعد
   

التغييرات تصير فعالة فوراً.
 

---

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

• رجوع → الخطوة 1 (إذا موجودة)

• التالي → الخطوة 3 (للملاك/المسؤولين بس)

• إغلاق → يطلع من النافذة المنبثقة
   

---

الخطوة 3 – توجيه المستخدم (وصف مفصل)
 

الخطوة هذي موجودة للملاك والمسؤولين بس.

هذي أقوى خطوة.
 

---

إيش هو توجيه المستخدم بالضبط
 

توجيه المستخدم هو تعليمات محددة مسبقاً تنرسل لـ Biz1 Agent تلقائياً لما يصير حدث في الواتساب.
 

هذي مو مجرد قالب رسالة.
 

ممكن تسوي:
 

• تخلق مهام

• ترسل رسايل

• تضيف مصاريف

• تسوي عمليات بحث

• تشغل أتمتة
   

---

كيف يشتغل توجيه المستخدم (من البداية للنهاية)
 

1. توصل رسالة واتساب واردة
    

2. يتم التعرف على العميل
    

3. النظام يتحقق من:
    

   • مجلد

   • حالة

   • علامات
      

4. يتم اختيار التوجيه المطابق
    

5. الـ placeholders تتبدل ببيانات العميل
    

6. التوجيه ينرسل لـ Biz1 Agent
    

7. Biz1 Agent ينفذ الإجراء
    

---

إيش اللي يحدده المستخدم
 

لكل توجيه:
 

• اسم

• نص التوجيه (لغة طبيعية)

• مفعل / غير مفعل

• علم افتراضي

• فلاتر المجلدات

• فلاتر الحالات

• فلاتر العلامات
   

مسموح بـ توجيه افتراضي واحد بس.
 

---

إدارة التوجيهات
 

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

• يضيفون توجيهات جديدة

• يعدلون توجيهات

• يحذفون توجيهات

• يحددون توجيه افتراضي
   

---

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

• رجوع → يرجع لإعدادات المجموعة

• إغلاق → يطلع من كل النوافذ المنبثقة
   

---

ملخص أخير (بكلمات بسيطة)
 

وحدة الواتساب في Biz1 مو مجرد محادثة.
 

هذي نظام أتمتة ذكي:
 

• الخطوة 1 (الحالات): تحدد الترتيب والظهور

• الخطوة 2 (إعدادات المجموعة): تدير الردود التلقائية اللي تعتمد على الكلمات المفتاحية

• الخطوة 3 (توجيه المستخدم): تشغل إجراءات الذكاء الاصطناعي عن طريق Biz1 Agent
   

كل طبقة مبنية على اللي قبلها.
 

هالتصميم يضمن:
 

• استخدام بسيط للمستخدمين العاديين

• قوة أتمتة عميقة للمسؤولين

• فصل واضح للمسؤوليات

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