ਸੰਰਚਨਾ
ਵਿਜੇਟ ਦੀ ਦਿੱਖ ਅਤੇ ਵਿਹਾਰ ਆਪਣੇ ਮੁਤਾਬਕ ਢਾਲੋ।
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 | — | localStorage ਦੀ ਉਹ ਕੁੰਜੀ, ਜਿਸ ਵਿੱਚੋਂ userId ਆਪੇ ਪੜ੍ਹਿਆ ਜਾਵੇ (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', // 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 ਜੋੜੀ ਚਾਹੀਦੀ ਹੈ।