சாட்பாட்
நிறுவன இணையதளத்தில் நிறுவல் குறியீட்டைக் கொண்டு Keural சாட்பாட் பொத்தானை இணைக்கவும்.
நிறுவனங்கள் தங்கள் இணையதளத்தில் Keural சாட்பாட்டை நிறுவலாம். பார்வையாளர் திரையின் மூலையில் உள்ள பொத்தானை அழுத்தினால் சாட்பாட் சாளரம் திறக்கும். நிர்வாகத் திரையில் உருவாக்கிய நிறுவல் குறியீட்டை இணையதளத்தில் ஒட்டி நிறுவவும்.
சாட்பாட் உருவாக்குதல்
- நிறுவன உரிமையாளர் அல்லது நிர்வாகி நிறுவன நிர்வாகம் → சாட்பாட் நிர்வாகம் இல் சாட்பாட் சேர் ஐ அழுத்தவும்.
- சாட்பாட் பெயரையும் அடிப்படை டொமைனையும் (எ.கா.
https://example.com) உள்ளிட்டுப் பதிவு செய்யவும். - சாட்பாட்டைத் திறந்து மூன்று தாவல்களையும் அமைக்கவும்.
| தாவல் | அமைப்பு |
|---|---|
| டோக்கன்·நிறுவல் குறியீடு | டோக்கனைச் சரிபார்த்தல், நிறுவல் குறியீட்டை (HTML · Next.js) நகலெடுத்தல் |
| சாட்பாட் UI அமைப்புகள் | பொத்தான் படம் (PNG·JPG·GIF·WebP) மற்றும் காட்சி, சாட்பாட் பெயர், தலைப்பின் காட்சி·விரிவு·நிறம், பொத்தான் நிறம், பொத்தான் நிலை (இடது·வலது) மற்றும் கிடைமட்ட·செங்குத்து ஆஃப்செட். முன்னோட்டத்தில் சரிபார்க்க |
| மேம்பட்ட அமைப்புகள் | சாட்பாட்டைத் திறக்கக்கூடிய பக்க முகவரிகள் (அனுமதிக்கப்பட்ட டொமைன்கள், அதிகபட்சம் 5) |
- நிறுவல் குறியீட்டை உங்கள் இணையதளத்தில் ஒட்டவும்.
நிறுவல் குறியீடு
டோக்கன்·நிறுவல் குறியீடு தாவலில் HTML க்கும் Next.js க்கும் உரிய குறியீட்டை நகலெடுக்கவும். குறியீடு இரண்டு பகுதிகளைக் கொண்டது.
- ஏற்றி:
Keuralசெயல்பாட்டை உருவாக்கி, பக்கம் முழுவதுமாக ஏற்றப்பட்ட பின் சாட்பாட் ஸ்கிரிப்டை (/plugin/keural-widget@1.0.1.js) async ஆக ஏற்றும். ஸ்கிரிப்ட் வருவதற்கு முன் அழைக்கப்படும் கட்டளைகள் வரிசையில் சேமிக்கப்பட்டு வரிசையாக இயக்கப்படும். - தொடக்கக் கட்டளை:
Keural('boot', { token: '…' }). டோக்கன்wgt_இல் தொடங்கும்.
ஸ்கிரிப்ட் பதிப்பு அந்த முகவரியிலேயே நிலைநிறுத்தப்பட்டுள்ளது. புதிய பதிப்பு வந்தால், நிறுவல் குறியீட்டை மீண்டும் நகலெடுத்து மாற்றவும். ஒரே பக்கத்தில் நிறுவல் குறியீட்டை இரண்டு முறை வைத்தால், இரண்டாவது குறியீடு புறக்கணிக்கப்பட்டு கன்சோலில் பிழை பதிவாகும்.
<script id="keural-one-script">
/* டோக்கன்·நிறுவல் குறியீடு தாவலில் இருந்து நகலெடுத்த குறியீடு */
</script>Next.js இல், next/script இலிருந்து <Script id="keural-one-script" strategy="afterInteractive"> மூலம் சேர்க்கவும். செயலி முழுவதும் காட்ட வேண்டுமெனில் root layout இல் வைக்கவும்.
தொடக்க விருப்பங்கள்
boot இல் கொடுக்கும் மதிப்புகள், நிர்வாகத் திரை அமைப்புகளை விட முன்னுரிமை பெறும். பக்கத்துக்குப் பக்கம் தோற்றத்தை மாற்ற இதைப் பயன்படுத்தவும்.
Keural('boot', {
token: 'wgt_…',
theme: 'system',
header: { enabled: true, extended: true, draggable: true, title: 'வாடிக்கையாளர் உதவி', color: '#495BD8' },
button: { visible: true, iconUrl: 'https://example.com/icon.png', color: '#495BD8', position: 'right', offsetX: 30, offsetY: 30 },
});| விருப்பம் | மதிப்பு | திரையில் உள்ள அமைப்பின் பெயர் |
|---|---|---|
token | கட்டாயம். நிறுவல் குறியீட்டின் டோக்கன் | — |
theme | light · dark · system | — |
header.enabled | தலைப்பைக் காட்டும் | தலைப்பு காட்சி |
header.extended | தலைப்பில் பெரிதாகப் பார்க்கும் பொத்தானைக் காட்டும் | தலைப்பு விரிவு |
header.draggable | தலைப்பை இழுத்துச் சாளரத்தை நகர்த்தலாம் (இயல்பு true) | — |
header.title | தலைப்பின் தலைப்பு | சாட்பாட் பெயர் |
header.color | தலைப்பின் நிறம் | தலைப்பு நிறம் |
button.visible | பொத்தானைக் காட்டும் | பொத்தான் காட்சி |
button.iconUrl | பொத்தான் படத்தின் முகவரி | பொத்தான் படம் |
button.color | பொத்தானின் நிறம் | பொத்தான் நிறம் |
button.position | left · right | பொத்தான் நிலை |
button.offsetX · button.offsetY | திரை ஓரத்திலிருந்து தூரம் (px) | X ஆஃப்செட் · Y ஆஃப்செட் |
புதிதாக உருவாக்கிய சாட்பாட்டின் இயல்புநிலைகள்: தலைப்புக் காட்சி மற்றும் விரிவு இயக்கத்தில், தலைப்பு மற்றும் பொத்தான் நிறம் #495BD8, வலது பக்கம், ஆஃப்செட் 30px, தீம் system.
பக்கத்திலிருந்து கட்டுப்படுத்துதல்
| அழைப்பு | செயல்பாடு |
|---|---|
Keural('open') · Keural.open() | சாட்பாட் சாளரத்தைத் திறக்கும். |
Keural('close') · Keural.close() | மூடும். |
Keural('toggle') · Keural.toggle() | திறந்திருந்தால் மூடும், மூடியிருந்தால் திறக்கும். |
Keural('reload') · Keural.reload() | சாட்பாட் சாளரத்தை மீண்டும் ஏற்றும். |
Keural('badge', n) · Keural.badge(n) | பொத்தானில் எண் அடையாளத்தைக் காட்டும். |
Keural.isLoaded() | ஸ்கிரிப்ட் முழுமையாக ஏற்றப்பட்டிருந்தால் true |
Keural.onOpen(cb) · Keural.onClose(cb) | சாளரம் திறக்கும்போதோ மூடும்போதோ cb ஐ அழைக்கும். |
ஸ்கிரிப்ட் ஏற்றப்பட்ட பின்பே Keural.open() போன்ற முறைகள் வேலை செய்யும். பக்கம் ஏற்றப்பட்ட உடனே அழைக்கும்போது Keural('open') போன்ற செயல்பாட்டு வடிவத்தைப் பயன்படுத்துங்கள்; அவை வரிசையாக இயக்கப்படும்.
<button onclick="Keural('open')">எங்களைத் தொடர்புகொள்ளுங்கள்</button>இயல்பு பொத்தானை மறைத்து (button.visible: false) பக்கத்தின் பொத்தானிலிருந்து திறக்கலாம்.
திரை அளவு
சாட்பாட் சாளரம் 390×800px. திரையின் அகலம் 480px அல்லது அதற்குக் குறைவாக இருந்தால் முழுத் திரையில் திறக்கும். தலைப்பில் உள்ள பெரிதாகப் பார்க்கும் பொத்தானால் சாளரத்தைப் பெரிதாக்கலாம்.
திறக்கும் டொமைன்கள்
- சாட்பாட் அடிப்படை டொமைனின் ஹோஸ்ட் உள்ள பக்கங்களில் திறக்கும். ஹோஸ்ட் போர்ட் உட்பட ஒப்பிடப்படும்; பெரிய சிறிய எழுத்து வேறுபாடு கிடையாது.
www.உள்ள முகவரியும் துணை டொமைன்களும் வேறு ஹோஸ்ட்களாகக் கருதப்படும். மேம்பாட்டு சர்வரில் சோதிக்க வேண்டுமெனில், அந்த முகவரியை அடிப்படை டொமைனாகக் கொண்ட தனி சாட்பாட்டை உருவாக்கவும். - உருவாக்கிய பின் அடிப்படை டொமைனை மாற்ற முடியாது. மாற்ற வேண்டுமெனில் புதிய சாட்பாட்டை உருவாக்கவும்.
- மேம்பட்ட அமைப்புகளில் அனுமதிக்கப்பட்ட டொமைன்களை வெறுமையாக விட்டால், அடிப்படை டொமைனின் அனைத்துப் பக்கங்களிலும் திறக்கும். அனுமதிக்கப்பட்ட டொமைன்களை உள்ளிட்டால், அந்த முகவரியில் தொடங்கும் பக்கங்களில் மட்டுமே திறக்கும்.
https://example.com/helpபோன்று பாதையுடன் எழுதினால், அந்தப் பாதைக்குக் கீழுள்ள பக்கங்களுக்கு மட்டும் குறுகும். அனுமதிக்கப்பட்ட டொமைன்கள்http://அல்லதுhttps://இல் தொடங்க வேண்டும்; அதிகபட்சம் 5. - நிறுவல் குறியீட்டில் உள்ள டோக்கன் பக்கத்தில் நேரடியாகத் தெரியும். வெளிப்படுத்தலாம் என்ற உள்ளடக்கத்தை மட்டுமே சாட்பாட்டுடன் இணைக்கவும்.
பாதுகாப்புக் கொள்கை (CSP)
உங்கள் தளத்தில் Content-Security-Policy ஐ அமைத்திருந்தால், பின்வருவனவற்றை அனுமதிக்கவும். முகவரிகள் keural.ai அடிப்படையிலானவை.
| உத்தரவு | அனுமதிக்க வேண்டியவை |
|---|---|
script-src | https://keural.ai, நிறுவல் குறியீட்டின் இன்லைன் ஸ்கிரிப்ட் ('unsafe-inline' அல்லது hash·nonce) |
connect-src | https://api.keural.ai |
frame-src | https://keural.ai |
style-src | 'unsafe-inline' அல்லது nonce (சாட்பாட் பக்கத்தில் ஸ்டைல்களைச் சேர்க்கும்) |
img-src | பொத்தான் படத்தின் முகவரி, https://keural.ai, https://api.keural.ai |