الإعدادات
الإعدادات العامة وإجراءات الحساب
تغطي هذه الصفحة تبويب Settings → General — المفتاح الرئيسي للإضافة بأكملها، بالإضافة إلى تحديد الإجراءات السريعة وإجراءات الحساب المضبوطة بصلاحيات التي يُسمح للمساعد بتنفيذها للعملاء. وهي موجّهة للمسؤولين الذين يقررون ما يستطيع المساعد فعله وما لا يستطيعه على حساب العميل.
انتقل إلى Addons → AI Copilot Suite → Settings → General. تضم قائمة Categories الجانبية أربعة أقسام: General، Widget Quick Actions، Account Actions (AI tools)، وAction policies.
General
| الاسم الودّي | النوع | الافتراضي |
|---|---|---|
| Enable chatbot | مفتاح تبديل | معطَّل |
| Enable external-site embed | مفتاح تبديل | معطَّل |
| Default widget assistant | قائمة اختيار — "Auto (highest route priority)" أو مساعد محدد | Auto |
| Log level | قائمة اختيار (مثل Error) | Error |
| Enable module logging | مفتاح تبديل | مفعَّل |
| Purge database on deactivate | مفتاح تبديل | معطَّل |
Warning
Enable chatbot هو المفتاح الرئيسي. "The widget will appear on the client area once Phase 3 (widget) is deployed and this is enabled." تعطيله يخفي الويدجت فوراً عن كل العملاء، بغض النظر عن إعدادات المساعد أو التوجيه.
Enable external-site embed: "Allow the chat widget on external websites via embed.js + per-assistant site keys and CORS allowlists." هذا هو المفتاح العام — لكل مساعد أيضاً مفتاح تضمين خاص به وقائمة مصادر مسموحة ضمن إعداداته الخاصة؛ يجب تفعيل كليهما ليعمل تضمين ذلك المساعد. راجع التضمين الخارجي.
Default widget assistant: "Primary widget assistant when no assistant has an explicit page/group/department route. Auto = highest route priority among site-wide assistants."
Enable module logging: "When off, no PHP error_log or activity-log entries are written."
Caution
Purge database on deactivate — معطَّل افتراضياً. عند تفعيله، يؤدي تعطيل الإضافة (من Setup → Addon Modules) إلى حذف جداول قاعدة بيانات الإضافة نهائياً، بما في ذلك كل المحادثات ومصادر المعرفة والإعدادات. اتركه معطَّلاً ما لم تكن تنوي مسحاً كاملاً للبيانات.
Widget Quick Actions
"Choose which account buttons logged-in clients see in the chat widget."
| الاسم الودّي | النوع | الافتراضي |
|---|---|---|
| My Services | مفتاح تبديل | مفعَّل |
| Invoices | مفتاح تبديل | مفعَّل |
| Domains | مفتاح تبديل | مفعَّل |
| Orders | مفتاح تبديل | مفعَّل |
| My Profile | مفتاح تبديل | مفعَّل |
| Tickets | مفتاح تبديل | مفعَّل |
يُظهر أو يخفي كل مفتاح تبديل زر الإجراء السريع المقابل بلمسة واحدة في الويدجت للعملاء المسجَّلين دخولهم.
Account Actions (AI tools)
"Enable only the actions you trust the assistant to prepare. Every action requires explicit client confirmation in the widget; sensitive actions also require email OTP."
| مفتاح التبديل | الافتراضي |
|---|---|
| Update profile (email, phone, address) | مفعَّل |
| Change account password | مفعَّل |
| Pay invoice (payment link) | مفعَّل |
| Pay all unpaid invoices (mass pay link) | معطَّل |
| Extend invoice due date | معطَّل |
| Remove invoice late fee | معطَّل |
| Cancel / dispute invoice | معطَّل |
| Reply to support ticket | مفعَّل |
| Open support ticket | مفعَّل |
| Cancel hosting service (ticket) | معطَّل |
| Reset service password | معطَّل |
| Email service credentials | معطَّل |
| Start server (VPS module) | معطَّل |
| Restart server | معطَّل |
| Reboot server | معطَّل |
| Cancel domain (ticket) | معطَّل |
| Request EPP/auth code | معطَّل |
| Update domain nameservers | معطَّل |
| Get domain WHOIS info | معطَّل |
| Cancel order (ticket) | معطَّل |
Note
كل إجراء، بمجرد تفعيله، لا يزال يتطلب من العميل تأكيده صراحةً في ويدجت المحادثة قبل تنفيذه. تتطلب الإجراءات الحساسة (مثل تغيير كلمة المرور، أو إعادة تعيين كلمة مرور خدمة، أو إرسال بيانات الاعتماد بالبريد) إضافةً إلى ذلك تأكيد العميل لرمز لمرة واحدة (OTP) يُرسَل إلى بريده الإلكتروني المسجَّل.
Action policies
يضبط بدقة الإجراءات الأعلى خطورة المفعَّلة أعلاه.
| الاسم الودّي | النوع | الافتراضي |
|---|---|---|
| Allow automatic due-date extension | مفتاح تبديل | معطَّل |
| Days to extend invoice due date | رقم | 7 |
| Allow automatic late-fee removal | مفتاح تبديل | معطَّل |
| Allow direct invoice cancellation (else opens ticket) | مفتاح تبديل | معطَّل |
| Allow EPP code requests | مفتاح تبديل | مفعَّل |
| Allow nameserver updates | مفتاح تبديل | معطَّل |
| Allow WHOIS lookups | مفتاح تبديل | مفعَّل |
| Server power — product group IDs (empty = all) | نص، معرّفات مجموعات منتجات WHMCS مفصولة بفواصل، مثل 3,5 |
فارغ = الكل |
| Service password reset — product group IDs | نص، معرّفات مجموعات منتجات WHMCS مفصولة بفواصل | فارغ = الكل |
| Send credentials — product group IDs | نص، معرّفات مجموعات منتجات WHMCS مفصولة بفواصل | فارغ = الكل |
Warning
تُقيِّد حقول product group IDs الثلاثة التحكمَ بتشغيل الخادم، وإعادة تعيين كلمة مرور الخدمة، وإرسال بيانات الاعتماد بمجموعات منتجات WHMCS محددة — وليس مجموعات العملاء. اترك الحقل فارغاً للسماح بالإجراء (بعد تفعيله أعلاه) لخدمات أي مجموعة منتجات.
Note
"Allow direct invoice cancellation (else opens ticket)" — عند تعطيل هذا الخيار، يُحوَّل طلب العميل بإلغاء فاتورة إلى تذكرة دعم بدلاً من تنفيذه مباشرة، حتى لو كان الإجراء الأساسي "Cancel / dispute invoice" مفعَّلاً.
الإجراء
اضغط Save في كل قسم (يُعرض إصدار المخطط بجانب الزر للمرجعية).
استكشاف الأخطاء
| المشكلة | الحل |
|---|---|
| لا يظهر الويدجت في أي مكان | تأكد من تفعيل Enable chatbot |
| زر إجراء سريع مفقود من الويدجت | فعّله في Widget Quick Actions |
| يرفض المساعد تنفيذ إجراء يطلبه العميل | تأكد من تفعيل المفتاح المقابل في Account Actions (AI tools)، وأن أي قيد product group ID في Action policies يشمل مجموعة منتج خدمة العميل |
| لا يستلم العميل رمز تأكيد لإجراء حساس أبداً | تحقق من صحة البريد الإلكتروني للعميل ومن عمل تسليم البريد الصادر من WHMCS |