ה-chat widget הוא סקריפט JS שאתם מטמיעים באתר שלכם (שיווק, תמיכה, אפליקציה). הוא פותח חלון שיחה המופעל על ידי אחד מה-pipelines שלכם ב-betool; תשובות הסוכן מוצגות בהדרגה, תוך כדי יצירתן (streaming).
מאפיינים
- snippet אחד להדבקה בדף שלכם. ללא תלות ב-npm; ה-widget חי בתוך Shadow DOM, כך שה-CSS של האתר שלכם אינו מעוות אותו (וגם להפך).
- Token ציבורי — ניתן ליצירה מחדש בכל עת מתוך העורך. אין סוד בצד הלקוח.
- רציפות לכל לשונית — מזהה השיחה נשמר ב-
sessionStorage: טעינה מחדש של הדף ממשיכה את השיחה, סגירת הלשונית מסיימת אותה. ה-widget אינו שומר אף cookie. - 8 שפות — ממשק ה-widget עוקב אחר שפת הדפדפן של המבקר.
- מנגנוני הגנה מפני ניצול לרעה פעילים כברירת מחדל — 20 הודעות לדקה לכל IP, 10 sessions חדשים לדקה לכל IP, עד 4,000 תווים להודעה (ניתנים להגדרה;
0מבטל הגנה). תקרה גלובלית לכל widget (פי 20 מהמגבלה לכל IP) חוסמת גם הצפות המפוזרות על פני מספר כתובות IP.
הגדרה
- בעורך המודל, הגדירו את צומת ה-Start עם מקלט צ'אט (וידג'ט אינטרנט).
- בעת השמירה, betool מייצרת את ה-token הציבורי ומציגה את snippet ההטמעה, מוכן להעתקה:
<script src="https://platform.betool.ai/widget/v1/widget.js"></script>
<script>
BetoolChat.init({ token: "<token-public-du-widget>" });
</script>
- הדביקו את ה-snippet הזה בתוך תגית ה-
<body>של האתר שלכם. ה-widget מופיע אוטומטית, בפינה הימנית-תחתונה כברירת מחדל.
התאמה אישית
מתוך תצורת המקלט:
- מראה — הכותרת המוצגת, צבע ראשי, מיקום (ארבע פינות), צורת כפתור הפתיחה (לשונית או בועה) והתווית שלו.
- טקסטים — הודעת פתיחה, טקסט שדה הקלט, טקסט סטטוס (או תצוגת «מחובר» מתורגמת).
- תצוגה — הצגת ה-markdown של התשובות (מופעלת כברירת מחדל).
- הקשר הדף — מעביר עם כל הודעה את ה-origin והנתיב של הדף הנוכחי (לעולם לא את ה-query string). מופעל כברירת מחדל, ניתן לביטול.
- היקף — הגבלת ה-origins המורשים.
אבטחה
ה-token הוא ציבורי מעצם תכנונו: הוא מאפשר רק לשוחח עם המודל שנושא את המקלט הזה. אם אתם מגדירים רשימת origins מורשים, בקשה שמגיעה מ-origin אחר נדחית בצד השרת (403); רשימה ריקה (או *) אינה מטילה שום הגבלה — לשימוש בפיתוח בלבד. לביטול token שנחשף: כפתור יצירה מחדש ליד ה-URL הציבורי, בתצורת המקלט (כל ה-snippets שכבר בייצור מפסיקים אז לפעול).