कॉन्फ़िगरेशन
विजेट की दिखावट और व्यवहार को कस्टमाइज़ करें।
Init विकल्प#
| विकल्प | डिफ़ॉल्ट | विवरण |
|---|---|---|
| agentId | आवश्यक* | आपके एजेंट की यूनिक ID। *केवल-इंसान (humans-only) विजेट के लिए अकेला 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 जोड़ी चाहिए।