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