לדלג לתוכן

Widget & Embed Code

נתיב: /dashboard/embed · הרשאה: מודול הגדרות

Widget & Embed Widget & Embed

הווידג'ט הוא הדרך העיקרית שבה משתמשים מתקשרים עם עוזר ה-AI שלך באתר. הדף הזה מסביר איך לפרוס אותו, מה כל אטריביוט עושה, ואיך הווידג'ט עובד מתחת למכסה המנוע.

קבלת קוד ההטמעה שלך

הדרך הכי קלה לקבל את קוד ההטמעה:

  1. עבור ל-Dashboard → Embed בסרגל הצד.
  2. הדף מייצר אוטומטית את הסקריפט הנכון לבוט ולדומיין הנוכחיים שלך.
  3. לחץ על Copy כדי להעתיק את קטע ההטמעה המלא.
  4. הדבק אותו ב-HTML של האתר שלך, ממש לפני </body>.

מדריך לסקריפט ההטמעה

<script 
  src="https://user.frenzy.bot/chatbot-widget/v1/js/loader.js"
  data-bot-id="sales-assistant"
  data-bot-name="Sales Assistant"
  data-theme-color="#3b82f6"
  data-backend-url="https://user.frenzy.bot"
  async>
</script>

אטריביוטים

אטריביוט חובה מה הוא עושה
data-bot-id כן מזהה הסלאג הייחודי של הבוט שלך.
data-bot-name לא התווית שמוצגת בחלק העליון של חלון הצ'אט.
data-theme-color לא צבע ראשי של הווידג'ט (קוד הקס).
data-backend-url לא כתובת URL של השרת. ברירת המחדל היא https://user.frenzy.bot (או הדומיין המותאם אישית שלך).

איך למצוא את מזהה הבוט שלך

  • פתח את הדאשבורד ועבור ל-Embed או Settings.
  • מזהה הבוט מוצג בקוד ההטמעה ובדף ניהול הבוטים.
  • פורמט: אלפאנומרי באותיות קטנות עם מקפים (לדוגמה, sales-assistant, support-bot).

דף הטמעה דינמי

דף ה-Dashboard → Embed מזהה אוטומטית את שם המארח הנוכחי שלך ומייצר את קטע ההטמעה הנכון. זה יותר בטוח מאשר להכניס URLs בצורה קשיחה כי:

  • אם תשנה דומיינים מאוחר יותר, קוד ההטמעה שנוצר ישקף את הדומיין החדש אוטומטית.
  • כל בוט מקבל קטע הטמעה משלו עם ה-data-bot-id הנכון.
  • העתקה בלחיצה אחת הופכת את הפריסה למהירה.

פיצ'רים של הווידג'ט

ווידג'ט FRENZY.BOT בנוי לשימוש בפרודקשן עם היכולות האלה:

פיצ'ר מה הוא עושה
בידוד Shadow DOM מונע מה-CSS של האתר שלך לשבור את העיצוב של הווידג'ט
שימור סשן היסטוריית הצ'אט שורדת רענון דפים דרך localStorage
טעינה עצלה מונע ביצועים איטיים בשיחות ארוכות
חלון הקשר 6 ההודעות האחרונות נשלחות ל-AI לאיכות תגובה
רב-לשוני תומך במספר שפות עם זיהוי אוטומטי
תמיכה ב-RTL פריסה מלאה מימין לשמאל לעברית וערבית
שאלות מוצעות פרומפטים כתובים מראש שמוצגים מתחת להודעת הפתיחה
טופס לידים לכידת איש קשר בתוך הצ'אט עם שדות הניתנים להגדרה
המרת טקסט לדיבור השמעת אודיו אופציונלית לתגובות AI

בדיקת הווידג'ט

לפני הוספת הווידג'ט לאתר הפרודקשן שלך:

  1. וודא שהשרת רץ.
  2. פתח את דף הבדיקה המובנה: https://user.frenzy.bot/chatbot-widget/test.html
  3. שלח כמה הודעות בדיקה.
  4. רענן את הדף — היסטוריית הצ'אט אמורה להישמר.
  5. וודא שהבוט עונה תוך שימוש בתוכן מבסיס הידע שלך.

אינטגרציה עם WordPress

לאתרי WordPress, זמינות שתי אופציות:

אופציה 1: הדבקת הסקריפט

הוסף את סקריפט ההטמעה ל-footer.php של התבנית שלך או השתמש בפלאגין שמאפשר סקריפטים מותאמים אישית בפוטר.

אופציה 2: פלאגין WordPress

  • העלה את קובץ ה-ZIP של פלאגין FRENZY.BOT WordPress והפעל אותו.
  • השתמש בשורטקוד [FRENZY.BOT_whitelabel] לדף פורטל תמיכה מוטמע במסך מלא.

טעויות נפוצות

בעיה סיבה תיקון
הווידג'ט מופיע אבל לא עונה data-bot-id לא נכון בדוק את מזהה הבוט ב-Dashboard → Embed
הווידג'ט לא מופיע השרת לא נגיש וודא שפורט 8321 פתוח והשרת רץ
עובד ב-localhost, נכשל בפרודקשן חסר data-backend-url הגדר אותו ל-URL של דומיין הפרודקשן שלך
קונפליקטים של CSS עם האתר שלך לא משתמש ב-Shadow DOM זה לא אמור לקרות — בדוק סטיילים גלובליים כפויים
גרסה ישנה של הווידג'ט מוצגת מטמון הדפדפן cache busting מבוסס גרסה מטפל בזה אוטומטית

הטמעה לפי בוט

בהגדרת מולטי-בוט, לכל בוט יש קטע הטמעה משלו. אטריביוט ה-data-bot-id קובע איזה בוט מטפל בשיחה. הווידג'ט של כל בוט משתמש במשלו:

  • פרומפט מערכת ומודל AI
  • מיתוג, צבעים ואווטאר
  • הודעת פתיחה ושאלות מוצעות
  • הגדרת טופס לידים
  • הגדרות שפה

החלף בוטים בדאשבורד כדי לייצר את קוד ההטמעה הנכון לכל אחד.

שאלות נפוצות

ש: הווידג'ט נטען אבל לא עונה.

  • וודא ש-data-bot-id נכון.
  • אשר ש-OpenRouter מחובר (אינדיקטור LLM אמור להיות ירוק).
  • בדוק שבסיס הידע מכיל תוכן.

ש: הווידג'ט עובד ב-localhost אבל לא בפרודקשן.

  • וודא שפורט 8321 פתוח בשרת שלך.
  • הגדר את data-backend-url לדומיין הפרודקשן שלך (עם https://).
  • אם משתמש בדומיין מותאם אישית, וודא ש-SSL מוגדר נכון.

ש: אפשר להשתמש בווידג'ט במספר דומיינים?

  • כן. הווידג'ט עובד על כל דומיין כל עוד data-backend-url מפנה לשרת שלך. השתמש בדף ההטמעה הדינמי או בדומיין מותאם אישית לעקביות.

ש: איך מעדכנים את הווידג'ט אחרי שינויים?

  • עדכוני ווידג'ט מיושמים אוטומטית דרך cache busting מבוסס גרסה. כשהשרת מתעדכן, גרסת הווידג'ט עולה והדפדפנים מושכים את הגרסה החדשה.