Как добавить ИИ-чат-бот Asyntai в Kentico

Пошаговое руководство для сайтов на Kentico CMS

Платформа:

Шаг 1: Получите код встраивания

Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:

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

Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.

Шаг 2: Добавьте код в шаблон главной страницы (рекомендуется)

Чтобы добавить чат-бот на все страницы сайта Kentico сразу, используйте метод главного шаблона страницы:

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

Совет: Использование главного шаблона страницы гарантирует появление чат-бота на каждой странице, наследующей этот шаблон. Это наиболее эффективный метод развёртывания на всём сайте в Kentico.

Альтернативный способ 1: Заголовок шаблона страницы

Если вы хотите добавить чат-бот только на определённые страницы:

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

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

Нажмите Save
Все страницы, использующие этот шаблон, теперь будут включать чат-бот

Примечание: Этот метод полезен, когда вы хотите добавить чат-бот в определённые разделы сайта, использующие один шаблон страницы, а не на весь сайт.

Альтернативный способ 2: HEAD HTML Web Part

Для более точного контроля на отдельных страницах или для наследуемого 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);
})();

Ссылайтесь на этот файл в заголовке шаблона главной страницы:

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

Важно: Этот продвинутый метод требует доступа к файловой системе и знания структуры директорий Kentico. Убедитесь, что у вас есть необходимые права доступа, и всегда сначала тестируйте в промежуточной среде.

Шаг 3: Проверка установки

После сохранения изменений и очистки кэша откройте сайт в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.

Виджет не отображается? Убедитесь, что вы сохранили все изменения и очистили кэш Kentico (Настройки > Система > Очистить кэш). Попробуйте открыть сайт в режиме инкогнито. Проверьте консоль браузера (F12) на наличие ошибок JavaScript, которые могут препятствовать загрузке виджета.