انتقل إلى المحتوى

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

المشكلات الشائعة وكيفية إصلاحها. لكل مشكلة، ابدأ بالإصلاح الأول المقترح — فهو السبب الأكثر احتمالًا.

الأداة (Widget) لا تظهر على موقعي الإلكتروني

  1. تحقق من لوحة التحكم — افتح رابط لوحة التحكم مباشرة. إذا لم يتم تحميلها، فقد يكون الخادم متوقفًا — اتصل بمدير حسابك.
  2. تحقق من data-bot-id — يجب أن يتطابق معرف البوت في كود التضمين مع المعرف (slug) الفعلي للبوت الخاص بك. تحقق من ذلك في لوحة التحكم ← تضمين (Embed).
  3. تحقق من data-backend-url — يجب أن يتضمن البروتوكول (https://) والنطاق الصحيح.
  4. تحقق من وحدة تحكم المتصفح (Browser Console) — افتح أدوات المطور (F12) ← Console للبحث عن أخطاء JavaScript.

الأداة تظهر ولكن البوت لا يجيب

  1. تحقق من مؤشر حالة LLM — إذا كان باللون الأحمر، فهذا يعني أن OpenRouter غير متصل. انتقل إلى الإعدادات ← محرك الذكاء الاصطناعي (AI Engine) وأعد الاتصال.
  2. تأكد من اختيار نموذج — يجب اختيار نموذج ذكاء اصطناعي من القائمة المنسدلة.
  3. تحقق من قاعدة المعرفة — إذا كانت فارغة، فقد يجيب البوت بشكل عام أو لا يجيب على الإطلاق. أضف محتوى في قاعدة المعرفة.

سجل المحادثة لا يستمر عند إعادة تحميل الصفحة

  1. يجب تفعيل LocalStorage — تقوم الأداة بتخزين بيانات الجلسة في LocalStorage الخاص بالمتصفح. قد يحظر وضع التصفح المتخفي/الخاص هذا الأمر.
  2. يجب أن يكون معرف البوت ثابتًا — إذا اختلف data-bot-id عبر الصفحات، فستتعامل الأداة معها كبوتات منفصلة بسجلات محادثة منفصلة.

النطاق المخصص لا يعمل

  1. انتظر انتشار الـ DNS — يمكن أن تستغرق التغييرات من 5 إلى 30 دقيقة.
  2. تحقق من سجل A (A record) — تحقق من لوحة تحكم مزود خدمة DNS للتأكد من أن سجل A يشير إلى عنوان IP الخاص بخادمك.
  3. حاول تجديد شهادة SSL — انتقل إلى الإعدادات ← النطاق المخصص ← تجديد SSL.
  4. مستخدمو Cloudflare — تأكد من ضبط وضع SSL على Full (Strict).
  5. اتصل بمدير حسابك إذا استمرت المشكلة بعد انتهاء انتشار الـ DNS.

الإعدادات لا تُحفظ

  1. تحقق من مؤشر حالة قاعدة البيانات (DB) — يجب أن يكون باللون الأخضر في أعلى الصفحة.
  2. تحديث الصفحة — يتم تخزين الإعدادات مؤقتًا؛ التحديث يفرض إعادة القراءة.
  3. اتصل بمدير حسابك إذا كان مؤشر DB باللون الأحمر.

لوحة التحكم تعمل ولكن لا تظهر أي بيانات

  1. تحقق من مؤشرات الحالة — إذا كان مؤشر DB أو VEC باللون الأحمر، فقد تحتاج خدمة خلفية (Backend) إلى انتباه.
  2. تحديث الصفحة — ربما لم يتم تحميل البيانات في الزيارة الأولى.
  3. اتصل بمدير حسابك إذا ظلت المؤشرات باللون الأحمر.

فشل اختبار التكامل (Integration test)

  1. تحقق من بيانات الاعتماد — يجب أن تكون مفاتيح API، وكلمات مرور SMTP، وروابط Webhook حديثة وصحيحة.
  2. تحقق من سجلات النشاط (Activity Logs) — قم بالتصفية حسب وحدة التكامل (Integrations) للحصول على رسائل خطأ مفصلة.
  3. اختبر الخدمة الخارجية — تأكد من أن نقطة نهاية Webhook، أو خادم SMTP، أو API متاح للوصول.

البوت يجيب بشكل عام (يتجاهل قاعدة المعرفة)

  1. تحقق من مهام المزامنة (Sync Jobs) — قد لا تزال الملفات/الروابط قيد المعالجة. انتظر حتى تظهر الحالة Completed.
  2. تحديث قاعدة المعرفة — انتقل إلى قاعدة المعرفة وانقر على تحديث (Refresh).
  3. مراجعة تعليمات النظام (System Prompt) — التعليمات المتعارضة في الإعدادات ← سلوك النموذج يمكن أن تلغي استرداد قاعدة المعرفة.
  4. أضف الأسئلة الشائعة (FAQs) — للأسئلة الهامة، أضف سؤالاً شائعاً بإجابة محددة. الأسئلة الشائعة لها الأولوية.

رسائل WhatsApp لا تصل

  1. تحقق من حالة خدمة WhatsApp — انتقل إلى الإعدادات ← WhatsApp وتأكد من أن الخدمة في حالة Running.
  2. تحقق من فحص حالة API — يجب أن يظهر مؤشر الحالة باللون الأخضر.
  3. تحقق من جلسة رمز QR — إذا كان البوت غير متصل، أعد مسح رمز QR.
  4. اتصل بمدير حسابك إذا تعذر بدء الخدمة.

الأداء بطيء

  1. التبديل إلى نموذج ذكاء اصطناعي أسرع — استخدم Gemini Flash أو Claude Haiku لتقليل زمن الاستجابة. راجع نماذج الذكاء الاصطناعي.
  2. تقليل الحد الأقصى للرموز (Max Tokens) — قلل حد طول الاستجابة في الإعدادات ← سلوك النموذج.
  3. تنسيق قاعدة المعرفة — قم بإزالة المستندات القديمة لتسريع عملية البحث.
  4. أضف الأسئلة الشائعة (FAQs) — الأسئلة الشائعة يتم الإجابة عليها مباشرة وتتخطى نموذج الذكاء الاصطناعي بالكامل.
  5. اتصل بمدير حسابك إذا استمر البطء — فقد يحتاج الخادم إلى ترقية الموارد.

لا تزال تواجه مشكلة؟

  • تحقق من سجلات النشاط (Activity Logs) في لوحة التحكم للبحث عن رسائل الخطأ.
  • اتصل بمدير حسابك مع تزويده بوصف للمشكلة وأي رسائل خطأ تظهر لك.