Назад к панели управления

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

Узнайте, как использовать Asyntai

Как добавить ИИ-чат-бот Asyntai на любой сайт

Universal guide for HTML, custom sites, and static generators

Получить код встраивания

Шаг 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: Add to Your HTML File

Самый простой способ добавить чат-бот — вставить код встраивания непосредственно в ваш HTML-файл:

  1. Откройте HTML-файл в текстовом редакторе
  2. Найдите закрывающий тег </body>
  3. Вставьте код встраивания Asyntai перед тегом </body>
  4. Сохранить файл
<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->

  <!-- Asyntai Chatbot - Add before closing body tag -->
  <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>
</html>

Совет: Добавление скрипта перед закрывающим тегом </body> гарантирует загрузку после контента страницы — это оптимально для производительности и не замедлит страницу.

Для многостраничных сайтов

If your website has multiple HTML pages, you have several options:

Вариант A: добавить на каждую страницу

Добавьте код вставки в каждый HTML-файл, на котором должен появляться чат-бот.

Вариант B: использовать общий включаемый файл футера

If you're using server-side includes (SSI), PHP includes, or similar:

  1. Создайте footer.html (or footer.php) file
  2. Добавьте код встраивания Asyntai в этот файл
  3. Подключите этот файл footer на всех страницах:
    <!-- For PHP -->
    <?php include 'footer.php'; ?>

    <!-- For SSI -->
    <!--#include virtual="/footer.html" -->

Вариант C: динамическая загрузка через JavaScript

Создайте single JavaScript file that loads the chatbot on all pages:

  1. Создайте file called asyntai-loader.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);
    })();
  2. Замените YOUR_WIDGET_ID на ваш реальный ID виджета
  3. Подключите этот скрипт на всех страницах:
    <script src="/js/asyntai-loader.js"></script>

Для генераторов статических сайтов

Если вы используете генератор статических сайтов, добавьте код встраивания в базовый макет или шаблон:

Jekyll

Добавьте в _includes/footer.html или _layouts/default.html

Hugo

Добавьте в layouts/partials/footer.html или layouts/_default/baseof.html

Gatsby

Add to gatsby-browser.js or use gatsby-ssr.js

Next.js

Добавьте в pages/_document.js или используйте компонент next/script

Nuxt.js

Add to nuxt.config.js under head.script

Eleventy (11ty)

Добавьте в базовый макет в _includes/

Astro

Добавьте в src/layouts/Layout.astro перед </body>

VuePress

Добавьте в .vuepress/config.js в раздел head

Для приложений React / Vue / Angular

Для одностраничных приложений (SPA) можно добавить скрипт в index.html или загрузить его динамически:

React (метод index.html)

<!-- In public/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

React (метод useEffect)

// In your App.js or a component
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://asyntai.com/static/js/chat-widget.js';
  script.async = true;
  script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
  document.body.appendChild(script);
  return () => document.body.removeChild(script);
}, []);

Vue (в main.js или App.vue)

// In mounted() or onMounted()
const script = document.createElement('script');
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.async = true;
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);

Angular (в index.html)

<!-- In src/index.html, before </body> -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Шаг 3: Verify Installation

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

Виджет не отображается? Убедитесь, что скрипт размещён перед тегом </body>. Проверьте отсутствие ошибок JavaScript в консоли браузера (нажмите F12, чтобы открыть инструменты разработчика). Попробуйте очистить кэш браузера или открыть страницу в режиме инкогнито.

Важно: Чат-бот требует, чтобы ваш сайт был доступен по протоколу HTTP или HTTPS (а не открывался непосредственно как файл). При локальном тестировании используйте локальный сервер разработки.