कॉन्फिगरेशन
विजेटचे रूप आणि वर्तन तुमच्या पद्धतीने ठरवा.
इनिट पर्याय#
| पर्याय | डीफॉल्ट | वर्णन |
|---|---|---|
| agentId | आवश्यक* | तुमच्या एजंटचा युनिक ID. *फक्त-माणसांच्या विजेटसाठी channelId एकटाही पुरतो. |
| channelId | — | विजेट चॅनेलचा ID. एक एजंट अनेक विजेट चालवत असताना कोणत्या विजेटच्या सेटिंग्ज (शैली, आउटबाउंड टूलटिप/बॅनर) लागू होतात ते ठरवतो, आणि फक्त-माणसांच्या विजेटसाठी हाच एकमेव ओळखकर्ता असतो. 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"> टेम्पलेटचा डीफॉल्ट मानला जातो आणि दुर्लक्षित केला जातो: अभ्यागत पूर्वीचेच वर्तन पाहतो (लक्षात ठेवलेली निवड, मग ब्राउझरची भाषा). <html lang> पूर्णपणे दुर्लक्षित करून «फक्त ब्राउझर» वर्तनाकडे परतण्यासाठी 'browser' द्या. रनटाइमला Respondo.setLanguage('fr') ने बदलता येते — पान रीलोड न करणाऱ्या भाषा स्विचरसाठी उपयुक्त. |
| placeholder | — | इनपुटसाठी कस्टम प्लेसहोल्डर मजकूर |
| quickQuestions | — | पहिल्या मेसेजच्या आधी दाखवल्या जाणाऱ्या सुचवलेल्या प्रश्नांची ॲरे |
| logoUrl | — | विजेट हेडरमध्ये दिसणाऱ्या लोगोचा URL |
| avatarUrl | — | मेसेजशेजारी दिसणाऱ्या AI एजंटच्या अवतारचा URL |
| identity | — | init वेळीच वापरकर्त्याची ओळख देणे (identify() सारखीच फील्ड) |
| localStorageKey | — | userId आपोआप वाचण्यासाठी localStorage की (GTM / no-code सेटअपसाठी) |
| chatSize | default | compact, default, किंवा large — चॅट विंडोचे माप |
| launcherSize | default | small, default, किंवा large — लाँचर बटणाचा आकार |
| offsetBottom | 20 | तळाच्या कडेपासूनचे अंतर (px) |
| offsetSide | 20 | डाव्या/उजव्या कडेपासूनचे अंतर (px) |
| borderRadius | 20 | चॅट विंडोचा बॉर्डर रेडियस (px) |
| zIndex | 999999 | विजेट कंटेनरसाठी CSS z-index |
| customCSS | — | सखोल शैलीसाठी विजेटच्या Shadow DOM मध्ये टाकलेली कस्टम CSS |
| 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', // localStorage मधून userId आपोआप वाचा (GTM / no-code)
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 जोडी तेवढी लागते.