Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Jak dodać chatbota AI Asyntai do Umbraco

Instrukcja krok po kroku dla stron Umbraco CMS

Pobierz kod osadzania

Krok 1: Pobierz swój kod osadzania

Najpierw przejdź do swojego Panelu Asyntai i przewiń w dół do sekcji "Kod osadzania". Skopiuj swój unikalny kod osadzania, który będzie wyglądał tak:

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

Uwaga: Powyższy kod to tylko przykład. Musisz skopiować swój własny unikalny kod osadzania z Panelu, ponieważ zawiera on Twój osobisty identyfikator widgetu.

Krok 2: Edycja szablonu głównego (zalecane)

Najłatwiejszym sposobem dodania chatbota do wszystkich stron jest edycja szablonu głównego (Master):

  1. Zaloguj się do panelu Umbraco Backoffice
  2. Przejdź do Settings na lewym pasku bocznym
  3. Rozwiń Templates
  4. Kliknij szablon Master (lub główny szablon układu używany przez Twoją witrynę)
  5. Znajdź zamykający znacznik </body>
  6. Wklej kod osadzania Asyntai tuz przed znacznikiem </body>
  7. Kliknij "Save"

Wskazówka: Dodanie skryptu przed zamykającym znacznikiem </body> zapewnia, że ładuje się on po treści strony, co jest zalecane dla widgetów czatu i nie spowalnia ładowania strony.

Alternatywa: Użycie typu dokumentu Site Settings

Aby uzyskać większą elastyczność, możesz dodać własne pole do zarządzania skryptami w stopce:

  1. Przejdź do Settings → Document Types
  2. Edytuj typ dokumentu Site Settings (lub utwórz go, jeśli nie istnieje)
  3. Dodaj nową właściwość o nazwie "Footer Scripts" z typem danych Textarea
  4. Zapisz typ dokumentu
  5. Przejdź do Content i edytuj węzeł Site Settings
  6. Wklej kod osadzania Asyntai w polu Footer Scripts
  7. W szablonie Master dodaj ten kod przed </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Zapisz zarówno treść, jak i szablon

Uwaga: Użycie @Html.Raw() jest ważne, aby prawidłowo wyrenderować znaczniki skryptu bez kodowania HTML.

Alternatywa: Użycie folderu Scripts

Możesz również utworzyć plik JavaScript w panelu Umbraco Backoffice:

  1. Przejdź do Settings → Scripts
  2. Kliknij prawym przyciskiem myszy na Scripts i wybierz "Create"
  3. Utwórz nowy plik o nazwie asyntai-chatbot.js
  4. Dodaj następujący 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. Zamień YOUR_WIDGET_ID na rzeczywisty identyfikator widgetu
  6. Zapisz plik
  7. Dołącz ten skrypt w szablonie Master przed </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternatywa: Dla konkretnej strony z RenderSection

Jeśli chcesz umieścić chatbota tylko na określonych stronach:

  1. W szablonie Master dodaj przed </body>:
    @RenderSection("footerScripts", required: false)
  2. W konkretnym szablonie strony, w którym chcesz umieścić chatbota, dodaj:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian odwiedź swoją witrynę w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić się, że otwiera się i działa poprawnie.

Nie widzisz widgetu? Upewnij się, że zapisałeś szablon po wprowadzeniu zmian. Spróbuj wyczyścić pamięć podręczną przeglądarki lub otworzyć stronę w oknie incognito. Jeśli korzystasz z Umbraco Cloud, zmiany powinny zostać wdrożone automatycznie. W przypadku samodzielnie hostowanego Umbraco może być konieczne ponowne uruchomienie aplikacji lub wyczyszczenie pamięci podręcznej.