יישומון צ’אט #

מדריך הטמעת יישומון צ’אט באתר #

הוסיפו לאתר שלכם יישומון צ’אט ידידותי למשתמש המאפשר למבקרים לתקשר ישירות דרך ממשק האתר. תהליך ההטמעה פשוט ויעניק לאתר שלכם יכולות הודעות מובנות.

יצירה והגדרה של ווידג’ט הצ’אט #

איך מגיעים לשם:

1. לחץ על הגדרות (Settings) ליד החלק התחתון של סרגל הצד השמאלי. (בטלפון, הקש תחילה על סמל התפריט ☰ בפינה העליונה כדי לפתוח את סרגל הצד.)
2. בסרגל הצד של ההגדרות, תחת ערוצים (Channels), לחץ על ערוצים.
3. מצא את הכרטיס ווידג’ט צ’אט לאתר (Website chat widget).
4. אם עדיין אין לך ווידג’ט, לחץ על התחבר (Connect) כדי ליצור אחד עם שם תצוגה והודעת פתיחה.
5. לאחר היצירה, לחץ על נהל (Manage) בכל עת כדי לפתוח את לוח ההגדרות המלא.

שינויים שאתה שומר חלים על הווידג’ט החי שלך באופן אוטומטי — אין צורך להדביק מחדש את קוד ההתקנה לאחר ביצוע שינוי.

לצד ההגדרות מוצגת תצוגה מקדימה חיה (Live preview): דף אינטרנט לדוגמה שבו פועל הווידג’ט האמיתי שלך, המציג את הצבעים, המיקום, הלוגו, סמל המפעיל והקופץ היזום בדיוק כפי שהמבקרים יראו אותם. התצוגה עוקבת אחר העריכות שלך בזמן אמת, כך שאין צורך לשמור כדי לראות איך נראה שינוי בצבע או בעיצוב. ניתן אפילו ללחוץ על כפתור הצ’אט בתוך התצוגה המקדימה כדי לפתוח את הווידג’ט ולנסות אותו.

מה ניתן להתאים אישית #

לוח הניהול מאורגן בארבעה חלקים.

מראה #

• ערכת נושא עיצובית: עצבו מחדש את כל הווידג’ט בלחיצה אחת. שש ערכות נושא קובעות יחד את המראה, הצבעים, הפינות והגופן: Classic (המראה המקורי והמוצק — סרגל כותרת צבעוני על לוח שטוח), Glass (לוח שקוף למחצה עם אפקט זכוכית חלבית המטשטש בעדינות את הדף שמאחוריו, כאשר הכותרת ותיבת ההודעות צפים ככרטיסים מעוגלים בתוכו), Midnight (גרסת Glass בצבעים כהים), Bloom (ורוד רך, מעוגל במיוחד), Ember (גרסת Glass בכתום חמים) ו-Mono (שחור-לבן, פינות חדות). ערכת נושא היא נקודת התחלה — לאחר בחירת אחת, עדיין ניתן לשנות כל צבע או הגדרה בנפרד. ווידג’טים חדשים מתחילים עם Glass; המעבר מתבצע באופן מיידי בכל מקום שבו הווידג’ט מוטמע, ללא צורך בשינויי קוד באתר שלך.
• פינות וגופן: שני כפתורי עיצוב עצמאיים. פינות קובע עד כמה הלוח, הבועות והכפתורים יהיו מעוגלים (מעוגל, רך או חד), ו-גופן בוחר את הגופן שהמבקרים יראו (ברירת מחדל, Serif, מעוגל או Mono) — הגופנים מגיעים ממה שכבר קיים במכשיר של המבקר, כך שלא נטען שום דבר נוסף באתר שלך.
• שם תצוגה: מוצג בכותרת הווידג’ט.
• לוגו: העלו תמונה שמופיעה בראש הצ’אט. השתמשו בלוגו החברה שלכם או בתמונת פנים ידידותית.
• אייקון מפעיל: האייקון שעל כפתור הצ’אט הצף עצמו. בחרו אחד מהאייקונים המובנים (בועת צ’אט, מטוס נייר, סימן שאלה ועוד), השתמשו שוב בלוגו שהעליתם, או העלו תמונה נפרדת משלכם — שימושי אם ברצונכם להציג תמונה של חבר צוות אמיתי שמקבל את פני המבקרים.
• צבעים: חמישה צבעים, כל אחד מהם מגדיר את החלק בווידג’ט שהוא צובע. צבע מותג הוא הכפתור הצף, הכותרת וההודעות של המבקר עצמו, עם טקסט מותג עבור הטקסט שמופיע מעליו. בועת בוט היא הרקע של תשובות הבוט שלכם ושל מחוון ההקלדה, עם טקסט בועת בוט עבור המילים שבתוכם ונקודות ההקלדה המונפשות. חלון צ’אט הוא הלוח שמאחורי כל ההודעות. בחרו צבע לבועת הבוט ששונה בבירור מצבע המותג שלכם — אם השניים תואמים, שני הצדדים של השיחה ייראו באותו צבע והמבקרים לא יוכלו להבדיל בין תשובות הבוט לבין ההודעות שלהם. בועת בוט באפור בהיר עם טקסט כהה לצד צבע המותג שלכם היא השילוב הבטוח.
• מיקום: מקמו את כפתור הצ’אט הצף בפינה הימנית התחתונה או השמאלית התחתונה, עם היסט אופקי ואנכי (בפיקסלים) אם הוא מסתיר משהו אחר בדף שלכם.
• שאלות פתיחה: הצעות לתגובה מהירה (צ’יפים לחיצים) המוצגות בצ’אט כדי שהמבקרים יוכלו להתחיל בלחיצה אחת במקום להקליד — למשל “מהם המחירים שלכם?” או “האם אתם מציעים תמיכה?” — עד 10 שאלות.
• שורת כותרת תחתונה: שורה קטנה ואופציונלית של טקסט משלכם מתחת לתיבת ההודעות, למשל “מופעל על ידי הסוכנות שלך”. היא כבויה כברירת מחדל, ולא מוצג דבר מתחת לתיבת ההודעות כשהיא כבויה. הפעילו אותה, הקלידו את הטקסט שלכם (עד 40 תווים) ואם תרצו, הוסיפו קישור שמתחיל ב-https://; מבקרים שיקליקו על הטקסט יפתחו את הדף הזה בלשונית חדשה. סוכנויות משתמשות בזה כדי להוסיף את השם שלהן לווידג’טים שהן בונות עבור לקוחות.

התנהגות #

• הודעת פתיחה: ההודעה הראשונה שמבקרים רואים כשהם פותחים את הצ’אט (למשל, “איך אוכל לעזור לך?”).
• צליל: השמעת צליל כאשר מגיעה הודעה חדשה בצ’אט.
• בקשת הרשאה להתראות: אפשרות לבקש ממבקרים לאשר התראות דפדפן, כדי שיקבלו התראה על תשובות גם כשהם עוברים ללשוניות אחרות.
• בועת קופץ יזומה: בועה קטנה ואופציונלית שקופצת לצד כפתור הצ’אט כדי להזמין אנשים ליצור קשר. הפעל אותה כדי להגדיר את ההודעה שלה, את הטקסט בכפתורי האישור/דחייה, וכמה שניות להמתין לפני שהיא מופיעה. הבועה נסגרת מעצמה לאחר 20 שניות אם המבקר לא לוחץ עליה. זהו הטקסט היחיד שהווידג’ט מציג לצד כפתור הצ’אט: אין הגדרה לתווית קבועה לצד הכפתור.
• מהירות תגובת AI: מחוון בין איטי יותר (אנושי יותר — ה-AI לוקח רגע לפני המענה) לבין מהירות מקסימלית (רובוטי יותר — תשובות מגיעות מהר ככל האפשר). מצב מאוזן נמצא באמצע. ההודעה הראשונה של התשובה מגיעה בהשהיה שקובע המחוון, כאשר מחוון ההקלדה מופיע זמן קצר לפני כן.
• הצגת הערת “עסוק” בזמן שה-AI עובד: כבוי כברירת מחדל. כאשר תשובה לוקחת יותר מכמה שניות, למשל כי הסוכן שלך מחפש מידע במערכת אחרת, המבקרים יראו שורה קצרה לצד נקודות ההקלדה: “עובד על התשובה שלך” אחרי 5 שניות, “מחפש את זה עבורך” אחרי 15 שניות, ולאחר מכן “עדיין עובד על זה, כמעט מוכן” והתנצלות על ההמתנה אם זה נמשך זמן רב יותר. תשובות מהירות יציגו רק את הנקודות. השורה מופיעה בשפת הווידג’ט, והיא מופיעה רק בזמן שה-AI שלך אכן עובד על תשובה, לעולם לא כשה-AI כבוי עבור אותו צ’אט או כשנציג אנושי השתלט על השיחה.

שפות #

הווידג’ט הוא רב-לשוני כברירת מחדל — אין צורך להפעיל דבר.

• הוא בוחר את שפת המבקר באופן אוטומטי. ראשית הוא בודק את השפה שהדף שלך מצהיר עליה ב-HTML שלו (<html lang="it">), לאחר מכן הוא חוזר לשפת הדפדפן של המבקר. אם אף אחת מהן אינה שפה שאנו תומכים בה, התוויות של הווידג’ט עצמו יוצגו בשפה שבה כתבת את הודעת הפתיחה שלך, והודעת הפתיחה, בועית הקופץ ושאלות הפתיחה שלך יופיעו בדיוק כפי שכתבת אותן.

• שפת דף שסותרת את הברכה שלך אינה מהימנה. חלק מבוני אתרים מציבים lang="en" בכל דף ללא קשר לשפה שבה האתר כתוב. כאשר הדף מצהיר על שפה אחת ואתה כתבת את הודעת הפתיחה בשפה אחרת, הווידג’ט מתייחס לערך הדף כאל ברירת מחדל של בונה האתרים: הוא עוקב אחר שפת הדפדפן של המבקר במקום זאת, ואם זו אינה שפה שאנו תומכים בה, הוא משתמש בשפה שבה כתבת. דף שמחליף את ערך ה-lang שלו כאשר המבקר בוחר שפה באתר שלך תמיד יזכה למעקב. אם אתה מעדיף לא להסתמך על כל זה, קבע את השפה בסעיף התנהגות (Behavior).

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

• שפות נתמכות: אנגלית, הולנדית, גרמנית, צרפתית, ספרדית, איטלקית, פורטוגזית, רומנית, פולנית, ערבית, פינית, פיליפינית, סלובנית, תאית, בנגלית, יפנית, נורווגית (Bokmål) וטורקית. זוהי הרשימה עבור הכפתורים והתוויות של הווידג’ט עצמו.

• שפות מימין לשמאל מוצגות מימין לשמאל. עבור מבקרים דוברי ערבית, עברית, פרסית ואורדו, כל חלון הצ’אט משתקף: הכותרת, בועיות ההודעה, נקודות ההקלדה, טופס המבקר ותיבת ההודעה כולם מתחילים מימין. כפתור הבועית נשאר בפינה שבחרת. מבקרים דוברי עברית, פרסית ואורדו רואים את התוויות באנגלית (או בשפה שקבעת), אך הפריסה עדיין עוקבת אחר השפה שלהם. הודעה שנכתבה בכיוון אחר, כגון תשובה באנגלית בצ’אט בערבית, עדיין נקראת בסדר הנכון.

• ההודעות שלך מתורגמות עבורך. בכל פעם שאתה שומר, הודעת הפתיחה שלך, בועית הקופץ היזומה ושאלות הפתיחה מתורגמות לכל שמונה-עשרה השפות שלעיל. אתה כותב אותן רק פעם אחת, בכל שפה שתעדיף: השפה שבה כתבת מזוהה מתוך הטקסט עצמו, גרסה זו נשמרת מילה במילה, וכל שפה אחרת היא תרגום שלה. לא משנה באיזו שפה מוגדר החשבון שלך.

• כתוב גרסה משלך לשפה. סעיף תרגומים בלוח הניהול, ממש מתחת להתנהגות, מאפשר לך להחליף את התרגום האוטומטי בניסוח משלך, למשל ספרדית רשמית (“usted”) במקום שבו התרגום האוטומטי הוא לא רשמי. בחר שפה תחת שפה, ולאחר מכן מלא כל אחד מהבאים: הודעת פתיחה, הודעת קופץ, טקסט אישור ו-טקסט דחייה של הקופץ (מוצגים בזמן שבועת הקופץ פעילה) ו-שאלות פתיחה. כל שדה מציג את התרגום האוטומטי באפור; התחל מהתרגום האוטומטי מעתיק אותו פנימה כדי שתוכל לערוך משם. כל מה שתשאיר ריק ישמור על התרגום האוטומטי. שפות שכתבת בעצמך מופיעות ראשונות, מסומנות כ-הניסוח שלך, ו-הסר את הניסוח שלי ל-(שפה) מחזיר לתרגום האוטומטי עבור אותה שפה. הניסוח שלך נשמר כאשר אתה עורך מאוחר יותר את הטקסט המקורי; רק התרגומים האוטומטיים מבוצעים מחדש.

• כפתורי הקופץ מתורגמים גם הם. כפתורי האישור והדחייה של בועית הקופץ היזומה מתורגמים יחד עם שאר ההודעות שלך, כך שמבקר ספרדי לא יראה יותר כפתורים באנגלית.

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

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

• הגדר את השפה לכל דף בקוד ההטמעה. מריץ ווידג’ט אחד באתר באנגלית ועותק מתורגם שלו? הוסף data-lang לתג הסקריפט של הווידג’ט בכל דף. data-lang="es" מציג את הווידג’ט בספרדית באותו דף ללא קשר למה שהדפדפן אומר; data-lang="page" גורם לו לעקוב אחר ערך ה-<html lang="..."> של הדף עצמו (כך ש-lang="es-MX" נותן ספרדית), גם כאשר הודעת הפתיחה שלך כתובה בשפה אחרת. זה גובר על השדה שפת הווידג’ט, שבתורו גובר על זיהוי אוטומטי. לדוגמה:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" data-lang="page" defer></script>

שמור על קוד ההטמעה מלוח הניהול כפי שהוא והוסף רק את המאפיין data-lang. עבור לוח צ’אט מוטבע, שים data-lang על ה-<div data-chat-widget="…"> במקום זאת.

טיפ: אם האתר שלך לא מגדיר מאפיין lang בתגית ה-<html> שלו, כדאי להוסיף אחד כזה. זהו הסימן החזק ביותר שיש לנו לבחירת השפה הנכונה, במיוחד עבור מבקרים הגולשים מחוץ לארץ.

איסוף לידים ופרטיות #

• איסוף פרטי מבקר: כבוי כברירת מחדל. כשהאפשרות מופעלת, מבקרים מתבקשים להזין שם וכתובת אימייל (ואופציונלית טלפון) לפני תחילת השיחה, כך שתתפוס את הליד גם אם הם עוזבים באמצע הצ’אט.
• כותרת טופס וכותרת משנה לטופס: התאמה אישית של הכותרת וההסבר הקצר שמוצגים מעל הטופס.
• איסוף מספר טלפון: הפעל כדי לבקש גם מספר טלפון; במצב כבוי נאספים רק שם ואימייל.
• איסוף שם משפחה: כבוי כברירת מחדל. הפעל כדי להוסיף שדה חובה של שם משפחה מיד לאחר השם הפרטי. הוא נשמר באיש הקשר כשם המשפחה שלו, כך של-AI שלך ולכל מה שהוא מחפש במערכות שלך יהיה את השם המלא מההודעה הראשונה. מבקרים שכבר מילאו את הטופס לפני שהפעלת אפשרות זו לא יתבקשו למלא אותו שוב.
• אימיילים על תשובות שלא נקראו למבקרים: מבקר שהשאיר כתובת אימייל ולא ראה את התשובה שלך לאחר 15 דקות יקבל אימייל שמפנה אותו חזרה לצ’אט. כבה זאת תחת הגדרות ← התראות ← מבקרים בווידג’ט צ’אט. ראה אימיילים למבקרים בווידג’ט צ’אט.

מבקר השאיר מספר טלפון ועזב את האתר שלך — האם ניתן להמשיך בוואטסאפ? כן. פתח את הצ’אט שלו ובחר ב-המשך בוואטסאפ מתפריט שלוש הנקודות (יש לחבר את WhatsApp Web או WhatsApp Business). Your AI Connector יוצרת שיחת וואטסאפ מקושרת עבור אותו אדם, מעתיקה את שמו, כתובת האימייל ופרטיו, וה-AI מעביר את מה שנאמר באתר, כך שאף אחד לא צריך לחזור על דבריו. צ’אט האתר נשאר במקומו ושתי השיחות מצביעות זו על זו תחת שיחות מקושרות בלוח אנשי הקשר. ראה ממשק צ’אט.

מבקר השאיר את כתובת האימייל שלו אך לא ביצע הזמנה — האם אוכל לשלוח לו אימייל המשך? כן, באמצעות אוטומציה. שלב יצירת איש קשר (Create contact) עם ערוץ (Channel) המוגדר כ-אימייל (Email) הופך את הכתובת שהשאיר המבקר לאיש קשר באימייל בערוץ האימייל המחובר שלך, ושלב שליחת הודעה (Send message) המופיע אחריו נשלח כאימייל; תשובות יחזרו לתוך צ’אטים (Chats) עבור סוכן האימייל שלך. המתכון המלא, כולל כיצד לעצור את הרצף ברגע שהם מציינים שביצעו הזמנה, נמצא באוטומציות ← דוגמה: אימיילים למעקב אחר לידים מצ’אט באתר.

האם סוכן ה-AI יכול להציע את המעבר לוואטסאפ בעצמו? כן, ואין צורך בתכונה נוספת — שורה אחת בהוראות הסוכן עושה זאת. צור קישור מקוצר למספר הוואטסאפ שלך עם הודעה מוכנה מראש כגון “היי, התכתבתי באתר שלכם ואני רוצה להמשיך כאן”, ולאחר מכן אמור לסוכן מתי לשלוח אותו, לדוגמה: “אם המבקר צריך לעזוב, רוצה להמשיך מאוחר יותר, או מבקש וואטסאפ, הצע להמשיך שם ושלח קישור זה: (הקישור המקוצר שלך)”. קישורים בווידג’ט ניתנים להקשה, כך שהמבקר מגיע לוואטסאפ עם המספר שלך שנבחר וההודעה מוקלדת מראש, וההודעה הראשונה שלו פותחת שיחת וואטסאפ בתיבת הנכנס שלך. אם המבקר השאיר את מספר הטלפון שממנו הוא כותב (עם קידומת מדינה) בטופס הווידג’ט, Your AI Connector מקשרת בין שתי השיחות באופן אוטומטי וה-AI בוואטסאפ כבר מכיר את צ’אט האתר, בדיוק כמו ב-המשך בוואטסאפ. אם לא נאסף מספר טלפון, שתי השיחות לא יקושרו, לכן שמור על הודעה מוכנה מראש ספציפית מספיק כדי שסוכן הוואטסאפ ידע מאיפה האדם הגיע.

• דרוש אישור מדיניות פרטיות: ניתן לדרוש מהמבקרים לאשר את מדיניות הפרטיות שלך לפני הצ’אט, ולהגדיר את כתובת ה-URL שאליה היא מפנה.

מה הווידג’ט מאחסן בדפדפן של המבקר, והאם עליי להציב אותו מאחורי באנר עוגיות? שום דבר לא מאוחסן רק מעצם טעינת הדף. הווידג’ט אינו כותב עוגיות ואינו משתמש באחסון דפדפן עד שהמבקר בוחר לשוחח: שולח הודעה ראשונה, ממלא את טופס פרטי המבקר, או מאשר את מדיניות הפרטיות שלך. מרגע זה הוא שומר מזהה שיחה אקראי והעתק של השיחה באותו דפדפן, כאחסון צד-ראשון בדומיין שלך, כך שהצ’אט עדיין יהיה שם כשהם יחזרו. הוא אינו טוען סקריפטים של ניתוח נתונים או מעקב ואינו מגדיר עוגיות צד-שלישי. מכיוון שלא נכתב דבר עד שהמבקר מבקש לשוחח, הדבר נופל תחת הגדרת אחסון הנחוץ בהחלט עבור שירות שהמבקר ביקש, כך שניתן לטעון אותו ללא צורך בחסימתו מאחורי באנר הסכמה. אם האתר שלך משתמש בכלי הסכמה בכל מקרה, זה בסדר גמור להשאיר את הווידג’ט מאחוריו; הצ’אט פשוט יופיע ברגע שהמבקר ייתן את הסכמתו.

ערוצים והטמעה #

• כפתור צירוף קבצים: מאפשר למבקרים לשלוח תמונות וקבצים בצ’אט.
• בורר אימוג’י: מוסיף בורר אימוג’י לצד תיבת ההודעות.
• קישורי ערוצים: ניתן לכלול קישורים ל-WhatsApp, Instagram או Messenger כדי שמבקרים יוכלו להמשיך את השיחה בפלטפורמה המועדפת עליהם. אפשרות זו מופיעה רק לאחר חיבור מספר WhatsApp (WhatsApp Business או WhatsApp Web), חשבון Instagram או Messenger. הפעלת קישור ה-WhatsApp תמלא אוטומטית את המספר המחובר; הקישור נשאר ניתן לעריכה, כך שאחרי החלפת מספרים תוכל להקליד את המספר החדש.
• כפתורי פעולה: שורת קיצורי דרך בחלק העליון של הצ’אט שמובילים את המבקר ליעד מסוים במקום לשיחה — ראה כפתורי פעולה להלן.
• רשימה לבנה של דומיינים: הגבל אילו אתרים רשאים להטמיע את הווידג’ט שלך. הוסף את הדומיינים שבהם התקנת אותו (למשל example.com או *.example.com); השאר ריק כדי לאפשר לכל דומיין.
• מדינות חסומות: מנע מהווידג’ט להופיע בפני מבקרים ממדינות שאינך משרת. מבקרים שמיקומם ברשת הוא במדינה שתבחר לעולם לא יראו את הווידג’ט, וכל ניסיון שלהם להתחיל צ’אט יידחה. השאר ריק כדי לאפשר לכולם. ראה מניעת בוטים וניצול קרדיט להלן.
• ניתוב צ’אטים אלו אל: בחר את הנציג שיטפל בצ’אטים המגיעים מהקוד שאתה עומד להעתיק. השאר על ברירת מחדל של החשבון כדי להשתמש בניתוב הרגיל של ווידג’ט הצ’אט שלך. ראה שליחת דפים שונים לנציגים שונים להלן.
• קטע הטמעה: בחר בועה צפה או מוטבע והעתק את קוד ההתקנה (ראה להלן).
• קישור הדגמה ללקוח: הדבק כל כתובת אתר ולחץ על צור קישור כדי לקבל קישור שניתן לשיתוף, הפותח את האתר עם הווידג’ט שלך פועל מעליו, ללא צורך בהתקנה מצדם. כל קישור שתיצור יופיע ברשימה, ותוכל לכבות כל אחד מהם. ראה הצגת הווידג’ט באתר של מישהו אחר להלן.
• קישור לשיתוף: קישור מוכן שפותח את העוזר שלך בדף נפרד, במסך מלא, ללא צורך באתר אינטרנט. העתק אותו ושלח אותו לכל מקום. ראה שיתוף קישור ישיר לצ’אט להלן.

בתחתית הלוח, פעולת מחיקת ווידג’ט צ’אט מסירה את הווידג’ט מהאתר שלך באופן מיידי — לא ניתן לבטל פעולה זו, והמבקרים לא יראו יותר את בועת הצ’אט.

כפתורי פעולה #

חלק מהמבקרים לא רוצים לשוחח בצ’אט. הם רוצים את מספר הטלפון, הכתובת או האימייל שלכם, והם רוצים את זה בלחיצה אחת. כפתורי פעולה הם שורת קיצורי דרך בחלק העליון של לוח הצ’אט בדיוק למטרה זו.

ניתן להוסיף עד שישה כפתורים. לכל אחד יש תווית (המילים שעל הכפתור) ויעד, והיעד תלוי בפעולה שתבחרו:

כפתורים אלו אינם משתמשים בקרדיטים. לחיצה על אחד מהם לא שולחת הודעה ולא מתחילה שיחה — היא פשוט לוקחת את המבקר לאן שביקש להגיע. רק שיחה ממשית עם סוכן ה-AI שלכם משתמשת בקרדיטים, בדיוק כפי שהיה קודם.

כמה דברים שכדאי לדעת:

• הכפתורים נשארים גלויים בזמן שהמבקר משוחח. מישהו יכול לשאול שתי שאלות ועדיין ללחוץ על הוראות הגעה לאחר מכן מבלי לרענן את הדף.
• התוויות שלכם מוצגות בדיוק כפי שכתבתם אותן. בניגוד להודעת הפתיחה ושאלות הפתיחה שלכם, תוויות הכפתורים אינן מתורגמות אוטומטית, לכן אם אתם משרתים מבקרים בכמה שפות, שמרו על התוויות קצרות וברורות (או כתבו אותן בשפה העיקרית שלכם).
• מלאו את הכפתור כראוי אחרת הוא לא יישמר. אם מספר טלפון, כתובת אימייל או קישור אינם תקינים, הלוח יציין זאת ויחסום את שמירת שינויים במקום לפרסם כפתור שלא יבצע שום פעולה באתר שלכם.
• הם אינם תשובות לשאלות נפוצות. כפתורי פעולה רק שולחים אנשים למקום אחר; הם לא משיבים בטקסט מוכן מראש. שאלות הן התפקיד של סוכן ה-AI שלכם, והוא עונה עליהן מתוך בסיס הידע שלכם. אם ברצונכם להציע מה לשאול, השתמשו בשאלות פתיחה תחת ‘מראה’ (Appearance).

מה לא ניתן להתאים אישית #

לוח הניהול (Manage) מכיל את כל מכלול האפשרויות. באופן ספציפי:

• ללא CSS או גיליון סגנונות מותאם אישית. העיצוב הוא מה שמציעים בוררי הערכות, הפינות, הגופנים והצבעים — לא ניתן להזריק CSS משלך לווידג’ט, וכללים בדף שלך לא יחולו בתוכו.
• ללא טקסט מציין מיקום מותאם אישית בתיבת ההודעות.
• ללא הטמעת וידאו בתוך הצ’אט.

אם אחד מאלה מהווה חסם עבורך, ה-הטמעה מוטבעת (inline embed) מעניקה לך את מירב השליטה: הווידג’ט יושב בתוך מכולה (container) בדף שלך, שאת גודלה ומיקומה אתה קובע בעצמך.

מניעת בוטים וניצול קרדיטים #

כל תשובה של ה-AI עולה קרדיטים, לכן סקריפט (או אדם אחד משועמם) שפותח צ’אט אחר צ’אט באתר שלכם הוא הדבר היחיד שווידג’ט ציבורי צריך להתגונן מפניו. הווידג’ט מטפל ברוב המקרים בעצמו, ושתי הגדרות בלוח הניהול מאפשרות לכם להדק את ההגנה עבור האתר שלכם.

• רשימה לבנה של דומיינים. רק אתרים שתציין יוכלו להציג את הווידג’ט. כל מי שיעתיק את קוד ההטמעה שלך לאתר אחר לא יראה דבר.
• מדינות חסומות. מבקרים שמיקום הרשת שלהם נמצא במדינה שחסמת לעולם לא יראו את הווידג’ט, וצ’אט שהם ינסו להתחיל בכל זאת יידחה. המיקום נקבע לפי החיבור של המבקר: מי שמשתמש ב-VPN יזוהה לפי המדינה של ה-VPN, ומבקר שלא ניתן לקבוע את מיקומו יורשה להיכנס במקום להיחסם. התצוגה המקדימה שלך בתוך האפליקציה תמשיך לעבוד גם אם תחסום את המדינה שבה אתה נמצא.
• שיחות חדשות לחיבור. חיבור אחד (בפועל, כתובת של משק בית או משרד אחד) יכול לפתוח 20 שיחות חדשות ביום בווידג’ט. מבקרים חוזרים שממשיכים צ’אט קיים לא נספרים, רק שיחות חדשות לגמרי, כך שסקריפט שממשיך לפתוח צ’אטים חדשים כדי “לצבור” תשובות AI ייעצר לאחר 20, בעוד שמבקרים אמיתיים לעולם לא ירגישו בכך. אם אנשים רבים חולקים חיבור אחד באתר שלך (קמפוס, מוקד טלפוני), הגדל את המספר דרך ה-REST API עם max_new_chats_per_ip_daily; 0 מכבה את הבדיקה.
• בדיקת אנושיות (אופציונלי). מבקרים עוברים בדיקת Cloudflare Turnstile מהירה לפני שההודעה הראשונה שלהם נשלחת, כך שסקריפט לא יכול להתחיל צ’אטים כלל. רוב האנשים לעולם לא יצטרכו ללחוץ על דבר; Cloudflare מציגה תיבת סימון רק כשהיא אינה בטוחה. היא משתמשת במפתחות ה-Turnstile החינמיים שלך, ראה הוספת בדיקת אנושיות להלן.
• מגבלות מובנות. בנוסף לכך, לכל סשן דפדפן יש מכסה של מספר הודעות שניתן לשלוח לדקה וליום, והסוכן שעונה לצ’אט מפסיק להשיב למבקר ברגע שהוא מגיע ל-Max AI messages per chat שהוגדר תחת Response limits.

שום דבר מזה לא מזהה מכשירים או אנשים: הווידג’ט לא מאחסן דבר בדפדפן של המבקר עד שהם בוחרים להתחיל צ’אט (ראו לעיל), ואין שום שימוש בטביעת אצבע דיגיטלית (fingerprinting).

הוספת בדיקת אנושיות (Cloudflare Turnstile) #

הפעל אפשרות זו כאשר בוטים ממשיכים לפתוח צ’אטים באתר שלך וההגדרות לעיל אינן מספיקות. הבדיקה רצה פעם אחת, ממש לפני שההודעה הראשונה של המבקר נשלחת. מבקר שעובר את הבדיקה יכול להמשיך בצ’אט במשך 24 שעות מבלי לראות אותה שוב, וכל מי שחוזר לשיחה קודמת עדיין יכול לקרוא אותה לפני הבדיקה.

1. היכנס לחשבון ה-Cloudflare שלך (חשבון חינמי מספיק) ופתח את Turnstile.
2. לחץ על Add widget, תן לו שם, והוסף כל דומיין שבו פועל ווידג’ט הצ’אט שלך (לדוגמה yourshop.com). השאר את מצב הווידג’ט על Managed.
3. העתק את ה-Site key ואת ה-Secret key ש-Cloudflare מציגה לך.
4. באפליקציה, פתח את לוח ה-Manage של ווידג’ט הצ’אט שלך, הפעל את Human check before chatting, הדבק את שני המפתחות ושמור.

למה לצפות:

• הבדיקה נשארת כבויה עד ששני המפתחות מוזנים, כך שהפעלתה ללא מפתחות לעולם לא תחסום מבקרים.
• אם מבקר נכשל בבדיקה, או משאיר אותה ללא פתרון, ההודעה שלו לא נשלחת והוא מקבל כפתור Retry.
• הבדיקה מופיעה רק בדומיינים שהוספת ב-Cloudflare. בכל דומיין אחר Cloudflare תחסום אותה ואף אחד באתר זה לא יוכל לשלוח הודעה, לכן הוסף כל דומיין לפני שתפעיל אותה.
• אם האתר שלך משתמש ב-Content Security Policy, אפשר את https://challenges.cloudflare.com עבור סקריפטים ומסגרות (frames), אחרת הבדיקה לא תוכל להיטען.
• המפתחות שייכים לחשבון ה-Cloudflare שלך, וה-secret key לעולם לא נשלח לדפדפנים של המבקרים שלך.

הוראות התקנה #

כדי להוסיף את ווידג’ט הצ’אט לאתר שלך, הוסף שורת קוד אחת ל-HTML של האתר.

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

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

4. החלף את CONFIG_ID במזהה התצורה הייחודי שלך, המופיע במקטע ערוצים והטמעה (Channels & Embed) בלוח הניהול. מזהה זה ספציפי לחשבון שלך ומחבר את הווידג’ט למערכת ההודעות שלך.

הקטע לא יאט את האתר שלך: מדובר בטוען זעיר, והווידג’ט עצמו יורד ברקע מבלי לחסום את הדף. אם בכל זאת תרצה שהווידג’ט ימתין עד לסיום טעינת הדף במלואו, תוכל לעטוף את אותו ה-URL כך במקום:

<script>
window.addEventListener('load', function () {
  var s = document.createElement('script');
  s.src = 'https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID';
  s.async = true;
  document.body.appendChild(s);
});
</script>

ואם מה שברצונך לעכב הוא בועית ההזמנה הקטנה ולא טעינת הווידג’ט, ניתן להשתמש בעיכוב של בועת הקופץ היזום (Proactive popup bubble) בסעיף ‘התנהגות’ שלעיל — אין צורך בקוד.

התקנה ב-Shopify #

1. בלוח הבקרה של Shopify, עבור אל חנות מקוונת > ערכות נושא (Online Store > Themes).
2. בערכת הנושא המסומנת כערכת הנושא הנוכחית (המפורסמת) שלך, לחץ על כפתור ה-… ובחר ב-ערוך קוד (Edit code). עריכת טיוטה או עותק של ערכת הנושא לא משנה דבר בחנות הפעילה שלך.
3. פתח את layout/theme.liquid וגלול לתגית הסוגרת </body> ליד החלק התחתון.
4. הדבק את שורת ההתקנה שלך ממש מעל </body> ולחץ על שמור (Save):

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

אם התקנת את הווידג’ט לפני ששורת ההתקנה כללה את defer, עורך הקוד של Shopify יציג קו תחתון אדום מתחתיה. קו תחתון זה הוא אזהרה מבודק הקוד של Shopify לגבי שורות סקריפט ללא defer או async, ולא שגיאה: ערכת הנושא עדיין נשמרת והווידג’ט עדיין עובד. הוספת defer כפי שמוצג לעיל תעלים את הקו התחתון ולא תשנה דבר באופן שבו הווידג’ט פועל, לכן אין צורך בהתקנה מחדש באתרים אחרים.

הנה דוגמה מלאה לאיך קובץ ה-HTML שלכם אמור להיראות עם יישומון הצ’אט מוטמע:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <!-- Your existing website content would be here -->

    <!-- Chat Widget Integration -->
    <script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>
</body>
</html>

הטמעה מוטבעת בדף (מתקדם) #

אם ברצונך שהצ’אט יופיע כחלק מהדף שלך — למשל בתוך מקטע ייעודי של “צור קשר”, לשונית עזרה או סרגל צד — במקום כבועה צפה בפינה, העבר את קטע הטמעה (Embed snippet) למצב מוטבע (Inline) בלוח הניהול והעתק את קטע הקוד המוטבע.

זה נראה כך:

<div data-chat-widget="CONFIG_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

ה-<div> הוא נקודת העיגון — לוח הצ’אט מרונדר בתוכו וממלא את ממדיו. עצבו את ה-div כרצונכם (הגדירו לו גובה קבוע, הניחו אותו בתוך קונטיינר flex, מקמו אותו בתא בתוך grid וכו’) ולוח הצ’אט יתאים את עצמו.

אתם זקוקים רק לתג <script> אחד בדף, גם אם אתם מטמיעים מספר ווידג’טים של צ’אט. הסקריפט סורק את הדף עבור כל <div data-chat-widget="…"> ומעגן לוח צ’אט בכל אחד מהם.

מתי לבחור בהטמעה מוטבעת (inline) לעומת צפה (floating):

• בועת צ’אט צפה מתאימה לכפתור “צריך עזרה?” שזמין תמיד בכל האתר.
• הטמעה מוטבעת מתאימה כאשר הצ’אט אמור להיות במקום ספציפי — דף תמיכה, סרגל צד של מאגר ידע, לשונית עזרה בתוך אפליקציה — ולהרגיש כחלק טבעי מאותו דף.

ההטמעה המוטבעת עושה שימוש חוזר באותה תצורה של הבועה הצפה (לוגו, הודעת פתיחה, איסוף לידים, שאלות פתיחה וכן הלאה), כך שאין צורך להגדיר דבר פעמיים.

הצגת הווידג’ט באתר של מישהו אחר #

באפשרותך להציג את ווידג’ט הצ’אט שלך פועל באתר שאינו בשליטתך — ללא צורך בקוד וללא צורך בגישה לאתר שלהם. זו הדרך המהירה ביותר להראות ללקוח פוטנציאלי איך העוזר ייראה בדפים שלו.

1. פתח את לוח הניהול וגלול אל ערוצים והטמעה (Channels & Embed).
2. בשדה קישור להדגמת לקוח (Client demo link), הקלד את כתובת האתר (לדוגמה www.theircompany.com).
3. אופציונלי: תחת השדה, בחר את הסוכן (Agent) שאמור להשיב בהדגמה זו, למשל סוכן שבנית מתוך האתר של הלקוח הפוטנציאלי כדי שידבר על השירותים, המחירים והשאלות הנפוצות שלו. השאר על ברירת מחדל של החשבון (Account default) כדי להשתמש בניתוב הרגיל של ווידג’ט הצ’אט שלך.
4. לחץ על צור קישור (Create link). הקישור יועתק עבורך ויופיע ברשימה שמתחת לשדה, עם כפתורי העתק (Copy) ו-פתח (Open) והסוכן שבו הוא משתמש.
5. שלח את הקישור לכל מי שברצונך להציג לו אותו.

פתיחת הקישור טוענת את אתר האינטרנט ההוא עם ווידג’ט הצ’אט שלך צף מעליו, בדיוק כפי שהיה נראה אילו היה מותקן. כל מי שיש לו את הקישור יכול לפתוח אותו — אין צורך להתחבר לשום מקום.

כמה דברים שכדאי לדעת:

• צ’אטים מההדגמה הם אמיתיים. הודעות שמבקר שולח בהדגמה מגיעות לתיבת הדואר הנכנס שלך ונענות על ידי הסוכן שלך, והן משתמשות בקרדיטים כמו כל שיחה אחרת.
• הדף ללא מיתוג. הוא מציג את האתר שלהם ואת הווידג’ט שלך, ולא שום דבר אחר.
• חלק מהאתרים לא ניתנים להטמעה במסגרת (Frame). מספר אתרים (בנקים, קמעונאים גדולים, כל דבר תחת הגדרות אבטחה מחמירות) חוסמים דפים אחרים מלהציג אותם. כשזה קורה, הקישור עדיין עובד: הוא מציג חלון דפדפן דמה ניטרלי במקום האתר האמיתי, עם הווידג’ט שלך פעיל מעליו כך שההדגמה עדיין מבצעת את תפקידה.
• זה לא משנה את האתר שלהם. שום דבר לא מותקן ושום דבר לא משתנה — ההדגמה קיימת רק בתוך הקישור הזה.
• כבה קישור כשההדגמה מסתיימת. לחץ על כבה לצד הקישור ברשימה ואשר. מרגע זה ואילך, כל מי שיפתח אותו יראה דף שאומר שהקישור כובה. הווידג’ט שלך ושאר קישורי ההדגמה שלך ימשיכו לעבוד. לא ניתן להפעיל מחדש קישור שכובה; צור אחד חדש במקומו.
• קישורים שהועתקו לפני ה-25 בספטמבר 2026. קישורי הדגמה שנוצרו לפני שהרשימה הייתה קיימת אינם מופיעים בה. הם ימשיכו לעבוד עד שתלחץ על כבה אותם מתחת לרשימה, מה שיכבה את כולם בבת אחת (ו-הפעל אותם מחדש יהפוך את הפעולה).

קישור הדגמה שנוצר ללא סוכן משתמש בניתוב ברירת המחדל של החשבון שלך, ללא קשר למה שמוגדר ב-ניתוב צ’אטים אלו אל. כאשר נבחר סוכן, כל צ’אט מקישור זה מוקצה לאותו סוכן ונענה על ידו. הווידג’ט שומר על המראה, השם והודעת הפתיחה שלו. הקישור נושא זאת כ-&agent=AGENT_ID; הוספת זה לקישור ישן יותר באופן ידני עובדת גם היא (השתמש ב-&, לא ב-?, מכיוון שהקישור כבר מכיל ?).

אם תמחק מאוחר יותר את הסוכן שבו משתמש קישור הדגמה, הקישור ימשיך לעבוד: הצ’אטים שלו יעברו לניתוב ברירת המחדל של החשבון שלך במקום זאת, והרשימה תציג “סוכן שנמחק, משתמש בברירת המחדל” לצדו. מחיקת הסוכן המוגדר כברירת המחדל של ווידג’ט הצ’אט שלך אינה משפיעה על קישורים המוצמדים לסוכן אחר.

שיתוף קישור ישיר לצ’אט #

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

1. פתחו את לוח הניהול וגללו אל ערוצים והטמעה.
2. מצאו את קישור לשיתוף (הוא נמצא ממש מתחת לקישור ההדגמה ללקוח).
3. לחצו על העתק כדי לקחת את הקישור, או על פתח כדי לנסות אותו בעצמכם.

פתיחתו מציגה רק את העוזר שלכם, על פני כל המסך — ללא אתר אינטרנט מאחוריו, ללא בועה ללחיצה תחילה, וללא צורך בהתקנה. שימו אותו בביוגרפיה של ה-Instagram, בקוד QR על פלייר, בחתימת אימייל או בהודעת WhatsApp ללקוח פוטנציאלי.

קישור השיתוף עוקב אחר ניתוב ברירת המחדל של ווידג’ט הצ’אט שלך. כדי לפתוח סוכן ספציפי במקום זאת, הוסף ?agent=AGENT_ID לסוף הקישור; כל צ’אט ממנו יוקצה לאחר מכן לאותו סוכן וייענה על ידו, בעוד שהדף שומר על השם והודעת הפתיחה של הווידג’ט שלך.

כמה דברים שכדאי לדעת:

• צ’אטים מהקישור הם אמיתיים. הם מגיעים לתיבת הדואר הנכנס שלכם, הנציג שלכם עונה עליהם, והם משתמשים בקרדיטים כמו כל שיחה אחרת.
• הדף אינו נושא מיתוג שלנו. הוא מציג את העוזר שלכם ותו לא, והוא מוסתר מתוצאות חיפוש.
• זה עובד על הכתובת שלכם. אם הספק שלכם מריץ את האפליקציה על הדומיין שלו, הקישור משתמש גם בכתובת הזו, כך שלא מופיע בו שום דבר לא מוכר.
• מבקר אחד לקישור, לכל דפדפן. מי שפותח אותו שומר על אותה זהות באותו דפדפן, כך שחזרה מאוחר יותר תמשיך את אותה שיחה במקום להתחיל שיחה של זר. דפדפן אחר, או קישור של ווידג’ט אחר, נחשבים למבקר שונה.

שליחת דפים שונים לסוכנים שונים #

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

ישנן שתי דרכים להשיג את הקוד:

• מהסוכן. בדף סוכני AI, לחצו על כפתור ה-</> בשורה, או פתחו את הסוכן ועברו ללשונית נקודות כניסה (Entry Points). כך או כך, תקבלו קוד מוכן להדבקה שכבר מוגדר לעבוד עם אותו סוכן.

  בלשונית נקודות כניסה של סוכן יש גם לוח ווידג’ט צ’אט לאתר המציג כמה צ’אטים באתר הסוכן כבר מנהל. צ’אטים מהטמעה (embed) מגיעים ישירות לסוכן, לכן אין צורך ליצור עבורם כלל נקודת כניסה — סוכן ללא כללים כלל עדיין יענה להטמעה שלו.

  כפתור ה-</> מופיע רק עבור סוכנים פעילים. סוכן מושהה יקבל את הצ’אט אך לעולם לא ישיב, לכן האפשרות מוסתרת עד שתפעילו אותו מחדש. אין ערוץ להגדרה עבור סוכן — סוכן יכול לקבל צ’אט מכל ערוץ.

• מהגדרות הווידג’ט. ב-הגדרות ← ערוצים ← ניהול בווידג’ט הצ’אט שלכם, הגדירו את ניתוב צ’אטים אלו אל והעתיקו את הקוד שמתחתיו. שינוי התפריט הנפתח משכתב את הקוד.

קטע הקוד הצף נושא את היעד בכתובת:

<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID?agent=AGENT_ID" defer></script>

קטע הקוד המוטבע נושא אותו ב-<div> במקום זאת, כך שדף אחד יכול להכיל מספר צ’אטים המופנים למקומות שונים:

<div data-chat-widget="CONFIG_ID" data-agent="AGENT_ID" style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

קודים שהועתקו לפני שקמפיינים הוצאו משימוש מכילים ?campaign= או data-campaign= במקום. הם ממשיכים לעבוד, כך שאין צורך להעתיק אותם מחדש.

כמה דברים שכדאי לדעת:

• השתמשו בכפתור ההעתקה במקום להקליד את המזהה (ID) ידנית. אם המזהה אינו תואם לסוכן בחשבונכם, הצ’אט עדיין יעבוד אך יחזור לניתוב ברירת המחדל שלכם.
• מי שכבר נמצא באמצע שיחה יישאר עם הסוכן שאיתו התחיל, גם אם מאוחר יותר יגיע לדף שמפנה למקום אחר. זה מונע מהשיחה לשנות את אופייה באמצע.
• יעד ספציפי לדף מקבל עדיפות על פני ברירת המחדל של החשבון ועל פני הפעלת מילות מפתח.

אמרו לווידג’ט מי הוא המבקר (מתקדם) #

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

הוסיפו בלוק הגדרות קטן לפני הסקריפט של הווידג’ט:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      name: "Maria",
      email: "maria@example.com",
      phone: "+391234567890"
    },
    data: {
      plan: "Professional",
      customer_since: "2024",
      last_order: "A-2291"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

הדף שלכם אמור למלא את הערכים האלה בצד השרת, מתוך מי שמחובר כרגע.

כדי לשמור גם שם משפחה, הוסף את last_name לצד name בבלוק visitor (data-visitor-last-name בהטמעה מוטבעת). זה אופציונלי: שם ואימייל עדיין מספיקים כדי לדלג על הטופס, ללא קשר לשאלה אם איסוף שם משפחה מופעל או לא.

שני דברים קורים:

• טופס ה-“לפני שנתחיל…” מדלג. עם שם ואימייל שסופקו, המבקר עובר ישירות לשיחה, והפרטים האלה נשמרים באיש הקשר שלו בדיוק כאילו הוא הקליד אותם בעצמו.
• כל מה שנמצא תחת data מועבר ל-AI שלכם. כל דבר שתשימו שם — תוכנית, מספר הזמנה, תאריך חידוש, יתרת אשראי, כמה מושבים יש להם — הופך לחלק ממה שה-AI יודע על אותו אדם, כך שהוא יכול לענות על “מתי התוכנית שלי מתחדשת?” מבלי לבקש מהם להסביר מי הם קודם לכן. השתמשו בכל שמות שדות שנראים לכם הגיוניים; הם יופיעו באיש הקשר תחת שדות מותאמים אישית (Custom Fields). עד 20 ערכים, שנשלחים מחדש עם כל הודעה, כך שאם התוכנית משתנה באמצע השיחה, ה-AI יראה את הערך החדש.

עבור הטמעות מוטבעות (inline embeds), אתם יכולים לשים את אותו מידע על ה-<div> במקום זאת, מה ששימושי כאשר דף אחד מכיל מספר צ’אטים:

<div data-chat-widget="CONFIG_ID"
     data-visitor-name="Maria"
     data-visitor-email="maria@example.com"
     data-visitor-data='{"plan":"Professional"}'
     style="width:100%;height:600px;"></div>
<script src="https://api.youraiconnector.com/v1/chat-widget/embed.js" async></script>

אם האתר שלכם יודע מי המבקר רק לאחר טעינת הדף — למשל באפליקציית דף יחיד (SPA) שבה ההתחברות מתבצעת ללא רענון דף — קראו לפונקציה הזו בכל פעם שיש לכם את הפרטים, והווידג’ט יעדכן את עצמו:

<script>
  window.chatWidget.setVisitor({
    visitor: { id: "12345", name: "Maria", email: "maria@example.com" },
    data: { plan: "Professional" }
  });
</script>

כמה דברים שכדאי לדעת:

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

המשך את אותה שיחה בכל מכשיר (מזהה מבקר מחובר) #

אם ללקוחות שלך יש חשבונות, באפשרותך לגרום לצ’אט שלהם לעקוב אחריהם: התחברות בטלפון, המשך במחשב נייד, וזו תהיה אותה שיחה עם אותו איש קשר בתיבת הדואר הנכנס שלך, והבינה המלאכותית עדיין תדע את כל מה שנאמר. לשם כך, Your AI Connector זקוק להוכחה שהמבקר הוא אכן מי שהדף שלך טוען שהוא, אחרת כל אחד יוכל להקליד מספר לקוח בדפדפן שלו ולקרוא את הצ’אט של אותו לקוח. ההוכחה היא חתימה שאתה מחשב בשרת שלך.

1. בלוח ה-Manage של הווידג’ט, תחת Channels & Embed, מצא את Signed-in visitors ולחץ על Generate secret. העתק את ה-identity secret. שמור אותו בשרת שלך בלבד; לעולם אל תכניס אותו לדף עצמו.

2. כאשר השרת שלך מרנדר דף עבור לקוח מחובר, חשב HMAC-SHA256 של ה-ID של אותו לקוח באמצעות הסוד, כמחרוזת hex באותיות קטנות:

// Node.js
const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex");

// PHP
$hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET);

# Python
import hmac, hashlib
hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest()

3. שים את המזהה ואת ה-hash בבלוק ההגדרות, לצד השם והאימייל שאתה כבר מעביר:

<script>
  window.chatWidgetSettings = {
    visitor: {
      id: "12345",
      hash: "3f2a…e91c",
      name: "Maria",
      email: "maria@example.com"
    }
  };
</script>
<script src="https://api.youraiconnector.com/v1/chat-widget/CONFIG_ID" defer></script>

ה-inline embed מקבל את אותו ערך כמו data-visitor-hash ב-<div>, ו-window.chatWidget.setVisitor({ visitor: { id, hash } }) עובד עבור אפליקציות שמחברות אנשים ללא רענון דף.

מה קורה ברגע שהחתימה מאומתת:

• הצ’אט של הלקוח נשמר תחת החשבון שלו במקום תחת הדפדפן, כך שזו אותה שיחה בכל מכשיר ובכל דפדפן שבו הוא מחובר, ואיש קשר אחד בתיבת הדואר הנכנס שלך.
• ההודעות הקודמות שלו נטענות במכשיר החדש, והבינה המלאכותית ממשיכה מהמקום שבו הפסיקו.
• אם החתימה שגויה, הווידג’ט מתנהג בשקט כפי שהתנהג קודם, כצ’אט רגיל לפי דפדפן, ומדפיס את הסיבה בקונסולת הדפדפן כדי שמפתח יוכל לזהות זאת. המבקרים שלך לעולם לא יראו שגיאה.
• המזהה מושווה בדיוק כפי ששלחת אותו, לכן חתום על אותו ערך שאתה מעביר כ-id, והשתמש באותו מזהה עבור אותו אדם בכל מקום.

שני דברים שכדאי לדעת:

• Regenerate בלוח ה-Manage נותן לך secret חדש. דפים שעדיין חותמים עם הישן יחזרו לצ’אטים רגילים לפי דפדפן עד שהשרת שלך ישתמש ב-secret החדש. שיחות קיימות נשמרות; הן קשורות למזהה הלקוח, לא ל-secret.
• שיחה שמישהו ניהל לפני ההתחברות, כמבקר אנונימי, נשארת צ’אט נפרד. השיחה מבוססת-החשבון מתחילה עם ההודעה הראשונה שהם שולחים בזמן שהם מחוברים.

שינוי הגדרות הווידג’ט מהקוד שלך (API) #

ניתן לשנות את כל מה שמופיע בלוח ה-ניהול (Manage) של הווידג’ט גם באמצעות ה-REST API, דבר שימושי אם אתה מנהל אתרים רבים או רוצה לכבות את כפתור הצירוף באופן אוטומטי עבור לקוח. שלח PATCH אל https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID עם מפתח ה-API שלך ורק את השדות שברצונך לשנות — לדוגמה, {"show_upload_button": false} מסתיר את כפתור הצירוף, {"show_emoji_button": false} מסתיר את בורר האימוג’י, ו-{"launcher_icon": "chat-dots"} מחליף את סמל המפעיל. CONFIG_ID הוא אותו מזהה שמופיע בסקריפט ההטמעה שלך. הרשימה המלאה של השדות המקובלים (שם, הודעת פתיחה, צבעים, סמל מפעיל, דומיינים מורשים, טופס פרטי מבקר, הודעת פרטיות, ערכת נושא, סגנון פינה וגופן) נמצאת ב-מדריך ה-API תחת ווידג’ט צ’אט (Chat Widget). אתרים יעדכנו את השינוי בטעינת הדף הבאה.

למה לצפות לאחר ההתקנה #

לאחר שתוסיף את הסקריפט לאתר שלך, ווידג’ט הצ’אט ייצור באופן אוטומטי כפתור צ’אט בפינת האתר שלך (כברירת מחדל בפינה הימנית התחתונה). הווידג’ט נשאר במיקום קבוע בזמן שהמשתמשים גוללים בדפים שלך, מה שמבטיח שהוא תמיד נגיש.

כאשר מבקרים לוחצים על כפתור זה, הוא מתרחב לחלון צ’אט מלא שבו הם יכולים להתחיל שיחה, תוך הצגת הודעת הפתיחה שלך. אם Collect visitor info (איסוף פרטי מבקר) מופעל, יופיע תחילה טופס קטן המבקש את שמם והאימייל שלהם (ואופציונלית טלפון) לפני שהם יוכלו להקליד.

ממשק הצ’אט מתאים את עצמו אוטומטית לגדלי מסך שונים, כך שהוא עובד בצורה חלקה גם במחשבים שולחניים וגם במכשירים ניידים.

בדיקת ההטמעה שלכם #

לאחר הוספת הווידג’ט לאתר שלך, בדוק שהוא עובד:

1. פתח את האתר שלך בדפדפן.
2. לחץ על כפתור הצ’אט כדי לפתוח את הווידג’ט.
3. שלח הודעת בדיקה וודא שאתה מקבל תשובה.
4. חזור על הפעולה במכשיר או בדפדפן אחר כדי לוודא שהוא עובד בכל מקום.

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

1. ודא שהחלפת את CONFIG_ID במזהה התצורה האמיתי שלך.
2. ודא שתגית הסקריפט ממוקמת לפני תגית הסגירה </body>.
3. בדוק את הקוד עבור שגיאות הקלדה.
4. ב-Shopify, ודא שערכת את ערכת הנושא המפורסמת ולחצת על שמור (Save). עריכה שבוצעה בטיוטה או בערכת נושא משוכפלת לעולם לא תגיע לחנות הפעילה שלך.

מאחורי חומת אש ארגונית #

אם הווידג’ט נטען עבור הציבור אך לא עבור הצוות ברשת המשרדית, כמעט בוודאות שהרשת חוסמת את הדומיין שממנו הוא נטען. בקש מצוות ה-IT שלך לאפשר, באמצעות HTTPS רגיל בפורט 443:

• הדומיין בקטע הקוד להטמעה שלך — הכתובת בשורת ה-<script src="..."> שהעתקת מלוח הניהול.
• api.youraiconnector.com — הווידג’ט שולח את הודעותיו גם לכאן.

אין צורך לפתוח שום דבר אחר: ללא פורטים נוספים וללא כללי כניסה (inbound rules). אם הווידג’ט עדיין לא מופיע לאחר מכן, פתח את מסוף המפתחים (developer console) בדפדפן שלך בעמוד הרלוונטי ושלח לנו את הדיווחים שמופיעים בו — בקשה חסומה מציינת את שם הדומיין שסורב, וזה בדרך כלל מספק את התשובה המלאה.