EN עב
תיעוד / פתרון בעיות

מדריך פתרון בעיות

פתרונות לבעיות נפוצות ב-WooAI Chatbot Pro. מצא את הבעיה שלך בהמשך והעקוב אחרי ההנחיות שלב אחרי שלב.

🔧 רשימת בדיקה מהירה

לפני שתתחיל לאתר בעיות ספציפיות, עבור על רשימה זו:

  • התוסף מופעל והרישיון תקף
  • מפתח API של ספק AI מוגדר ובדוק
  • קונסול הדפדפן לא מציג שגיאות JavaScript
  • גרסת PHP בשרת היא 7.4 או גבוהה יותר
  • WordPress ו-WooCommerce מעודכנים
  • תוספי קאשינג נוקו לאחר שינויים

בעיות ווידג'ט

❌ ווידג'ט הצ'אט לא מופיע בחזית האתר
סיבות אפשריות:
  • הווידג'ט מבוטל בהגדרות
  • העמוד הנוכחי נמצא ברשימה "הסתר בעמודים"
  • סכסוך JavaScript עם הערכה או תוספים אחרים
  • חוסם פרסומות חוסם את סקריפט הווידג'ט
✓ פתרון:
  1. עבור אל WooAI Chat → הגדרות ובדוק שה"הפעל ווידג'ט" דלוק
  2. בדוק את הגדרת "הסתר בעמודים" - הסר את העמוד הנוכחי אם הוא רשום
  3. פתח קונסול דפדפן (F12) וחפש שגיאות JavaScript
  4. כבה חוסם פרסומות זמנית לבדיקה
  5. נסה להחליף לערכה ברירת מחדל של WordPress (Twenty Twenty-Four)
  6. בטל הפעלה של תוספים אחרים אחד אחד כדי למצוא סכסוכים
❌ הווידג'ט מופיע אך לחיצה לא עושה כלום
סיבות אפשריות:
  • JavaScript לא נטען לחלוטין
  • סכסוך CSS z-index (משהו מכסה את הווידג'ט)
  • מטפלי אירועים לא מצורפים כראוי
✓ פתרון:
  1. המתן לעמוד להטען לחלוטין לפני לחיצה
  2. בדוק קונסול דפדפן לשגיאות
  3. בדוק את אלמנט הווידג'ט - חפש אלמנטים חופפים
  4. הוסף CSS מותאם זה: .wooai-chat-launcher { z-index: 999999 !important; }
  5. נקה את כל הקאשים וטען מחדש בכוח (Ctrl+Shift+R)
❌ מיקום הווידג'ט שגוי או חוצה תוכן
סיבות אפשריות:
  • לערכה יש אלמנטים קבועים באותו מיקום
  • יש צורך בהתאמת ערכי ההיסט
  • ווידג'טים צפים אחרים (כמו הודעות עוגיה) מתנגשים
✓ פתרון:
  1. עבור אל WooAI Chat → מראה
  2. נסה לשנות את המיקום מימין-תחתית לשמאל-תחתית (או להיפך)
  3. הגדל את ערכי ההיסט (נסה 30-50px במקום 20px)
  4. השתמש ב-CSS מותאם כדי להדק את המיקום אם יש צורך

בעיות ספק AI

❌ שגיאה "מפתח API לא תקף"
סיבות אפשריות:
  • מפתח API הועתק בטעות (רווחים נוספים)
  • מפתח API בוטל או פג תוקפו
  • שימוש בסוג מפתח שגוי (מפתח שירות לעומת מפתח ציבורי)
✓ פתרון:
  1. עבור לחדר הבקרה של ספק ה-AI שלך וצור מפתח API חדש
  2. העתק את המפתח בעדינות - אין רווחים לפני או אחרי
  3. עבור Gemini: השתמש במפתח מ-Google AI Studio (לא Google Cloud)
  4. עבור OpenAI: המפתח צריך להתחיל ב-sk-
  5. עבור Claude: המפתח צריך להתחיל ב-sk-ant-
  6. הדבק את המפתח החדש וחסוך הגדרות
  7. השתמש בכפתור "בדוק חיבור" כדי לוודא
❌ שגיאה "חריגה מגבול התעריף"
סיבות אפשריות:
  • יותר מדי בקשות בזמן קצר
  • חריגה מהקוטה החודשית/יומית
  • הגעה למגבלות התוכנית החינמית
✓ פתרון:
  1. המתן 1-2 דקות ונסה שוב
  2. בדוק את לוח הבקרה של שימוש של ספקך עבור סטטוס הקוטה
  3. הגדר ספק חילוף בהגדרות WooAI
  4. שקול שדרוג לתוכנית בתשלום למגבלות גבוהות יותר
  5. עבור Gemini בתוכנית החינמית: 60 בקשות/דקה
❌ תגובות כל כך איטיות (10+ שניות)
סיבות אפשריות:
  • שימוש במודל AI איטי/כבד
  • הנחיית מערכת גדולה או הקשר
  • חיפוש RAG נמשך יותר מדי זמן
  • בעיות רשת בין השרת שלך לספק AI
✓ פתרון:
  1. עבור למודל מהיר יותר: gemini-1.5-flash או gpt-4o-mini
  2. הקטן את אורך הנחיית המערכת (שמור מתחת ל-500 מילים)
  3. בהגדרות RAG, הקטן את "תוצאות מקסימום" ל-3
  4. הגדל את סף הדמיון כדי להפחית את זמן החיפוש
  5. בדוק AI ישירות דרך קונסול הספק כדי לבודד בעיות רשת
❌ AI נותן תשובות שגויות או כלליות לגבי מוצרים
סיבות אפשריות:
  • RAG לא מוגדר או מבוטל
  • מוצרים לא באינדקס בתוך Supabase
  • סף דמיון גבוה מדי (תוצאות חסרות)
  • תיאורי מוצר קצרים מדי
✓ פתרון:
  1. עבור אל WooAI Chat → RAG וחיפוש ובדוק שזה מופעל
  2. בדוק את מספר המוצרים באינדקס - צריך להתאים לקטלוג שלך
  3. לחץ על "אינדקס מחדש את כל המוצרים" כדי לרענן את האינדקס
  4. הנמך את סף הדמיון ל-0.6 לתוצאות נוספות
  5. הוסף תיאורי מוצר מפורטים יותר ב-WooCommerce

בעיות RAG וSupabase

❌ שגיאה "התחברות ל-Supabase נכשלה"
סיבות אפשריות:
  • כתובת URL או מפתח API של Supabase שגויים
  • פרויקט Supabase הושהה (חוסר פעילות בתוכנית חינמית)
  • חומת אש בשרת חוסמת חיבורים יוצאים
✓ פתרון:
  1. אמת את פורמט כתובת ה-URL של Supabase: https://xxxxx.supabase.co
  2. השתמש במפתח anon (ציבורי), לא service_role
  3. היכנס ל-Supabase ובדוק אם הפרויקט הושהה - שחזר אם נדרש
  4. צור קשר עם המארח שלך אם חומת אש חוסמת יציאה בפורט 443
❌ אינדקס מוצרים נכשל או תלוי
סיבות אפשריות:
  • PHP timeout עבור קטלוגים גדולים
  • חרג מגבול הזיכרון
  • מגבלי התעריף של Supabase הושגו
✓ פתרון:
  1. הגדל את PHP max_execution_time ל-300 ב-php.ini
  2. הגדל את PHP memory_limit ל-256M או יותר
  3. עבור קטלוגים גדולים (1000+), אינדקס בערימות באמצעות WP-CLI: 
    wp wooai index-products --batch=100
  4. המתן כמה דקות בין ערימות גדולות
❌ החיפוש אינו מחזיר תוצאות או מחזיר מוצרים שגויים
סיבות אפשריות:
  • מוצרים לא באינדקס או באינדקס חלקי
  • סף דמיון גבוה מדי
  • תיאורי מוצר לא תואמים תנאי החיפוש
✓ פתרון:
  1. השתמש בתכונה "בדוק חיפוש" בהגדרות RAG
  2. הנמך את סף הדמיון ל-0.5 זמנית לבדיקה
  3. לחץ על "אינדקס מחדש את כל המוצרים" כדי לרענן
  4. הוסף מילות מפתח רלוונטיות לתיאורי מוצר
  5. כלול נרדפות נפוצות (למשל, "נעלי ריצה", "סניקרים)")

בעיות רישיון

❌ הפעלת רישיון נכשלה
סיבות אפשריות:
  • מפתח הרישיון הועתק בטעות
  • הרישיון כבר בשימוש בתחנה אחרת
  • השרת לא יכול להגיע לשרת הרישיון
✓ פתרון:
  1. העתק את מפתח הרישיון שוב מדוא"ל הקנייה שלך
  2. ודא שאין רווחים נוספים לפני/אחרי המפתח
  3. אם אתה מעביר מאתר אחר, בטל הפעלה שם תחילה
  4. בדוק שהשרת שלך מאפשר חיבורים HTTPS יוצאים
  5. צור קשר עם התמיכה אם אתה צריך לאפס את ההפעלה שלך

בעיות ביצועים

❌ האתר מאט אחרי התקנת התוסף
סיבות אפשריות:
  • סכסוך בתוסף גורם להאטת PHP
  • שאילתות מסד נתונים לא מותאמות
  • הקאשינג לא מוגדר כראוי
✓ פתרון:
  1. ווידג'ט WooAI נטען באופן אסינכרוני - לא צריך להשפיע על טעינת עמוד
  2. אם איטי בניהול, בדוק סכסוכי תוספים
  3. הפעל קאשינג אובייקטים (Redis/Memcached) אם זמין
  4. השתמש בתוסף Query Monitor כדי לזהות שאילתות איטיות
  5. צור קשר עם התמיכה עם נתוני ביצועים אם הבעיה נמשכת

הפעל מצב ניפוי בעיות

לצורך פתרון בעיות מתקדם, הפעל מצב ניפוי כדי לראות יומנים מפורטים:

יומן ניפוי בעיות של WordPress

הוסף שורות אלה ל-wp-config.php שלך:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

היומנים יישמרו ל-/wp-content/debug.log

מצב ניפוי בעיות של WooAI

הפעל בהגדרות WooAI:

  1. עבור אל WooAI Chat → הגדרות → מתקדם
  2. הפעל "מצב ניפוי בעיות"
  3. שחזר את הבעיה
  4. בדוק debug.log עבור פריטים ספציפיים ל-WooAI
⚠️ בטל בייצור

זכור לבטל את מצב ניפוי בעיות באתרי ייצור. יומני ניפוי בעיות יכולים להכיל מידע רגיש ועלולים להשפיע על ביצועים.

בדיקת דרישות השרת

אמת שהשרת שלך עומד בדרישות המינימום:

PHP Version: 7.4+ (8.0+ recommended)
WordPress: 6.0+
WooCommerce: 7.0+
Memory Limit: 128M+ (256M recommended)
Max Execution Time: 60+ seconds
cURL: Enabled with SSL
OpenSSL: 1.0.1+

בדוק את התצורה שלך ב-WordPress: כלים → בריאות אתר → מידע

עדיין תקוע?

אם ניסית את הפתרונות לעיל ועדיין יש בעיות, צוות התמיכה שלנו כאן כדי לעזור.

בעת יצירת קשר עם התמיכה, כלול: גרסת WordPress, גרסת WooCommerce, גרסת PHP, הודעות שגיאה, ושלבים לשחזור.

צור קשר עם תמיכה
שאלות נפוצות ← ← חזרה לעמוד הבית של התיעוד