הגדרות
התאימו את מראה והתנהגות הווידג׳ט.
אפשרויות Init#
| אפשרות | ברירת מחדל | תיאור |
|---|---|---|
| agentId | נדרש* | המזהה הייחודי של ה-agent שלכם. *לווידג׳טים של בני אדם בלבד, מספיק channelId לבדו. |
| channelId | — | מזהה ערוץ הווידג׳ט. קובע אילו הגדרות וידג׳ט (עיצוב, טיזרים/באנרים יוצאים) חלות כשסוכן אחד מפעיל כמה וידג׳טים, והוא המזהה היחיד לווידג׳טים של בני אדם בלבד. נדרש לפחות אחד מ-agentId / channelId. |
| position | bottom-right | bottom-right או bottom-left |
| primaryColor | #3B82F6 | צבע המותג לכפתור ולכותרת הווידג׳ט |
| title | Support | טקסט כותרת הכותרת |
| greeting | auto | הודעת פתיחה (נטענת מהגדרות לוח הבקרה כברירת מחדל) |
| language | page | שפת הווידג'ט כקוד 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 / ללא קוד) |
| chatSize | default | compact, default או large — ממדי חלון הצ׳אט |
| launcherSize | default | small, default או large — גודל כפתור המפעיל |
| offsetBottom | 20 | מרחק מהקצה התחתון (px) |
| offsetSide | 20 | מרחק מהקצה השמאלי/ימני (px) |
| borderRadius | 20 | רדיוס פינות חלון הצ׳אט (px) |
| zIndex | 999999 | z-index של ה-CSS עבור מכל הווידג׳ט |
| customCSS | — | CSS מותאם המוזרק ל-Shadow DOM של הווידג׳ט לעיצוב מתקדם |
| testMode | false | סימון שיחות כבדיקה (מוסתרות מהתצוגות הראשיות) |
הגדרה מלאה#
הגדרה מלאה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 מקוד ההטמעה.