תיעוד

הגדרות

התאימו את מראה והתנהגות הווידג׳ט.

אפשרויות Init#

אפשרותברירת מחדלתיאור
agentIdנדרש*המזהה הייחודי של ה-agent שלכם. *לווידג׳טים של בני אדם בלבד, מספיק channelId לבדו.
channelId—מזהה ערוץ הווידג׳ט. קובע אילו הגדרות וידג׳ט (עיצוב, טיזרים/באנרים יוצאים) חלות כשסוכן אחד מפעיל כמה וידג׳טים, והוא המזהה היחיד לווידג׳טים של בני אדם בלבד. נדרש לפחות אחד מ-agentId / channelId.
positionbottom-rightbottom-right או bottom-left
primaryColor#3B82F6צבע המותג לכפתור ולכותרת הווידג׳ט
titleSupportטקסט כותרת הכותרת
greetingautoהודעת פתיחה (נטענת מהגדרות לוח הבקרה כברירת מחדל)
languagepageשפת הווידג'ט כקוד BCP-47 (de, pt-BR). קובעת את הממשק, את הברכה ואת השאלות המהירות. ללא ציון, הווידג'ט עוקב אחר <html lang> של הדף: דף שה-lang שלו אינו en נפתח כעת בשפה זו, ללא קשר לדפדפן של המבקר. <html lang="en"> לבדו נחשב לברירת מחדל של תבנית ומתעלמים ממנו: המבקר שומר על ההתנהגות הקודמת (בחירה שנשמרה, ואז שפת הדפדפן). העבירו 'browser' כדי להתעלם לחלוטין מ-<html lang> ולחזור להתנהגות «דפדפן בלבד». ניתן לשנות בזמן ריצה באמצעות Respondo.setLanguage('fr') — שימושי למחליפי שפה שאינם טוענים מחדש את הדף.
placeholder—טקסט placeholder מותאם לשדה הקלט
quickQuestions—מערך של שאלות מוצעות המוצגות לפני ההודעה הראשונה
logoUrl—כתובת ה-URL של הלוגו שלכם המוצג בכותרת הווידג׳ט
avatarUrl—כתובת ה-URL של אווטאר ה-AI agent המוצג לצד ההודעות
identity—זהות משתמש מוגדרת מראש בזמן ה-init (אותם שדות כמו identify())
localStorageKey—מפתח localStorage שממנו יש לקרוא אוטומטית את userId (עבור הגדרות GTM / ללא קוד)
chatSizedefaultcompact, default או large — ממדי חלון הצ׳אט
launcherSizedefaultsmall, default או large — גודל כפתור המפעיל
offsetBottom20מרחק מהקצה התחתון (px)
offsetSide20מרחק מהקצה השמאלי/ימני (px)
borderRadius20רדיוס פינות חלון הצ׳אט (px)
zIndex999999z-index של ה-CSS עבור מכל הווידג׳ט
customCSS—CSS מותאם המוזרק ל-Shadow DOM של הווידג׳ט לעיצוב מתקדם
testModefalseסימון שיחות כבדיקה (מוסתרות מהתצוגות הראשיות)

הגדרה מלאה#

הגדרה מלאהjavascript
Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; ברירת מחדל: <html lang> (en = אות חלש), 'browser' מתעלם ממנו
  title: 'Help Center',
  greeting: 'How can we help?',
  placeholder: 'Ask anything...',
  logoUrl: 'https://yoursite.com/logo.png',
  avatarUrl: 'https://yoursite.com/avatar.png',
  quickQuestions: [
    'How do I get started?',
    'What are the pricing plans?',
    'How do I contact support?'
  ],
  testMode: false,
  localStorageKey: 'myapp_user_id', // קריאה אוטומטית של userId מ-localStorage (GTM / ללא קוד)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // מרחק מלמטה (px)
  identity: {                      // אופציונלי: הגדירו ב-init אם המשתמש כבר ידוע
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // מאפייני איש קשר מותאמים
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});
רוב ההגדרות (צבע, לוגו, הודעת פתיחה, שאלות מהירות) מנוהלות מלוח ה-Channels. הווידג׳ט מושך אותן בזמן הטעינה — אתם צריכים רק את צמד ה-agentId/channelId מקוד ההטמעה.