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 sie do panelu Umbraco Backoffice
  2. Przejdź do Settings na lewym pasku bocznym
  3. Rozwin Templates
  4. Kliknij szablon Master (lub główny szablon ukladu używany przez Twoja 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 nowa właściwość o nazwie "Footer Scripts" z typem danych Textarea
  4. Zapisz typ dokumentu
  5. Przejdź do Content i edytuj wezel 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 prawidlowo wyrenderowac 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. Replace YOUR_WIDGET_ID with your actual widget ID
  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. In the specific page template where you want the chatbot, add:
    @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ź swoja witrynę w nowej karcie przeglądarki lub w oknie incognito. Powinieneś zobaczyć przycisk widgetu czatu w prawym dolnym rogu. Kliknij go, aby upewnić sie, ze otwiera sie i działa poprawnie.

Nie widzisz widgetu? Upewnij sie, ze zapisales szablon po wprowadzeniu zmian. Spróbuj wyczyścić pamięć podręczna przeglądarki lub otworzyc stronę w oknie incognito. Jeśli korzystasz z Umbraco Cloud, zmiany powinny zostac wdrozone automatycznie. W przypadku samodzielnie hostowanego Umbraco może byc konieczne ponowne uruchomienie aplikacji lub wyczyszczenie pamięci podręcznej.