உள்ளடக்கத்துக்குச் செல்
KeuralDocs
டெவலப்பர்கள்

சாட்பாட்

நிறுவன இணையதளத்தில் நிறுவல் குறியீட்டைக் கொண்டு Keural சாட்பாட் பொத்தானை இணைக்கவும்.

நிறுவனங்கள் தங்கள் இணையதளத்தில் Keural சாட்பாட்டை நிறுவலாம். பார்வையாளர் திரையின் மூலையில் உள்ள பொத்தானை அழுத்தினால் சாட்பாட் சாளரம் திறக்கும். நிர்வாகத் திரையில் உருவாக்கிய நிறுவல் குறியீட்டை இணையதளத்தில் ஒட்டி நிறுவவும்.

சாட்பாட் உருவாக்குதல்

  1. நிறுவன உரிமையாளர் அல்லது நிர்வாகி நிறுவன நிர்வாகம் → சாட்பாட் நிர்வாகம் இல் சாட்பாட் சேர் ஐ அழுத்தவும்.
  2. சாட்பாட் பெயரையும் அடிப்படை டொமைனையும் (எ.கா. https://example.com) உள்ளிட்டுப் பதிவு செய்யவும்.
  3. சாட்பாட்டைத் திறந்து மூன்று தாவல்களையும் அமைக்கவும்.
தாவல்அமைப்பு
டோக்கன்·நிறுவல் குறியீடுடோக்கனைச் சரிபார்த்தல், நிறுவல் குறியீட்டை (HTML · Next.js) நகலெடுத்தல்
சாட்பாட் UI அமைப்புகள்பொத்தான் படம் (PNG·JPG·GIF·WebP) மற்றும் காட்சி, சாட்பாட் பெயர், தலைப்பின் காட்சி·விரிவு·நிறம், பொத்தான் நிறம், பொத்தான் நிலை (இடது·வலது) மற்றும் கிடைமட்ட·செங்குத்து ஆஃப்செட். முன்னோட்டத்தில் சரிபார்க்க
மேம்பட்ட அமைப்புகள்சாட்பாட்டைத் திறக்கக்கூடிய பக்க முகவரிகள் (அனுமதிக்கப்பட்ட டொமைன்கள், அதிகபட்சம் 5)
  1. நிறுவல் குறியீட்டை உங்கள் இணையதளத்தில் ஒட்டவும்.

நிறுவல் குறியீடு

டோக்கன்·நிறுவல் குறியீடு தாவலில் 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கட்டாயம். நிறுவல் குறியீட்டின் டோக்கன்—
themelight · dark · system—
header.enabledதலைப்பைக் காட்டும்தலைப்பு காட்சி
header.extendedதலைப்பில் பெரிதாகப் பார்க்கும் பொத்தானைக் காட்டும்தலைப்பு விரிவு
header.draggableதலைப்பை இழுத்துச் சாளரத்தை நகர்த்தலாம் (இயல்பு true)—
header.titleதலைப்பின் தலைப்புசாட்பாட் பெயர்
header.colorதலைப்பின் நிறம்தலைப்பு நிறம்
button.visibleபொத்தானைக் காட்டும்பொத்தான் காட்சி
button.iconUrlபொத்தான் படத்தின் முகவரிபொத்தான் படம்
button.colorபொத்தானின் நிறம்பொத்தான் நிறம்
button.positionleft · 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-srchttps://keural.ai, நிறுவல் குறியீட்டின் இன்லைன் ஸ்கிரிப்ட் ('unsafe-inline' அல்லது hash·nonce)
connect-srchttps://api.keural.ai
frame-srchttps://keural.ai
style-src'unsafe-inline' அல்லது nonce (சாட்பாட் பக்கத்தில் ஸ்டைல்களைச் சேர்க்கும்)
img-srcபொத்தான் படத்தின் முகவரி, https://keural.ai, https://api.keural.ai

இந்தப் பக்கத்தில்