Виджет чата на сайт
Виджет — это ваш ИИ-ассистент в маленьком «пузыре» в правом нижнем углу сайта. Посетители задают вопросы без регистрации, а ответы приходят из вашей базы знаний.
Создание виджета
- В шапке чата нажмите «🪶 Виджет» — откроется страница управления виджетами.
- Нажмите «➕ Создать виджет» и дайте ему название (его увидят посетители).
- В карточке виджета скопируйте готовый код вставки кнопкой «📋 Копировать».
Один аккаунт может иметь несколько виджетов — например, отдельный для корпоративного сайта и отдельный для интернет-магазина.
Установка на сайт
Вставьте скопированный код в HTML страницы перед закрывающим тегом </body>:
<script src="https://ragstone.ru/widget.js" data-key="ВАШ_КЛЮЧ" async></script>- Tilda: настройки страницы → «HTML-код для <head> и <body>» (или блок «HTML-код»).
- WordPress: внешний вид → редактор темы (footer.php) или плагин «Insert Headers and Footers».
- Конструкторы (Flexbe, Craftum, WooCommerce): раздел «Коды» / «HTML-блок» в настройках сайта.
- Свой сайт: прямо в шаблон страницы.
После вставки кода в углу сайта появится круглая кнопка — по нажатию открывается окно чата.
Настройки виджета
| Поле | Что делает |
|---|---|
| Название | Имя ассистента в шапке чата и в подсказке кнопки |
| Дневной лимит вопросов | Максимум вопросов всех посетителей за сутки — защита от перерасхода вашего LLM-ключа. По исчерпании бот честно сообщает, что лимит кончился |
| Разрешённые домены | На каких сайтах работает виджет (через запятую). Пусто = на любом. *.shop.ru = и на поддоменах |
| Цвет кнопки | Под стиль сайта |
| Пауза бота | Гости продолжают писать, но отвечает человек: бот молчит во всех разговорах виджета |
| Авто-возврат бота, мин | Через сколько минут простоя разговор сам возвращается боту (0 — не возвращать) |
| Приветствие гостю | Текст, который посетитель видит при открытии чата. Пусто — берётся общее приветствие (окно «📝 Мой промт»), а если и его нет — приветствие из роли в промте |
| Отключить / Включить | Пауза виджета без удаления (код на сайте перестанет отвечать) |
Отвечать посетителям вручную, перехватывать разговор и возвращать его боту — в разделе Диалоги и ответы вручную.
Приветствие
Посетитель видит приветствие при открытии чата. Настроить текст можно на трёх уровнях — от частного к общему:
- Своё у конкретного виджета — поле «Приветствие гостю» в его карточке. У корпоративного сайта и у интернет-магазина могут быть разные приветствия.
- Общее для всех виджетов и ботов — окно «📝 Мой промт» в шапке чата, поле «Общее приветствие». Одна фраза сразу для всех ваших виджетов и для MAX-бота.
- Если нигде не задано — приветствие собирается из роли в персональном промте: «Привет! Я — {роль}. Задай мне вопрос по базе знаний».
Приветствие появляется при открытии чата у нового посетителя и заново после кнопки «🆕 Новый диалог» — новый диалог начинается так же, как первый. После «🗑️ Очистить» переписка пустая, приветствие остаётся на месте. В тестовом чате кабинета показывается то же приветствие, что увидит посетитель, — так его удобно проверить до публикации.
Что видит и что не видит посетитель
- ✅ Ответы из вашей базы знаний в красивом чат-окне, история его переписки сохраняется в браузере.
- ✅ Приветствие — своё для этого виджета, общее для всех каналов или собранное из вашего персонального промта: бот «говорит голосом компании».
- ❌ Ссылок на файлы-источники посетитель не видит — они остаются только в вашем основном чате.
- Все вопросы посетителей попадают к вам в 📊 Аналитику вместе с вашими собственными.
Безопасность
- Код вставки содержит персональный ключ — не публикуйте его публично, виджет с таким ключом может ответить и с чужого сайта (если не заданы разрешённые домены). Удалить или отключить виджет можно в один клик.
- На виджет действуют лимиты: не более 10 сообщений в минуту от одного посетителя и дневной лимит на весь виджет.
- История каждого посетителя изолирована: посетители не видят переписку друг друга, и она не смешивается с вашим основным чатом.
Частые вопросы
Виджет не появился после вставки кода. Проверьте, что код вставлен именно на тех страницах, где ждёте кнопку, и что сайт работает по HTTPS (или открываете на localhost). На Tilda блоки «HTML-код» иногда обрезают <script> — используйте настройку кодов страницы.
Кнопка есть, а чат пустой. Откройется ли виджет при переходе по прямой ссылке /widget/ключ на вашем домене — если там «не настроен для данного сайта», добавьте домен в разрешённые.
Как изменить ключ? Удалите виджет и создайте новый, затем обновите код на сайте.