התקינו את הווידג'ט

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

1. העתיקו את קטע הקוד

בהגדרות ← וידג’ט, בחרו את האתר והעתיקו את קטע קוד ההתקנה. הוא נראה כך:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

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

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

2. הדביקו אותו לפני `</body>`

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

3. בדקו שזה עובד

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

זיהוי משתמשים מחוברים

אם המבקרים שלכם מתחברים למוצר שלכם, ספרו ל-RolChat מי הם כדי שהשיחות יקושרו לאיש הקשר הנכון:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

המאפיינים המתקבלים הם email, phone, first_name, last_name, external_id ואובייקט custom_fields שטוח; כל דבר אחר מתעלם ממנו. RolChat מחפש את האימייל ב-CRM. אם קיים איש קשר, הסשן מקושר אליו והנציג רואה את הפרופיל; אם לא, הפרטים נשמרים ונוצר ליד כשהמבקר כותב בפעם הראשונה.

לרמת אמון גבוהה יותר, השרת שלכם יכול לחתום על הזהות: העבירו את החתימה ש-RolChat מנפיק עבור המשתמש יחד עם המאפיינים, והסשן יקודם רק אם החתימה מאומתת. קראו ל-window.rolchat.reset() כשהמשתמש מתנתק, אחרת האדם הבא בדפדפן הזה יראה את השיחה הקודמת.

ה-JavaScript API

window.rolchat זמין ברגע שה-stub רץ; קריאות שמתבצעות לפני שהחבילה נטענת נכנסות לתור ומבוצעות לפי הסדר.

מתודה	מה היא עושה
`show()` / `hide()`	הצגה או הסתרה של כפתור ההפעלה
`open()` / `close()`	פתיחה או סגירה של חלונית הצ’אט
`identify(traits)`	קישור הסשן לאדם (למעלה)
`reset()`	שכחת הזהות והתחלת סשן אנונימי חדש
`pushEvent(name, props)`	דיווח על אירוע מותאם עבור הודעות טריגר ואוטומציה
`trackPageView(path?)`	דיווח על צפייה בעמוד באפליקציות עמוד יחיד
`setLocale(code)`	החלפת שפת הווידג’ט
`showConsentPreferences()`	פתיחת מרכז העדפות ההסכמה
`on(event, handler)` / `off(event, handler)`	הרשמה ל-`chat:opened`, `chat:closed`, `message:sent`, `message:received`, `session:started`

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

שפה וכיווניות

הווידג’ט מדבר בשפה שקבעתם עם lang ב-window.rolchatConfig (למשל "lang": "de"); בלעדיו הוא מדבר בשפת הדפדפן של המבקר, לפי סדר ההעדפות של הדפדפן, מתוך 40 השפות ש-RolChat תומך בהן; ואם אף שפה אינה מתאימה, באנגלית. הגדרת השפה של האתר עצמו אינה בשימוש: כדי שהווידג’ט ידבר בשפת האתר שלכם, הגדירו lang. ערבית ועברית מוצגות מימין לשמאל. הווידג’ט אינו מתרגם את הודעות הנציג; בצד הנציג אפשר להשתמש במקום זאת בתרגום חי מבוסס AI.

עוגיות והסכמה

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

איפה מגדירים את הווידג’ט

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