Jak dodać chatbota AI Asyntai do Kentico

Przewodnik krok po kroku dla witryn Kentico CMS

Platforma:

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: Dodaj kod do szablonu strony głównej (zalecane)

Aby dodać chatbota do wszystkich stron witryny Kentico jednocześnie, użyj metody szablonu strony głównej (Master Page Template):

Zaloguj się do panelu administratora Kentico i przejdź do aplikacji Page templates
Znajdź i otwórz swój szablon strony głównej (szablon używany na wszystkich stronach)
Kliknij zakładkę Header w edytorze szablonów
W sekcji nagłówka wklej swój kod osadzania Asyntai
Alternatywnie dodaj kod do układu szablonu przed zamykającym tagiem </head>
Kliknij Save, aby zastosować zmiany
Wyczyść pamięć podręczną strony i zweryfikuj zmiany na stronie produkcyjnej

Wskazówka: Użycie szablonu strony głównej (Master Page Template) zapewnia, że chatbot pojawi się na każdej stronie dziedziczącej z tego szablonu. Jest to najefektywniejsza metoda wdrożenia na całej witrynie w Kentico.

Metoda alternatywna 1: Nagłówek szablonu strony

Jeśli chcesz dodać chatbota tylko do określonych szablonów stron:

Przejdź do aplikacji Page templates w panelu administratora Kentico
Wybierz konkretny szablon strony, który chcesz edytować
Kliknij zakładkę Header
Dodaj swój kod osadzania Asyntai za pomocą tagu script:

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

Kliknij Save
Wszystkie strony korzystające z tego szablonu będą teraz zawierać chatbota

Uwaga: Ta metoda jest przydatna, gdy chcesz dodać chatbota do określonych sekcji witryny korzystających z tego samego szablonu strony, a nie do całej witryny.

Metoda alternatywna 2: Web Part HEAD HTML

Aby uzyskać bardziej szczegółową kontrolę na konkretnych stronach lub dziedziczny JavaScript na podstronach:

Otwórz stronę, którą chcesz edytować, w edytorze stron Kentico
Dodaj nowy web part do strony (najlepiej na stronie nadrzędnej w celu dziedziczenia)
Wyszukaj i wybierz web part HEAD HTML
W konfiguracji web parta wklej swój kod osadzania Asyntai
Skonfiguruj web part jako dziedziczny, jeśli chcesz, aby strony potomne miały chatbota
Kliknij OK, aby zapisać web part
Zapisz i opublikuj stronę

Wskazówka: Web part HEAD HTML jest idealny do dodawania kodu na stronie nadrzędnej, który automatycznie propaguje się na wszystkie strony potomne, tworząc instalację obejmującą całą sekcję.

Metoda alternatywna 3: Niestandardowe pliki JavaScript (zaawansowana)

Dla programistów, którzy wolą zarządzać skryptami jako plikami:

W swoim projekcie Kentico przejdź do katalogu ~/CMSScripts/Custom/
Utwórz nowy plik JavaScript (np. asyntai-widget.js)
Dodaj kod do dynamicznego ładowania 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);
})();

Odwołaj się do tego pliku w nagłówku szablonu strony głównej:

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

Ważne: Ta zaawansowana metoda wymaga dostępu do systemu plików i znajomości struktury katalogów Kentico. Upewnij się, że masz odpowiednie uprawnienia i zawsze najpierw testuj w środowisku testowym.

Krok 3: Weryfikacja instalacji

Po zapisaniu zmian i wyczyszczeniu pamięci podręcznej otwórz 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 sie, ze zapisales wszystkie zmiany i wyczysciles pamięć podręczna Kentico (Settings > System > Clear cache). Spróbuj wyświetlić witrynę w oknie incognito. Sprawdź konsolę przeglądarki (F12) pod kątem błędów JavaScript, które mogą uniemozliwic załadowanie widgetu.