Ako pridať Asyntai AI Chatbot do Umbraco

Podrobný návod pre webové stránky Umbraco CMS

Získať vkladací kód

Krok 1: Ziskajte svoj vkladací kod

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii "Vkladaci kod". Skopirujte svoj jedinečný vkladací kod, ktory bude vyzerat takto:

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

Poznámka: Kod vyššie je len priklad. Musite skopirovat svoj vlastný jedinečný vkladací kod zo svojho Dashboardu, pretože obsahuje vase osobne ID widgetu.

Krok 2: Úprava hlavnej šablóny (Odporúčané)

Najjednoduchší spôsob pridania chatbota na všetky stránky je úpravou hlavnej šablóny:

  1. Prihláste sa do svojho Umbraco Backoffice
  2. Prejdite na Nastavenia v lavom bocnom paneli
  3. Rozbaľte Templates
  4. Kliknite na svoju šablónu Master (alebo hlavnú šablónu rozloženia, ktorú váš web používa)
  5. Najdite uzatvaraci tag </body>
  6. Vložíte svoj vkladací kod Asyntai tesne pred tag </body>
  7. Kliknite na "Ulozit"

Tip: Pridanie skriptu pred uzatvaraci tag </body> zabezpeci, ze sa nacita po obsahu stránky, co je odporúčané pre chatove widgety a nespomalí nacitanie vasej stránky.

Alternatíva: Pomocou typu dokumentu Site Settings

Pre väčšiu flexibilitu môžete pridať vlastné pole na správu skriptov pätičky:

  1. Prejdite na Settings → Document Types
  2. Upravte svoj typ dokumentu Site Settings (alebo ho vytvorte, ak neexistuje)
  3. Pridajte novú vlastnosť s názvom "Footer Scripts" s dátovým typom Textarea
  4. Uložte typ dokumentu
  5. Prejdite na Content a upravte uzol Site Settings
  6. Vložte svoj vkladací kód Asyntai do poľa Footer Scripts
  7. Do hlavnej šablóny pridajte tento kód pred </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Uložte obsah aj šablónu

Poznámka: Použitie @Html.Raw() je dôležité na správne vykreslenie značiek script bez HTML kódovania.

Alternatíva: Pomocou priečinka Scripts

Môžete tiež vytvoriť JavaScript súbor v Umbraco Backoffice:

  1. Prejdite na Settings → Scripts
  2. Kliknite pravým tlačidlom na Scripts a vyberte "Create"
  3. Vytvorte nový súbor s názvom asyntai-chatbot.js
  4. Pridajte nasledujuci kod:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  5. Nahradte YOUR_WIDGET_ID vasim skutocnym ID widgetu
  6. Uložte súbor
  7. Zahrňte tento skript do hlavnej šablóny pred </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternatíva: Pre konkrétnu stránku s RenderSection

Ak chcete chatbota len na konkretnch strankach:

  1. Do hlavnej šablóny pridajte pred </body>:
    @RenderSection("footerScripts", required: false)
  2. Do konkrétnej šablóny stránky, kde chcete chatbota, pridajte:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Krok 3: Overenie inštalácie

Po uložení vasich zmien navštívte svoju webovú stránku v novej karte prehliadača alebo v okne inkognito. Mali by ste vidiet tlačidlo chatoveho widgetu v pravom dolnom rohu. Kliknite nan, aby ste sa uistili, ze sa otvara a funguje správne.

Nevidite widget? Uistite sa, že ste po vykonaní zmien uložili šablónu. Skúste vymazať vyrovnávaciu pamäť prehliadača alebo zobraziť stránku v okne inkognito. Ak používate Umbraco Cloud, zmeny by sa mali nasadiť automaticky. Pri vlastnom hostingu Umbraco možno budete musieť reštartovať aplikáciu alebo vymazať vyrovnávaciu pamäť.