ਦਸਤਾਵੇਜ਼

ਸੰਰਚਨਾ

ਵਿਜੇਟ ਦੀ ਦਿੱਖ ਅਤੇ ਵਿਹਾਰ ਆਪਣੇ ਮੁਤਾਬਕ ਢਾਲੋ।

init ਦੇ ਵਿਕਲਪ#

ਵਿਕਲਪਮੂਲਵੇਰਵਾ
agentIdਲਾਜ਼ਮੀ*ਤੁਹਾਡੇ ਏਜੰਟ ਦਾ ਵਿਲੱਖਣ ID। *ਸਿਰਫ਼-ਵਿਅਕਤੀਆਂ ਵਾਲੇ (humans-only) ਵਿਜੇਟਾਂ ਲਈ ਇਕੱਲਾ 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—localStorage ਦੀ ਉਹ ਕੁੰਜੀ, ਜਿਸ ਵਿੱਚੋਂ userId ਆਪੇ ਪੜ੍ਹਿਆ ਜਾਵੇ (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', // auto-read userId from localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // distance from bottom (px)
  identity: {                      // optional: set at init if user is already known
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // custom contact properties
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});
ਬਹੁਤੀਆਂ ਸੈਟਿੰਗਾਂ (ਰੰਗ, ਲੋਗੋ, ਸਵਾਗਤੀ ਸੁਨੇਹਾ, ਝਟਪਟ ਸਵਾਲ) ਡੈਸ਼ਬੋਰਡ ਦੇ Channels ਭਾਗ ਵਿੱਚੋਂ ਸੰਭਾਲੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਵਿਜੇਟ ਇਹ ਲੋਡ ਹੋਣ ਵੇਲੇ ਆਪ ਲੈ ਲੈਂਦਾ ਹੈ — ਜੋੜਨ ਵਾਲੇ ਕੋਡ ਵਿੱਚੋਂ ਤੁਹਾਨੂੰ ਸਿਰਫ਼ agentId/channelId ਜੋੜੀ ਚਾਹੀਦੀ ਹੈ।