డాక్యుమెంటేషన్

కాన్ఫిగరేషన్

విడ్జెట్ రూపాన్ని, ప్రవర్తనను మీ ఇష్టానుసారం మార్చుకోండి.

Init ఆప్షన్‌లు#

ఆప్షన్డిఫాల్ట్వివరణ
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 జత ఉంటే సరిపోతుంది.