Повернутися до панелі керування

Документація

Дізнайтеся, як використовувати Asyntai

Початок роботи
Встановлення База знань Як ШІ отримує доступ до вашого контенту Підключіть свій сайт Протестувати ШІ Керування сайтами Поради щодо інструкцій для ШІ Перехід з іншого чат-бота Порівняння тарифів
Функції
Панель Ask AI Рядок ШІ-пошуку Сканування сайту Прогалини у знаннях Картки товарів Динамічні картки товарів Динамічні зображення Контекст користувача Власні інструменти Параметри посилань Проактивні повідомлення Моніторинг у реальному часі Підключення оператора Ескалація Сповіщення ШІ Сповіщення в браузері Щоденний звіт Потік даних у реальному часі Фід даних у реальному часі Max Учасники команди Єдиний вхід Двофакторна автентифікація Показувати зображення Розпізнавання зображень Віджет перекладу Локалізація Прозорість ШІ Ліди Розумний збір лідів Тікети підтримки ШІ-відповіді на листи Категорії чатів Довідковий центр Бронювання Голосовий агент Вбудовування Виключити сторінки Заблоковані IP Політика зберігання Режим нульового зберігання Маскування PII Класифікатор відповідей Access Tags Закріплення версії віджета Журнал аудиту Пропозиції відповідей Подальші повідомлення Розпізнавання мовлення Завантаження стенограми Вбудований чат Вбудовування через iframe

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

Покрокова інструкція для веб-сайтів Craft 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: Редагування шаблону макету (Рекомендовано)

Найпростіший спосіб додати чат-бот на всі сторінки - це редагування головного шаблону макету:

  1. Отримайте доступ до файлів проекту Craft CMS через FTP, SSH або ваш редактор коду
  2. Перейдіть до каталогу templates/
  3. Знайдіть головний файл макету (зазвичай називається _layout.twig, _layout.html або знаходиться в templates/_layouts/)
  4. Знайдіть закриваючий тег </body>
  5. Вставте ваш код для вставки Asyntai безпосередньо перед тегом </body>
  6. Збережіть файл

Порада: Додавання скрипту перед закриваючим тегом </body> забезпечує його завантаження після контенту сторінки, що рекомендується для чат-віджетів і не сповільнює завантаження сторінки.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS надає вбудований тег Twig для реєстрації JavaScript:

  1. Відкрийте головний шаблон макету
  2. Додайте наступний код перед закриваючим тегом </body>:
    {% 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); })(); {% endjs %}
  3. Замініть YOUR_WIDGET_ID на ваш фактичний ID віджету
  4. Збережіть файл

Примітка: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Альтернатива: Створення окремого файлу включення

Для кращої організації створіть окремий файл включення:

  1. Створіть новий файл: templates/_includes/chatbot.twig (або .html)
  2. Додайте код вбудовування 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>
  3. У головному шаблоні макету включіть цей файл перед </body>:
    {% include '_includes/chatbot' %}
  4. Збережіть обидва файли

Порада: Використання файлу включення дозволяє легко увімкнути або вимкнути чат-бот на всьому сайті, закоментувавши один рядок.

Альтернатива: Умовне завантаження

Щоб завантажити чат-бот лише на певних сторінках або в певних розділах:

  1. У вашому шаблоні макету або сторінки використовуйте умови Twig:
    {% if entry.showChatbot ?? true %} <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> {% endif %}
  2. Або перевірте конкретні розділи:
    {% if craft.app.request.segments[0] != 'admin' %} <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> {% endif %}

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

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

Не бачите віджет? Переконайтеся, що ви зберегли файл шаблону та що ви редагуєте правильний шаблон макету, який використовують ваші сторінки. Очистіть кеш браузера або перегляньте в режимі інкогніто. Якщо використовується кешування шаблонів, очистіть кеш Craft CMS з панелі керування в розділі Utilities > Clear Caches.

Розташування шаблону: Розташування шаблонів Craft CMS може відрізнятися залежно від налаштувань вашого проекту. Типові місця включають templates/_layout.twig, templates/_layouts/main.twig або templates/_base.twig. Перевірте існуючі шаблони, щоб знайти, де визначений тег </body>.