Jak přidat Asyntai AI chatbota do Kentico

Podrobný návod pro weby na platformě Kentico CMS

Platforma:

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Přidání kódu do šablony hlavní stránky (Doporučeno)

Pro přidání chatbota na všechny stránky vašeho webu Kentico najednou použijte metodu šablony hlavní stránky:

Přihlaste se do správy Kentico a přejděte do aplikace Šablony stránek
Najděte a otevřete svou šablonu hlavní stránky (šablona používána na všech stránkách)
Klikněte na kartu Hlavička v editoru šablony
Do sekce hlavičky vložte svůj vložený kód Asyntai
Případně přidejte kód do rozložení šablony před uzavírací tag </head>
Klikněte na Uložit pro provedení změn
Vymažte mezipaměť webu a ověřte změny na živém webu

Tip: Použití šablony hlavní stránky zajišťuje, že se chatbot zobrazí na každé stránce, která z teto šablony dedi. Toto je nejucinnejsi metoda pro nasazeni na celém webu v Kentico.

Alternativní metoda 1: Hlavička šablony stránky

Pokud chcete přidat chatbota pouze do konkrétních šablon stránek:

Přejděte do aplikace Šablony stránek ve správě Kentico
Vyberte konkrétní šablonu stránky, kterou chcete upravit
Klikněte na kartu Hlavička
Přidejte svůj vložený kód Asyntai pomocí tagu script:

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

Klikněte na Uložit
Všechny stránky používající tuto šablonu nyní budou obsahovat chatbota

Poznámka: Tato metoda je uzitecna, pokud chcete přidat chatbota do konkretnich sekci vašeho webu, které sdílejí stejnou šablonu stránky, a ne na celý web.

Alternativní metoda 2: Webova cast HEAD HTML

Pro podrobnejsi kontrolu na konkretnich stránkách nebo pro dedicelny JavaScript na podstránkách:

Otevřete stránku, kterou chcete upravit, v editoru stránek Kentico
Přidejte na stránku novou webovou cast (nejlepe na nadrazenou stránku pro dedicnost)
Vyhledejte a vyberte webovou část HEAD HTML
V konfiguraci webové části vložte svůj vložený kód Asyntai
Nastavte webovou cast jako dedicelnou, pokud chcete, aby podřízené stránky mely chatbota
Klikněte na OK pro uložení webové části
Uložte a publikujte stránku

Tip: Webova cast HEAD HTML je ideální pro přidání kódu na nadrazenou stránku, který se automaticky rozšíříte na všechny podřízené stránky, cimz vytvorite instalaci pro celou sekci.

Alternativní metoda 3: Vlastní soubory JavaScript (Pokročilé)

Pro vývojáře, kteří preferují správu skriptů jako souborů:

Ve svém projektu Kentico přejděte do adresare ~/CMSScripts/Custom/
Vytvořte nový JavaScript soubor (např. asyntai-widget.js)
Přidejte kód pro dynamické načtení vašeho 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);
})();

Odkazujte na tento soubor v hlavičce šablony hlavní stránky:

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

Důležité: Tato pokročilá metoda vyžaduje přístup k souborovému systému a znalost adresářové struktury Kentico. Ujistěte se, že máte správná oprávnění, a vždy nejprve testujte v testovacím prostředí.

Krok 3: Ověřte instalaci

Po uložení změn a vymazání mezipaměti otevřete svůj web v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na nej a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Ujistěte se, že jste uložili všechny změny a vymazali mezipaměť Kentico (Nastavení > System > Vymazat mezipaměť). Zkuste web zobrazit v anonymním okne. Zkontrolujte konzoli prohlížeče (F12), zda nejsou chyby JavaScriptu, které by mohly branit načtení widgetu.