Ako pridať Asyntai AI chatbota do Kentico

Návod krok za krokom pre webové stránky Kentico CMS

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie kódu do šablóny hlavnej stránky (odporúčané)

Na pridanie chatbota na všetky stránky vašej webovej stránky Kentico naraz použite metódu šablóny hlavnej stránky:

Prihláste sa do svojho Adminu Kentico a prejdite na aplikáciu Šablóny stránok
Nájdite a otvorte svoju šablónu hlavnej stránky (šablónu používanú naprieč všetkými stránkami)
Kliknite na kartu Hlavička v editore šablón
Do sekcie hlavičky vložte svoj vkladací kód Asyntai
Alternatívne pridajte kód do rozloženia šablóny pred uzatvárací tag </head>
Kliknite na Uložiť na aplikovanie zmien
Vymažte vyrovnávaciu pamäť vašej stránky a overte zmeny na živej stránke

Tip: Použitie šablóny hlavnej stránky zabezpečí, že sa chatbot zobrazí na každej stránke, ktorá dedí z tejto šablóny. Toto je najefektívnejšia metóda pre nasadenie na celom webe v Kentico.

Alternatívna metóda 1: Hlavička šablóny stránky

Ak chcete pridať chatbota len do konkrétnych šablón stránok:

Prejdite na aplikáciu Šablóny stránok v Admine Kentico
Vyberte konkrétnu šablónu stránky, ktorú chcete upraviť
Kliknite na kartu Hlavička
Pridajte svoj vkladací kód Asyntai pomocou tagu skriptu:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Kliknite na Uložiť
Všetky stránky používajúce túto šablónu teraz budú obsahovať chatbota

Poznámka: Táto metóda je užitočná, keď chcete pridať chatbota do konkrétnych sekcií vašej stránky, ktoré zdieľajú rovnakú šablónu stránky, namiesto celej stránky.

Alternatívna metóda 2: Webová časť HEAD HTML

Pre detailnejšiu kontrolu na konkrétnych stránkach alebo pre dedičný JavaScript naprieč podstránkami:

Otvorte stránku, ktoru chcete upravit, v Editore stránok Kentico
Pridajte novú webovú časť na stránku (najlepšie na rodičovskú stránku pre dedičnosť)
Vyhľadajte a vyberte webovú časť HEAD HTML
V konfigurácii webovej časti vložte svoj vkladací kód Asyntai
Nakonfigurujte webovú časť ako dedičnú, ak chcete, aby detské stránky mali chatbota
Kliknite na OK na uloženie webovej časti
Uložte a publikujte stránku

Tip: Webová časť HEAD HTML je perfektná na pridanie kódu na rodičovskú stránku, ktorý sa automaticky rozšíri na všetky detské stránky, čím sa vytvorí inštalácia pre celú sekciu.

Alternativna metoda 3: Vlastné JavaScript súbory (pokročilé)

Pre vývojárov, ktorí uprednostňujú správu skriptov ako súborov:

Vo vašom projekte Kentico prejdite do priečinka ~/CMSScripts/Custom/
Vytvorte nový JavaScript súbor (napr. asyntai-widget.js)
Pridajte kód na dynamické načítanie vášho widgetu Asyntai:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Odkážte na tento súbor v hlavičke vašej šablóny hlavnej stránky:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

Dôležité: Táto pokročilá metóda vyžaduje prístup k súborovému systému a znalosť štruktúry priečinkov Kentico. Uistite sa, že máte správne oprávnenia a vždy najprv testujte v testovacom prostredí.

Krok 3: Overenie inštalácie

Po uložení vašich zmien a vymazaní vyrovnávacej pamäte otvorte svoju webovú stránku v novej karte prehliadača alebo v okne inkognito. Mali by ste vidieť tlačidlo chatového widgetu v pravom dolnom rohu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidíte widget? Uistite sa, ze ste uložili všetky zmeny a vymazali vyrovnávaciu pamat Kentico (Nastavenia > System > Vymazat vyrovnávaciu pamat). Skuste zobrazit svoju stránku v okne inkognito. Skontrolujte konzolu prehliadača (F12) kvoli pripadnym chybam JavaScriptu, ktore mozu branit nacitaniu widgetu.