Как добавить ИИ-чат-бот Asyntai в Umbraco
Пошаговое руководство для сайтов на Umbraco CMS
Шаг 1: Get Your Embed Code
Сначала перейдите на Панель управления Asyntai и прокрутите вниз до раздела «Код для встраивания». Скопируйте уникальный код, который выглядит так:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Примечание: Код выше — всего лишь пример. Вы должны скопировать свой уникальный код для встраивания с вашей Панели управления, так как он содержит ваш персональный идентификатор виджета.
Шаг 2: Edit Master Template (Recommended)
Самый простой способ добавить чат-бот на все страницы — отредактировать Мастер-шаблон:
- Войдите в Umbraco Backoffice
- Перейдите в Settings in the left sidebar
- Разверните Шаблоны
- Нажмите на шаблон Master (или основной шаблон макета, который использует ваш сайт)
- Найдите закрывающий тег
</body> - Вставьте код встраивания Asyntai перед тегом
</body> - Нажмите \"Save\"
Совет: Добавление скрипта перед закрывающим тегом </body> гарантирует загрузку после контента страницы — это рекомендуется для чат-виджетов и не замедлит загрузку страницы.
Альтернатива: Через тип документа настроек
Для большей гибкости можно добавить пользовательское поле для управления скриптами футера:
- Перейдите в Settings → Document Types
- Редактировать тип документа Настройки сайта (или создать его, если он не существует)
- Добавьте новое свойство с именем «Footer Scripts» и типом данных Textarea
- Сохранить тип документа
- Перейдите в Content and edit your Site Settings node
- Вставьте код встраивания Asyntai в поле «Скрипты футера»
- В вашем Master template добавьте этот код перед
</body>:@Html.Raw(Model.Value("footerScripts")) - Сохраните контент и шаблон
Примечание: Использование @Html.Raw() важно для корректного отображения тегов script без HTML-кодирования.
Альтернатива: Через папку скриптов
Вы также можете создать JavaScript-файл в Umbraco Backoffice:
- Перейдите в Settings → Scripts
- Нажмите правой кнопкой мыши на Scripts и выберите «Создать»
- Создайте new file called asyntai-chatbot.js
- Добавьте следующий код:
(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);
})(); - Замените
YOUR_WIDGET_IDна ваш реальный ID виджета - Сохранить файл
- Добавьте этот скрипт в Master template перед
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Альтернатива: Через RenderSection
If you only want the chatbot on specific pages:
- В вашем Master template добавьте перед
</body>:@RenderSection("footerScripts", required: false) - В шаблоне конкретной страницы, где нужен чат-бот, добавьте:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Шаг 3: Verify Installation
После сохранения изменений откройте сайт в новой вкладке браузера или в режиме инкогнито. Вы должны увидеть кнопку виджета чата в правом нижнем углу. Нажмите на неё, чтобы убедиться, что всё работает.
Виджет не отображается? Убедитесь, что вы сохранили шаблон после внесения изменений. Попробуйте очистить кэш браузера или открыть сайт в режиме инкогнито. При использовании Umbraco Cloud изменения деплоятся автоматически. На собственном хостинге Umbraco может потребоваться перезапуск приложения или очистка кэша.
Weebly