JavaScript API
מתודות גלובליות הזמינות לאחר טעינת סקריפט הווידג׳ט.
Respondo.init(config)#
מאתחל ומעגן את הווידג׳ט. חייב להיקרא פעם אחת. מחזיר את מופע הווידג׳ט.
const widget = Respondo.init({
agentId: 'YOUR_AGENT_ID'
});Respondo.identify(identity)#
מצרף זהות משתמש לסשן הנוכחי. קראו לאחר ההתחברות.
Respondo.identify({
email: 'user@example.com',
name: 'John Doe',
userId: 'usr_123',
userHash: 'hmac_sha256_signature', // אופציונלי, לאימות זהות
metadata: { plan: 'pro' },
properties: { // מאפייני איש קשר מותאמים
account_type: 'enterprise', // מפתחות מוגדרים ב-Agent Settings
region: 'eu-west'
}
});Respondo.track(name, properties?)#
מתעד אירוע צד-לקוח עבור המבקר הנוכחי (למשל רכישה, שדרוג תוכנית). אירועים יכולים להתניע סיורים (Tours) מבוססי-אירוע ולהיספר ליעדי סיור. מסירה במאמץ מיטבי עם keepalive, כך שאירועים שנורים ממש לפני ניווט (הפניה לתשלום) עדיין מגיעים. קראו לאחר init().
Respondo.track('purchase_completed', {
plan: 'pro',
amount: 49
});Respondo.destroy()#
מסיר את הווידג׳ט מהעמוד. שימושי ב-SPA בעת ניווט לעמודים שבהם הווידג׳ט לא אמור להופיע. הוא אינו מנקה את זהות המבקר או את השיחה השמורה — להתנתקות, השתמשו ב- Respondo.reset().
// הסרת הווידג׳ט מהעמוד
Respondo.destroy();
// אתחלו מחדש מאוחר יותר במידת הצורך (ממשיך את אותה שיחה)
Respondo.init({ agentId: 'YOUR_AGENT_ID' });Respondo.reset()#
התנתקות / החלפת משתמש במכשיר משותף. מנקה מהדפדפן את מזהה המבקר האנונימי, את השיחה השמורה ואת טוקן הסשן, מבטל את טוקן הסשן בצד השרת כך שעותקים שלו מפסיקים לעבוד, ומעגן מחדש וידג׳ט אנונימי טרי. קראו לזה מ-hook ההתנתקות של האפליקציה שלכם.
// בעת התנתקות — מחיקת זהות, שיחה וסשן, התחלה מחדש
Respondo.reset();איסוף נתונים אוטומטי
הווידג׳ט לוכד ושומר אוטומטית את הפרטים הבאים עם כל שיחה:
| נתון | מקור |
|---|---|
| כתובת IP של הלקוח | כותרות HTTP |
| דפדפן / מערכת הפעלה | כותרת User-Agent |
| שפה | כותרת Accept-Language |
| אזור זמן | Intl API (JavaScript) |
| כתובת URL של העמוד | window.location |
| מפנה (Referrer) | כותרת Referer |