تخطّ إلى المحتوى

دليل

استكشاف الأخطاء وإصلاحها

دليل 4 دقائق قراءة

تجمع هذه الصفحة المشاكل الشائعة عبر روبوت المحادثة الذكي SRV في مكان واحد، مع رابط إلى الدليل التفصيلي لكل مجال. وهي موجّهة للمسؤولين الذين يشخّصون مشكلة بسرعة.

الترخيص والوصول

المشكلة الحل
تعرض لوحة التحكم شاشة حجب ترخيص/شاشة مقيَّدة تحقق من مفتاح الترخيص وحالته في شاشة الترخيص؛ جدّد إذا انتهى استحقاق الدعم/التحديثات
لا يظهر الويدجت في واجهة العملاء على الإطلاق تأكد من أن الترخيص فعّال، وأن Enable chatbot مفعَّل (راجع الإعدادات العامة)، وأن مجموعة العميل غير محددة ضمن Access control (راجع الأمان وحدود المعدل)

مزوّدو الذكاء الاصطناعي والإجابات

المشكلة الحل
فشل Test Connection لمزوّد ما أعد التحقق من مفتاح API وBase URL والوصول عبر HTTPS الصادر — راجع إدارة مزوّدي الذكاء الاصطناعي
المساعد يعطي إجابات عامة أو فارغة أو خارج النطاق أضف/وسّع مصادر المعرفة ذات الصلة؛ راجع Scope strength في إعدادات السلوك
المساعد يرفض أسئلة يفترض أنها قابلة للإجابة خفّض Scope strength، وتأكد من أن الموضوع مفهرَس فعلياً في قاعدة المعرفة
محتوى الموقع الجديد لا ينعكس في الإجابات أعد فهرسة مصدر المعرفة المعني، أو انتظر فاصل إعادة الفهرسة المجدول

التوجيه والمساعدون

المشكلة الحل
يظهر المساعد الخطأ في صفحة معيّنة راجع WHMCS page templates وRoute priority — انظر إضافة مساعد
لا يظهر أي مساعد في أي مكان تأكد من تفعيل مساعد واحد على الأقل بقواعد توجيه مطابقة

إجراءات العميل والتذاكر

المشكلة الحل
يرفض المساعد تنفيذ إجراء حساب مطلوب تأكد من تفعيل الإجراء في الإعدادات العامة ← Account Actions (/ar/p/srv-aichatbot/docs/general-settings-general-settings-and-actions)، وأن أي قيد product group ID في Action policies يشمل مجموعة منتج خدمة العميل
لا يستلم العميل رمز تأكيد لمرة واحدة أبداً تحقق من بريد العميل الإلكتروني وتسليم البريد الصادر من WHMCS
أزرار مساعد التذاكر مفقودة في تذكرة تأكد من تفعيل Enable ticket assistant on support ticket view ومفتاح الميزة المحددة — راجع مساعد التذاكر
Automatic Ticket Responder لا يُشغَّل أبداً تأكد من تطابق القسم والحالة وعمر التذكرة مع القواعد المهيَّأة — راجع مساعد التذاكر

المبيعات والعروض الترويجية والتضمين

المشكلة الحل
المساعد لا يعرض كود عرض ترويجي أبداً تأكد من تفعيل Enable chat promos، وفي وضع Pool، من توفر إدخالات — راجع العروض الترويجية والتصعيد
سلايدر التوصيات لا يظهر تأكد من إدراج الصفحة في Surface pages (CSV) وأن Mount selector (CSS) يطابق عنصراً حقيقياً — راجع مساعد المبيعات
الويدجت المُضمَّن لا يظهر في موقع خارجي تأكد من تفعيل Enable external-site embed بشكل عام وتفعيل Embed Enabled للمساعد، وأن المصدر الدقيق للموقع مُدرَج في المصادر المسموحة — راجع التضمين الخارجي

الأداء والتكلفة

المشكلة الحل
تكاليف مزوّد الذكاء الاصطناعي أعلى من المتوقع اضبط أو خفّض Max tokens per day في لوحة المعلومات؛ راجع Max reply tokens في إعدادات السلوك
نسبة إصابة التخزين المؤقت تبقى منخفضة ارفع Response cache TTL (hours) في إعدادات السلوك

الحصول على مساعدة إضافية

إذا استمرت المشكلة بعد تجربة الحل المناسب أعلاه، اجمع ما يلي قبل التواصل مع الدعم: