Как да добавите Asyntai AI чатбот в Kentico

Ръководство стъпка по стъпка за уебсайтове на Kentico CMS

Платформа:

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Добавете код към шаблона на Master Page (Препоръчително)

За да добавите чатбота към всички страници на вашия Kentico уебсайт наведнъж, използвайте метода с Master Page Template:

Влезте в Kentico Admin и навигирайте до приложението Page templates
Намерете и отворете вашия Master page template (шаблонът, използван на всички страници)
Кликнете върху раздела Header в редактора на шаблони
В секцията header поставете вашия Asyntai код за вграждане
Алтернативно, добавете кода към оформлението на шаблона преди затварящия таг </head>
Кликнете Save, за да приложите промените
Изчистете кеша на сайта и проверете промените на живия сайт

Съвет: Използването на Master Page Template гарантира, че чатботът се появява на всяка страница, която наследява от този шаблон. Това е най-ефективният метод за разгръщане на целия сайт в Kentico.

Алтернативен метод 1: Header на шаблон за страница

Ако искате да добавите чатбота само към конкретни шаблони за страници:

Отидете на приложението Page templates в Kentico Admin
Изберете конкретния шаблон за страница, който искате да редактирате
Кликнете върху раздела Header
Добавете вашия Asyntai код за вграждане, като използвате скрипт таг:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Кликнете Save
Всички страници, използващи този шаблон, вече ще включват чатбота

Забележка: Този метод е полезен, когато искате да добавите чатбота към конкретни секции на вашия сайт, които споделят един и същ шаблон за страница, вместо към целия сайт.

Алтернативен метод 2: Уеб част HEAD HTML

За по-детайлен контрол на конкретни страници или за наследяем JavaScript между подстраниците:

Отворете страницата, която искате да редактирате, в редактора на страници на Kentico
Добавете нова уеб част към страницата (за предпочитане в родителска страница за наследяване)
Потърсете и изберете уеб частта HEAD HTML
В конфигурацията на уеб частта поставете вашия Asyntai код за вграждане
Конфигурирайте уеб частта да бъде наследяема, ако искате дъщерните страници да имат чатбота
Кликнете OK, за да запазите уеб частта
Запазете и публикувайте страницата

Съвет: Уеб частта HEAD HTML е идеална за добавяне на код към родителска страница, който автоматично ще се разпространи към всички дъщерни страници, създавайки инсталация за цялата секция.

Алтернативен метод 3: Персонализирани JavaScript файлове (За напреднали)

За разработчици, които предпочитат да управляват скриптовете като файлове:

Във вашия Kentico проект навигирайте до директорията ~/CMSScripts/Custom/
Създайте нов JavaScript файл (напр. asyntai-widget.js)
Добавете код за динамично зареждане на вашия 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);
})();

Използвайте този файл в header на вашия Master Page Template:

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

Важно: Този метод за напреднали изисква достъп до файловата система и познаване на структурата на директориите на Kentico. Уверете се, че имате правилните разрешения и винаги тествайте първо в среда за тестване.

Стъпка 3: Проверка на инсталацията

След като запазите промените и изчистите кеша, отворете уебсайта си в нов раздел на браузъра или в инкогнито прозорец. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Кликнете върху него, за да се уверите, че се отваря и работи правилно.

Не виждате уиджета? Уверете се, че сте запазили всички промени и сте изчистили кеша на Kentico (Settings > System > Clear cache). Опитайте да разгледате сайта си в инкогнито прозорец. Проверете конзолата на браузъра (F12) за JavaScript грешки, които може да попречат на зареждането на уиджета.