حول سجل النشاط الموحد لـ Wawp (Activity Hub)

يعمل سجل النشاط الموحد Wawp Activity Hub كدفتر تدقيق وسجل متابعة مركزي فائق الدقة لموقعك الإلكتروني. وعلى عكس السجلات التقليدية التي تقتصر على تتبع الرسائل الصادرة لكل قناة إرسال بشكل منفصل، يوفر سجل النشاط الموحد جدولاً زمنياً شاملاً ومتمحوراً حول المستخدم يضم كافة إجراءات المتسوقين، وجلسات تسجيل الدخول، والتسجيلات الجديدة، والمراسلات الموجهة عبر جميع المسارات والبوابات المتاحة (واتساب ويب، وواجهة برمجيات Meta Cloud API، ورسائل Firebase SMS النصية، وخوادم بريد SMTP).

1. الملخص الإحصائي العام

يتميز الجزء العلوي من سجل النشاط (Activity Hub) بأربع بطاقات لمؤشرات الأداء العامة، والتي تقدم نظرة شاملة حول عملياتك المؤتمتة:

• المستخدمون المتتبعون (Tracked Users): إجمالي عدد العملاء الفريدين في قاعدة بياناتك الذين تم تسجيل نشاط لهم أو تلقوا مراسلة بالفعل.
• العمليات الناجحة (Successful Hub): إجمالي عدد الإشعارات التي تم إدراجها في قائمة الانتظار أو تسليمها بنجاح عبر كافة بوابات الإرسال النشطة.
• الأحداث الفاشلة (Failed Events): إجمالي محاولات المراسلة التي فشلت أو واجهت أخطاء من مزودي الخدمة (مثل تنسيقات الهاتف غير الصالحة أو تجاوز حدود رصيد واجهة البرمجة API).
• الإجراءات العامة (Global Actions): العدد الإجمالي للأنشطة التي قام بها المستخدمون وتمت معالجتها، بما في ذلك جلسات تسجيل الدخول، والتنقل بين الصفحات، وإضافات السلة، والتسجيلات الجديدة.

2. دليل التفاعل والنشاط (Engagement Directory)

يسرد دليل التفاعل والنشاط (Engagement Directory) جميع العملاء الذين يتفاعلون مع موقعك. ويتم تنظيمه في جدول بيانات أنيق وقابل للبحث يحتوي على التفاصيل التالية:

شريط البحث والفلترة المباشر

في الجزء العلوي من الدليل، يتيح لك شريط البحث الفوري تصفية القائمة بالكامل في الوقت الفعلي بناءً على اسم العميل، أو عنوان البريد الإلكتروني، أو رقم الهاتف، أو معرّف مستخدم ووردبريس (User ID).

3. المخططات الزمنية للتفاعل في الوقت الفعلي (الشاشات الجانبية المنبثقة)

يؤدي النقر فوق أي عميل في الدليل إلى فتح شاشة جانبية منبثقة للمخطط الزمني للنشاط (Activity Timeline) على الجانب الأيمن من لوحة التحكم الخاصة بك.

هوية العميل وملخص الحالة

في الجزء العلوي من الشاشة الجانبية، تعرض Wawp نظرة عامة دقيقة للملف الشخصي للمستخدم المحدد تشتمل على ثلاث بطاقات تشخيصية رئيسية:

• عنوان البريد الإلكتروني (Email Address): يعرض بريد العميل الإلكتروني بجانب شارة حالة التحقق (تم التحقق - Verified باللون الأخضر أو لم يتم التحقق - Not Verified باللون الرمادي) اعتماداً على ما إذا كان البريد قد اجتاز بنجاح تسجيل العضوية أو فحوصات البريد OTP.
• رقم الهاتف (Phone Number): يعرض رقم الاتصال المرتبط بالعميل مع علم الدولة الديناميكي بناءً على مفتاح الاتصال (على سبيل المثال: أرقام الهواتف التي تبدأ بـ +972 تعرض علم فلسطين تلقائياً). وتوضح شارة مضمنة حالة التحقق (تم التحقق - Verified باللون الأخضر أو لم يتم التحقق - Not Verified باللون الرمادي).
• آخر تسجيل دخول (Last Login): يعرض الختم الزمني الدقيق لأحدث جلسة تسجيل دخول للمستخدم إلى جانب شارة مؤشر الحالة التي توضح مسجل الدخول حالياً - Logged In (مع علامة صح) أو لم يسجل الدخول أبداً - Never Logged In (مع أيقونة 'X').

سجل الأحداث الزمني والمتسلسل

يسرد المخطط الزمني كل إجراء اتخذه المستخدم أو قام النظام بتحفيزه بترتيب زمني متسلسل ودقيق:

• تسجيل الدخول - Login: يتم تسجيله عندما يسجل العميل دخوله إلى حسابه (Customer Logged In) مع توضيح عنوان IP المصدر وطريقة المصادقة المستخدمة (مثل رمز OTP، أو كلمة المرور).
• التسجيل - Signup: يُسجل عند تسجيل عضو جديد ومستخدم جديد (New Customer Registered) مع تفصيل عنوان IP المستخدم للتسجيل.
• تم التحقق من OTP - OTP Verified: يُسجل عندما يتم التحقق من رقم الهاتف بنجاح باستخدام نظام تحقق الهوية Wawp OTP.
• البريد الإلكتروني - Email: يتم تتبعه عند إرسال بريد إلكتروني للمعاملات أو النظام (Sent Email).
• السلة المتروكة - Abandoned Cart: يتم تسجيله عندما يتم إضافة منتجات إلى سلة التسوق ولكن يُترك قسم إتمام الطلب دون استكمال (Added Items to Cart).
• تقديم الطلب - Placed Order: يتم تحفيزه عندما يتم استكمال وإرسال طلب شراء بووكومرس بنجاح.
• الرسائل - Message: سجل تسليم تفصيلي لأي إشعارات واتساب أو رموز رسائل نصية OTP يتم إرسالها إلى المستخدم.

4. إجراءات التحكم والعمليات الإدارية

يوفر سجل النشاط (Activity Hub) للمسؤولين أدوات تشخيصية قوية وخيارات اتصال ومراسلة مباشرة:

أدوات التحكم عند تمرير الماوس فوق أحداث المخطط الزمني

يؤدي تمرير الماوس فوق أي بطاقة حدث معينة في سجل أحداث العميل إلى إظهار ثلاثة أزرار إدارية مساعدة:

1. عرض التفاصيل - View Details (أيقونة العين): يفتح نافذة تتبع الحدث التفصيلي (Detailed Event Trace). تعرض هذه النافذة تفصيلاً تقنياً للحدث، يوضح ختم المعاملة الزمني الدقيق، وإشارة بوابة التوجيه، وحالة النجاح، وحزمة بيانات البيانات الوصفية (Metadata) بصيغة JSON الخام (وهي مفيدة جداً لتحليل رموز الأخطاء، تفاصيل المستلم، سياق التحفيز، أسماء القوالب، أو عناوين IP).
2. إعادة الإرسال - Resend (أيقونة التحديث): يقوم بإعادة إدراج ذلك الإشعار المحدد في قائمة الانتظار وإرساله على الفور. يتيح لك ذلك إعادة إرسال رسالة فاشلة أو إيصال يدوياً دون إجبار المتسوق على إجراء عملية دفع جديدة.
3. الحذف - Delete (أيقونة سلة المهملات): يزيل ويسقط سجل الحدث المحدد نهائياً من تاريخ المخطط الزمني.

إرسال رسائل يدوية مخصصة (نافذة إرسال الرسائل)

يؤدي النقر فوق خيار إرسال رسالة (Send Message) إلى إطلاق شاشة منبثقة للمراسلة على الجانب الأيمن من الشاشة. يمكن فتح هذه الشاشة من ثلاثة مداخل مختلفة:

• رأس شاشة سجل النشاط (Activity Hub Header): زر إرسال رسالة (Send Message) الموجود في أعلى يمين لوحة التحكم.
• رأس ورقة المخطط الزمني: زر إرسال رسالة (Send Message) داخل ورقة المخطط الزمني للعميل.
• قائمة مستخدمي ووردبريس (users.php): يؤدي النقر فوق زر إرسال رسالة (Send Message) أسفل عمود "الإرسال السريع (Quick Send)" إلى إعادة توجيهك إلى سجل النشاط الموحد وفتح الشاشة الجانبية للرسائل تلقائياً مع تعبئة بيانات المستلم.

ميزات وقدرات نافذة الرسائل الجانبية:

• اختيار المستلم (Recipient Selection): تتيح لك قائمة منسدلة قابلة للبحث البحث في قائمة المستخدمين المسجلين بالاسم، البريد الإلكتروني، أو معرّف المستخدم لتعيين وتحديد المستلم الفعلي.
• خيارات بوابات الإرسال (Gateway Options):
  • نسخة Wawp (واتساب ويب - WhatsApp Web): لتوجيه وإرسال رسائل واتساب باستخدام حسابات واتساب ويب المتصلة بموقعك. وإذا تم إعداد حسابات متعددة متصلة، يمكنك اختيار أي حساب تود الإرسال منه عبر أداة تحديد الحسابات المتاحة.
  • واجهة برمجيات Meta Cloud API: لإرسال رسائل القوالب الرسمية أو النصوص الحرة باستخدام واجهة برمجة تطبيقات الأعمال الرسمية من ميتا (Meta WhatsApp Business API).
  • خادم SMTP للموقع (Email SMTP): يوجه رسائل البريد الإلكتروني المخصصة باستخدام خادم SMTP المهيأ في موقعك. ويعرض فحصاً حياً لحالة الاتصال بالخادم (يوضح ما إذا كان خادم SMTP نشطاً وجاهزاً للإرسال) ويوفر رابطاً سريعاً لتهيئة إعدادات SMTP إذا كانت معطلة.
• تخصيص الرسائل الذكي: يفتح زر الأقواس المتعرجة ({}) نافذة صندوق التخصيص والدمج (Personalization Dialog)؛ مما يتيح لك إدراج وسوم ذكية ديناميكية (مثل {user_name} و {user_email} و {billing_phone}) لتخصيص نص الإشعار بشكل آلي.
• محرر بريد إلكتروني غني: عند تحديد الإرسال عبر خادم SMTP، تعرض النافذة الجانبية حقولاً منفصلة لكتابة عنوان البريد (Email Subject) المخصص ومحتوى وجسم الرسالة (Message Body)، وكلاهما يدعم استخدام وسوم الأقواس الذكية للتخصيص الفوري.

تفريغ سجلات النشاط وإدارة قاعدة البيانات

• مسح سجل مستخدم معين: انقر فوق زر مسح السجل (Clear History) الموجود في رأس شاشة المخطط الزمني للعميل لحذف كافة السجلات، والأحداث، والمراسلات الخاصة بهذا العميل بشكل نهائي.
• مسح كافة السجلات: انقر فوق زر مسح كافة السجلات (Clear All Logs) في رأس شاشة سجل النشاط لإجراء عملية تفريغ كاملة وشاملة للنظام، وإسقاط ومسح كافة سجلات النشاط من قاعدة البيانات لاستعادة المساحة التخزينية لخادمك.

5. شاشات التدقيق والتشخيص المخصصة لكل قناة

لتوفير أقصى درجات التركيز والتشخيص الموجه، تدرج Wawp لوحات تحكم مخصصة ومستقلة لكل قناة من قنوات الاتصال والمراسلة:

سجلات واجهة برمجة تطبيقات Meta Cloud API الرسمية

لتتبع وتوثيق الرسائل الصادرة التي تم توجيهها عبر واجهة برمجة تطبيقات ميتا الرسمية. تعرض هذه الشاشة أسماء القوالب المستخدمة، حالات استجابة الويب هوك (Webhook)، ومؤشرات التسليم الإجمالية.

سجلات البريد الإلكتروني SMTP

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

6. التكامل مع دليل أعضاء ومستخدمي ووردبريس (users.php)

تقوم Wawp بتوسيع وتضمين قدراتها وميزاتها مباشرة في لوحة إدارة الأعضاء والمستخدمين الرسمية لووردبريس (wp-admin/users.php)؛ مما يوفر إجراءات إدارية مدمجة وإحصاءات لحالة التحقق:

أعمدة البيانات المخصصة

تقوم Wawp بتعديل التخطيط الافتراضي لجدول الأعضاء عن طريق استبدال وإدراج أعمدة بيانات وصفية مخصصة ومدمجة:

• عمود البريد الإلكتروني (Email Column): يستبدل عمود البريد الإلكتروني الأساسي في ووردبريس؛ حيث يدرج شارة مضمنة لحالة التحقق توضح إما علامة صح خضراء (بريد موثق - Email Verified) أو علامة حمراء (بريد غير موثق - Email Not Verified) بناءً على حالة التحقق من بريد المستخدم.
• عمود رقم الهاتف (Phone Number Column): يعرض رقم هاتف العميل المسجل إلى جانب شارة تحقق واتساب مضمنة (علامة صح خضراء أو علامة حمراء)، مع تمييز ترويسة العمود بشعار Wawp الرسمي.
• عمود الإرسال السريع (Quick Send Column): يضيف زر "إرسال رسالة (Send Message)" بجانب كل مستخدم وعضو. ويؤدي النقر فوق هذا الزر إلى إعادة توجيهك فوراً إلى سجل النشاط الموحد (admin.php?page=wawp&wawp_section=activity_hub&wawp_action=send_message&user_id=<user_id>) لفتح نافذة المراسلة اليدوية تلقائياً مع اختيار هذا المستخدم المعني كمستقبل للرسالة.

فلتر البحث الفوري برقم الهاتف

يضيف صندوق بحث تفاعلي باسم البحث بالرقم... (Search Number) مباشرة في شريط فلاتر الأعضاء في ووردبريس. يتيح ذلك للمسؤولين تصفية وفحص جدول الأعضاء بواسطة أرقام هواتفهم، حيث يقوم النظام باستعلامات فورية وسريعة في قاعدة البيانات تطابق الرقم المدخل مع سجلات هواتف Wawp والبيانات الوصفية لهاتف الفواتير في ووكومرس billing_phone user metadata.

إجراءات التوثيق الجماعية (Bulk Actions)

يتيح للمسؤولين تحديد واختيار مستخدمين متعددين واستخدام قائمة الإجراءات الجماعية (Bulk Actions) المنسدلة لتطبيق تحديثات الحالة دفعة واحدة:

• تعيين كموثق واتساب (Mark as WhatsApp Verified) / تعيين كغير موثق واتساب (Mark as WhatsApp Unverified)
• تعيين كموثق بريد (Mark as Email Verified) / تعيين كغير موثق بريد (Mark as Email Unverified)

عند التنفيذ، تقوم Wawp بتحديث سجلات قاعدة البيانات بشكل جماعي وفوري وتظهر إشعار تأكيد إداري جذاب (على سبيل المثال: تم تحديث توثيق واتساب الجماعي لـ X من الأعضاء).

عمليات التكامل داخل صفحات الملفات الشخصية للأعضاء

• شاشة الملف الشخصي في الإدارة (wp-admin Profile Screen): تضيف بطاقة معلومات مخصصة باسم بيانات عضو Wawp (Wawp User Information) في شاشة تحرير الحساب الشخصي للأعضاء (user-edit.php أو profile.php). يمكن للمسؤولين تحديث رقم الهاتف المخصص للإشعارات واستعراض شارات تحقق واتساب والبريد الإلكتروني في الوقت الفعلي. وتتم مزامنة أي تحديثات تلقائياً مع ملف فواتير ووكومرس.
• شاشة تعديل الحساب في ووكومرس: تضيف حقل مدخلات مخصص ومستقل لـ رقم الهاتف (Phone number) في صفحة تعديل وتفاصيل الحساب في الواجهة الأمامية للمتسوقين؛ مما يسمح للعملاء بتحديث أرقام هواتفهم بأنفسهم مع مزامنتها الفورية مع إشعارات Wawp.