הצמיד צ'אט-בוט שמריץ תהליך AIFLOW מלא לכל אתר אינטרנט — מקובץ HTML פשוט ועד WordPress, Shopify, Wix, Webflow ו-Squarespace. הביקור באתר הופך לשיחה רגילה ב-/conversations כמו WhatsApp, אז כל היכולות שכבר בניתם (קביעת תורים, ניהול לידים, העברה לנציג) זמינות באתר.
בכל אתר אפשר להפעיל את ה-widget באחד משני מצבים — נקבע ב-הגדרות → Embed Widget:
/conversations תחת ערוץ embed_widget:<siteKey>.הוסף את הקטע הבא לפני </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.
plugins/wordpress/aiflow-chatbot/. מתקין דרך הלוח המסורתי, אופציה לטעון רק על דפים ספציפיים.plugins/shopify/aiflow-shopify-app/. אפליקציית Embedded App עם OAuth.plugins/wix/aiflow-chatbot/. שני מסלולים: Velo (2 דקות) או App Market.plugins/webflow/aiflow-chatbot/. הדבקת snippet בתוך Project Settings → Custom Code → Footer.plugins/squarespace/aiflow-chatbot/. Settings → Advanced → Code Injection → Footer.לפלטפורמה אחרת (Drupal, Magento, Joomla…): השתמש בקטע ה-HTML הסטנדרטי. כל פלטפורמה שמאפשרת להזריק תגית <script> ב-footer תעבוד.
במצב ברירת המחדל, הבוט עונה לפי KB בלבד. כדי לאפשר תהליכי משא-ומתן אמיתיים:
whatsapp_incoming מספיק — ה-engine לא מבדיל בין ערוצים.הדרך שבה ה-flow מתרגם לבוט באתר:
כל ביקור עם flow מצורף יוצר שורת Conversation חדשה תחת ערוץ embed_widget:<siteKey>. היא תופיע ב-/conversations לצד WhatsApp / Messenger / Telegram. אפשר:
/settings/embed רשום רק את הדומיינים המורשים. ברירת מחדל ריקה = פתוח לכולם (למקרה הראשון מומלץ להחמיר).localStorage בלבד לזיהוי visitor.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 החיצוני מתועד ב-/docs/external-send-api ובדף ה-API הראשי ב-/docs.
ב-AIFLOW Studio תוכל גם לראות תצוגה מקדימה של ה-widget לפני פרסום, ולעדכן בזמן אמת את הצבעים / הברכה / הודעת הפתיחה.