Як додати AI чат-бот Asyntai до Umbraco
Покрокова інструкція для вебсайтів на Umbraco 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: Редагування головного шаблону (Рекомендовано)
Найпростіший спосіб додати чат-бот на всі сторінки - відредагувати ваш головний шаблон:
- Увійдіть до вашого бекофісу Umbraco
- Перейдіть до Settings на лівій бічній панелі
- Розгорніть Templates
- Натисніть на ваш шаблон Master (або основний шаблон макета, який використовує ваш сайт)
- Знайдіть закриваючий тег
</body> - Вставте ваш код для вставки Asyntai безпосередньо перед тегом
</body> - Натисніть "Save"
Порада: Додавання скрипту перед закриваючим тегом </body> забезпечує його завантаження після контенту сторінки, що рекомендується для чат-віджетів і не сповільнює завантаження сторінки.
Альтернатива: Використання типу документа Site Settings
Для більшої гнучкості ви можете додати власне поле для управління скриптами футера:
- Перейдіть до Settings → Document Types
- Відредагуйте тип документа Site Settings (або створіть його, якщо він не існує)
- Додайте нову властивість з назвою "Footer Scripts" з типом даних Textarea
- Збережіть тип документа
- Перейдіть до Content та відредагуйте вузол Site Settings
- Вставте ваш код вбудовування Asyntai в поле Footer Scripts
- У вашому головному шаблоні додайте цей код перед
</body>:@Html.Raw(Model.Value("footerScripts")) - Збережіть як контент, так і шаблон
Примітка: Використання @Html.Raw() важливе для правильного рендерингу тегів script без HTML-кодування.
Альтернатива: Використання папки Scripts
Ви також можете створити файл JavaScript у бекофісі Umbraco:
- Перейдіть до Settings → Scripts
- Натисніть правою кнопкою миші на Scripts та виберіть "Create"
- Створіть новий файл з назвою 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 віджету - Збережіть файл
- Включіть цей скрипт у ваш головний шаблон перед
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Альтернатива: Для окремих сторінок з RenderSection
Якщо ви хочете чат-бот лише на конкретних сторінках:
- У вашому головному шаблоні додайте перед
</body>:@RenderSection("footerScripts", required: false) - У конкретному шаблоні сторінки, де ви хочете чат-бот, додайте:
@section footerScripts {
<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>
}
Крок 3: Перевірте встановлення
Після збереження змін відвідайте свій веб-сайт у новій вкладці браузера або в режимі інкогніто. Ви повинні побачити кнопку чат-віджету в нижньому правому куті. Натисніть на неї, щоб переконатися, що вона відкривається та працює коректно.
Не бачите віджет? Переконайтеся, що ви зберегли шаблон після внесення змін. Спробуйте очистити кеш браузера або переглянути у вікні інкогніто. Якщо ви використовуєте Umbraco Cloud, зміни повинні розгортатися автоматично. Для самостійно розміщеного Umbraco вам може знадобитися перезапустити додаток або очистити кеш.
Weebly