डॉक्युमेंटेशन

कॉन्फिगरेशन

विजेटचे रूप आणि वर्तन तुमच्या पद्धतीने ठरवा.

इनिट पर्याय#

पर्यायडीफॉल्टवर्णन
agentIdआवश्यक*तुमच्या एजंटचा युनिक ID. *फक्त-माणसांच्या विजेटसाठी channelId एकटाही पुरतो.
channelId—विजेट चॅनेलचा ID. एक एजंट अनेक विजेट चालवत असताना कोणत्या विजेटच्या सेटिंग्ज (शैली, आउटबाउंड टूलटिप/बॅनर) लागू होतात ते ठरवतो, आणि फक्त-माणसांच्या विजेटसाठी हाच एकमेव ओळखकर्ता असतो. agentId / channelId पैकी किमान एक आवश्यक आहे.
positionbottom-rightbottom-right किंवा bottom-left
primaryColor#3B82F6विजेट बटण आणि हेडरसाठी ब्रँड रंग
titleSupportहेडरमधला शीर्षक मजकूर
greetingautoस्वागत मेसेज (डीफॉल्टनुसार डॅशबोर्ड सेटिंग्जमधून घेतला जातो)
languagepageविजेटची भाषा 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 सेटअपसाठी)
chatSizedefaultcompact, default, किंवा large — चॅट विंडोचे माप
launcherSizedefaultsmall, default, किंवा large — लाँचर बटणाचा आकार
offsetBottom20तळाच्या कडेपासूनचे अंतर (px)
offsetSide20डाव्या/उजव्या कडेपासूनचे अंतर (px)
borderRadius20चॅट विंडोचा बॉर्डर रेडियस (px)
zIndex999999विजेट कंटेनरसाठी CSS z-index
customCSS—सखोल शैलीसाठी विजेटच्या Shadow DOM मध्ये टाकलेली कस्टम CSS
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', // 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 जोडी तेवढी लागते.