కాన్ఫిగరేషన్
విడ్జెట్ రూపాన్ని, ప్రవర్తనను మీ ఇష్టానుసారం మార్చుకోండి.
Init ఆప్షన్లు#
| ఆప్షన్ | డిఫాల్ట్ | వివరణ |
|---|---|---|
| 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 జత ఉంటే సరిపోతుంది.