תיעוד

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