Как установить AI‑чат на сайт

Инструкция по установке виджета INWISE AI на сайт: разрешённые домены, JavaScript‑код, проверка подключения и управление чатом. Ниже — рабочие рекомендации, которые помогут настроить функцию осознанно и проверить результат до публикации.

Как устроено подключение

INWISE AI подключается к сайту одним асинхронным JavaScript‑фрагментом. Он загружает кнопку и окно чата, не блокируя отображение основного контента. Точный код формируется для вашего проекта в личном кабинете.

<!-- Пример размещения. Точный код скопируйте из своего кабинета. -->
<script>
  // Конфигурация проекта и асинхронная загрузка виджета
</script>

Размещайте фрагмент перед закрывающим тегом </body> или через принятый в проекте менеджер компонентов. Не копируйте идентификаторы между разными проектами.

Настройка разрешённых доменов

До публикации добавьте адреса сайтов, на которых виджет имеет право работать. Указывайте полный origin: протокол, домен и, если используется, порт. Рабочий сайт и тестовый стенд добавляются отдельно.

https://example.ru — основной сайт;
https://lk.example.ru — отдельный поддомен;
http://localhost:5173 — локальная проверка, если она разрешена вашей политикой.

Важно: поддомен не наследует разрешение автоматически. Добавляйте каждый origin, где действительно должен открываться помощник.

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

Очистите кеш страницы и откройте сайт в новой вкладке.
Убедитесь, что кнопка появилась в выбранном углу.
Откройте чат и задайте контрольный вопрос.
Проверьте мобильную версию и страницы с фиксированными панелями.
Убедитесь, что другие компоненты сайта не перекрывают виджет.

Управление из интерфейса сайта

Для собственных кнопок и сценариев можно использовать публичные команды чата. Они пригодятся, когда чат должен открываться после клика «Задать вопрос» или сбрасываться при смене пользователя.

SupportChat.open()   // открыть чат
SupportChat.close()  // закрыть чат
SupportChat.reset()  // начать новую локальную сессию

Если виджет не появился

проверьте, включён ли виджет в настройках внешнего вида;
сверьте текущий origin со списком разрешённых доменов;
убедитесь, что фрагмент вставлен полностью и один раз;
проверьте Content Security Policy сайта;
посмотрите, не блокирует ли запрос корпоративный фильтр или расширение браузера.

Частые вопросы

Сколько времени занимает установка?

На обычный сайт — несколько минут: добавить домен, скопировать фрагмент и опубликовать страницу. В проектах со строгой CSP может понадобиться согласование разрешённых источников.

Можно ли установить один виджет на несколько сайтов?

Да, если эти сайты добавлены в разрешённые домены проекта и используют назначенный ему фрагмент подключения.

Виджет повлияет на стили сайта?

Интерфейс изолирован от стилей страницы. После установки всё равно рекомендуется проверить основные разрешения экрана и компоненты с высоким z-index.