Як додати AI чат-бот Asyntai до Kentico

Покрокова інструкція для веб-сайтів Kentico CMS

Платформа:

Крок 1: Отримайте код для вставки

Спочатку перейдiть до вашої Панелi керування Asyntai та прокрутiть вниз до роздiлу "Код для вставки". Скопiюйте унiкальний код для вставки, який виглядатиме так:

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

Примітка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.

Крок 2: Додавання коду до головного шаблону сторінки (Рекомендовано)

Щоб додати чат-бот на всi сторiнки вашого сайту Kentico одночасно, використовуйте метод головного шаблону сторiнки:

Увiйдiть до адмiн-панелi Kentico та перейдiть до застосунку Page templates
Знайдiть та вiдкрийте свiй головний шаблон сторiнки (шаблон, що використовується на всiх сторiнках)
Натисніть на вкладку Header в редакторі шаблонів
У розділі заголовка вставте код вбудовування Asyntai
Як альтернативу, додайте код до макету шаблону перед закриваючим тегом </head>
Натисніть Save, щоб застосувати зміни
Очистіть кеш вашого сайту та перевірте зміни на робочому сайті

Порада: Використання головного шаблону сторiнки забезпечує появу чат-бота на кожнiй сторiнцi, що успадковує цей шаблон. Це найефективнiший метод для розгортання на всьому сайтi в Kentico.

Альтернативний метод 1: Заголовок шаблону сторінки

Якщо ви хочете додати чат-бот лише до конкретних шаблонів сторінок:

Перейдіть до застосунку Page templates у Kentico Admin
Виберіть конкретний шаблон сторінки, який хочете редагувати
Натисніть на вкладку Header
Додайте код вбудовування Asyntai за допомогою тегу script:

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

Натисніть Save
Усі сторінки, що використовують цей шаблон, тепер містимуть чат-бот

Примітка: Цей метод корисний, коли ви хочете додати чат-бот до конкретних роздiлiв вашого сайту, що використовують один i той же шаблон сторiнки, а не до всього сайту.

Альтернативний метод 2: Веб-частина HEAD HTML

Для бiльш детального контролю на конкретних сторiнках або для успадкування JavaScript на пiдсторiнках:

Вiдкрийте сторiнку, яку хочете редагувати, в редакторi сторiнок Kentico
Додайте нову веб-частину на сторiнку (бажано на батькiвську сторiнку для успадкування)
Знайдіть та виберіть веб-частину HEAD HTML
У конфігурації веб-частини вставте код вбудовування Asyntai
Налаштуйте веб-частину як успадковувану, якщо ви хочете, щоб дочiрнi сторiнки мали чат-бот
Натисніть OK, щоб зберегти веб-частину
Збережіть та опублікуйте сторінку

Порада: Веб-частина HEAD HTML iдеально пiдходить для додавання коду на батькiвську сторiнку, який автоматично поширюватиметься на всi дочiрнi сторiнки, створюючи встановлення на рiвнi роздiлу.

Альтернативний метод 3: Власні файли JavaScript (Розширений)

Для розробників, які надають перевагу керуванню скриптами як файлами:

У вашому проектi Kentico перейдiть до каталогу ~/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);
})();

Посилайтеся на цей файл у заголовку вашого головного шаблону сторінки:

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

Важливо: Цей розширений метод вимагає доступу до файлової системи та знання структури каталогiв Kentico. Переконайтеся, що у вас є належнi дозволи, i завжди спочатку тестуйте в тестовому середовищi.

Крок 3: Перевірте встановлення

Пiсля збереження змiн та очищення кешу вiдкрийте свiй веб-сайт у новiй вкладцi браузера або в режимi iнкогнiто. Ви повиннi побачити кнопку чат-вiджету в нижньому правому кутi. Натиснiть на неї, щоб переконатися, що вона вiдкривається та працює коректно.

Не бачите віджет? Переконайтеся, що ви зберегли всi змiни та очистили кеш Kentico (Settings > System > Clear cache). Спробуйте переглянути сайт у режимi iнкогнiто. Перевiрте консоль браузера (F12) на наявнiсть помилок JavaScript, якi можуть перешкоджати завантаженню вiджету.