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

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

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

Как добавить ИИ-чат-бот 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)

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

  1. Войдите в Umbraco Backoffice
  2. Перейдите в Settings in the left sidebar
  3. Разверните Шаблоны
  4. Нажмите на шаблон Master (или основной шаблон макета, который использует ваш сайт)
  5. Найдите закрывающий тег </body>
  6. Вставьте код встраивания Asyntai перед тегом </body>
  7. Нажмите \"Save\"

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

Альтернатива: Через тип документа настроек

Для большей гибкости можно добавить пользовательское поле для управления скриптами футера:

  1. Перейдите в Settings → Document Types
  2. Редактировать тип документа Настройки сайта (или создать его, если он не существует)
  3. Добавьте новое свойство с именем «Footer Scripts» и типом данных Textarea
  4. Сохранить тип документа
  5. Перейдите в Content and edit your Site Settings node
  6. Вставьте код встраивания Asyntai в поле «Скрипты футера»
  7. В вашем Master template добавьте этот код перед </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Сохраните контент и шаблон

Примечание: Использование @Html.Raw() важно для корректного отображения тегов script без HTML-кодирования.

Альтернатива: Через папку скриптов

Вы также можете создать JavaScript-файл в Umbraco Backoffice:

  1. Перейдите в Settings → Scripts
  2. Нажмите правой кнопкой мыши на Scripts и выберите «Создать»
  3. Создайте new file called asyntai-chatbot.js
  4. Добавьте следующий код:
    (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);
    })();
  5. Замените YOUR_WIDGET_ID на ваш реальный ID виджета
  6. Сохранить файл
  7. Добавьте этот скрипт в Master template перед </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Альтернатива: Через RenderSection

If you only want the chatbot on specific pages:

  1. В вашем Master template добавьте перед </body>:
    @RenderSection("footerScripts", required: false)
  2. В шаблоне конкретной страницы, где нужен чат-бот, добавьте:
    @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 может потребоваться перезапуск приложения или очистка кэша.