← חזרה ל-/docs

💬 AIFLOW Chat Widget

הצמיד צ'אט-בוט שמריץ תהליך AIFLOW מלא לכל אתר אינטרנט — מקובץ HTML פשוט ועד WordPress, Shopify, Wix, Webflow ו-Squarespace. הביקור באתר הופך לשיחה רגילה ב-/conversations כמו WhatsApp, אז כל היכולות שכבר בניתם (קביעת תורים, ניהול לידים, העברה לנציג) זמינות באתר.

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

בכל אתר אפשר להפעיל את ה-widget באחד משני מצבים — נקבע ב-הגדרות → Embed Widget:

🧠 RAG בלבד (ברירת מחדל)
הבוט עונה משאלות חופשיות לפי Knowledge Base שבחרת. מתאים ל-FAQ, מדריכי משתמש, או צ'אט-בוט שעונה מטקסטים ארוכים. בלי flow.
⚡ Flow מלא (מומלץ)
כל ביקור מתחיל תהליך אמיתי שיצרת ב-/editor. הבוט יכול לשאול שאלות, להציע תפריטים, לקבוע תורים ביומן, לבדוק קיום לקוח, להעביר לנציג ועוד. כל ההודעות מתועדות ב-/conversations תחת ערוץ embed_widget:<siteKey>.

🚀 התקנה מהירה (HTML עצמאי)

הוסף את הקטע הבא לפני </body> בכל דף שבו תרצה את הבוט. החלף את YOUR_SITE_KEY ב-Site Key מ-הגדרות → Embed Widget:

<script async
        src="https://flow.txi.co.il/embed/aiflow-bot.js"
        data-site-key="YOUR_SITE_KEY"
        data-position="bottom-right"
        data-theme="auto"
        data-primary-color="#00f2a8"></script>

זה הכל. הרענן את הדף — כפתור הצ'אט יופיע בפינה ימין־למטה (או לפי position שבחרת).

⚙️ קונפיגורציה מתקדמת

אם דרושות לך שליטות נוספות (locale, callbacks, openingMessage runtime), אפשר להגדיר window.AIFLOW_CONFIG לפני שורת ה-script:

<script>
  window.AIFLOW_CONFIG = {
    siteKey: 'YOUR_SITE_KEY',
    host: 'https://flow.txi.co.il',                  // שנה רק אם self-hosted
    mode: 'chatbot',                  // 'chatbot' | 'search' | 'form'
    position: 'bottom-right',         // 'bottom-right' | 'bottom-left' | 'center'
    theme: 'auto',                    // 'auto' | 'light' | 'dark'
    primaryColor: '#00f2a8',
    locale: 'he',                     // 'he' | 'en'
    customerName: '',                 // אם כבר מזוהה — מועבר ל-flow כ-{{customerName}}
    metadata: {                       // אופציונלי — מועבר כ-_meta ב-flow context
      page: location.pathname,
      campaign: new URLSearchParams(location.search).get('utm_campaign') || '',
    },
  };
</script>
<script async src="https://flow.txi.co.il/embed/aiflow-bot.js"></script>

חשוב: אם הגדרת ב-/settings/embed רשימת allowedOrigins, ה-widget יסרב לעבוד מדומיינים אחרים. ברירת מחדל = פתוח לכל דומיין.

🔌 פלאגינים מוכנים לפלטפורמות

הפלאגינים העטופים שלנו עושים את אותה הפעולה (טוענים את aiflow-bot.js) — אבל עם UI התקנה ידידותית ל-merchant שלא מכיר HTML.

  • WordPress — plugins/wordpress/aiflow-chatbot/. מתקין דרך הלוח המסורתי, אופציה לטעון רק על דפים ספציפיים.
  • Shopify — plugins/shopify/aiflow-shopify-app/. אפליקציית Embedded App עם OAuth.
  • Wix — plugins/wix/aiflow-chatbot/. שני מסלולים: Velo (2 דקות) או App Market.
  • Webflow — plugins/webflow/aiflow-chatbot/. הדבקת snippet בתוך Project Settings → Custom Code → Footer.
  • Squarespace — plugins/squarespace/aiflow-chatbot/. Settings → Advanced → Code Injection → Footer.

לפלטפורמה אחרת (Drupal, Magento, Joomla…): השתמש בקטע ה-HTML הסטנדרטי. כל פלטפורמה שמאפשרת להזריק תגית <script> ב-footer תעבוד.

⚡ חיבור תהליך (חובה לקביעת תורים / לידים)

במצב ברירת המחדל, הבוט עונה לפי KB בלבד. כדי לאפשר תהליכי משא-ומתן אמיתיים:

  1. צור / ערוך flow ב-/editor. סוג טריגר: whatsapp_incoming מספיק — ה-engine לא מבדיל בין ערוצים.
  2. פתח /settings/embed, בחר את האתר, מתחת ל-Tab "תוכן" סמן את ה-flow תחת Flow (optional).
  3. שמור. ה-widget מיד מתחיל להריץ את ה-flow לכל ביקור חדש — בלי שינוי קוד באתר.

הדרך שבה ה-flow מתרגם לבוט באתר:

  • message node — בועה בצ'אט.
  • menu node — בועה + כפתורים לחיצים (עד 3 כפתורים) או רשימה אנכית (4+).
  • wait-input — ה-widget מחכה להודעת המבקר; ההודעה הבאה ממשיכה את ה-flow.
  • calendar-book — תור נקבע ביומן הלקוח בדיוק כמו ב-WhatsApp.
  • talk-to-agent — ההלחין מקבל הודעת "נציג יחזור אליך"; השיחה מסומנת ב-/conversations כ-handover.

📋 איפה רואים את השיחות

כל ביקור עם flow מצורף יוצר שורת Conversation חדשה תחת ערוץ embed_widget:<siteKey>. היא תופיע ב-/conversations לצד WhatsApp / Messenger / Telegram. אפשר:

  • לראות את ההיסטוריה המלאה של ההודעות.
  • להשתלט ידנית — לרשום הודעה ידנית והמבקר יראה אותה (טוען בזמן אמת).
  • להפעיל "השתק בוט" — להפסיק את ה-flow ולתת לנציג להמשיך.
  • לסמן תגיות, לרענן, להעביר לנציג אחר.

🔐 אבטחה ומגבלות

  • Origin allowlist — ב-/settings/embed רשום רק את הדומיינים המורשים. ברירת מחדל ריקה = פתוח לכולם (למקרה הראשון מומלץ להחמיר).
  • Rate limit — 30 בקשות chat / דקה לכל (siteKey, IP). הגבלות נפרדות ל-search/form/session.
  • אין עוגיות צד-שלישי — ה-widget משתמש ב-localStorage בלבד לזיהוי visitor.
  • CORS — ה-API מחזיר Access-Control-Allow-Origin דינמי פר-origin, כך שכל אתר מורשה יכול לקרוא לו.

🧪 בדיקה לוקאלית

לפני שמכניסים את הקוד לאתר אמיתי, ניתן לבדוק בדף HTML פשוט. שמור את הקוד הבא כ-test.html ופתח במחשב מקומי (file:// יעבוד אם allowedOrigins ריק):

<!DOCTYPE html>
<html lang="he" dir="rtl">
<head>
  <meta charset="utf-8">
  <title>AIFLOW Widget Test</title>
</head>
<body>
  <h1>בדיקת ה-widget</h1>
  <p>הכפתור צריך להופיע בפינה ימין־למטה.</p>

  <script async
          src="https://flow.txi.co.il/embed/aiflow-bot.js"
          data-site-key="YOUR_SITE_KEY"></script>
</body>
</html>

📚 API למפתחים

אם דרושה אינטגרציה עמוקה יותר (פתיחה/סגירה מקוד, שליחה תכנותית של הודעות), ה-API החיצוני מתועד ב-/docs/external-send-api ובדף ה-API הראשי ב-/docs.

ב-AIFLOW Studio תוכל גם לראות תצוגה מקדימה של ה-widget לפני פרסום, ולעדכן בזמן אמת את הצבעים / הברכה / הודעת הפתיחה.