Виджет чата на сайт
Виджет — это ваш ИИ-ассистент в маленьком «пузыре» в правом нижнем углу сайта. Посетители задают вопросы без регистрации, а ответы приходят из вашей базы знаний.
Создание виджета
- В шапке чата нажмите «🪶 Виджет» — откроется страница управления виджетами.
- Нажмите «➕ Создать виджет» и дайте ему название (его увидят посетители).
- В карточке виджета скопируйте готовый код вставки кнопкой «📋 Копировать».
Один аккаунт может иметь несколько виджетов — например, отдельный для корпоративного сайта и отдельный для интернет-магазина.
Установка на сайт
Вставьте скопированный код в 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 = и на поддоменах |
| Цвет кнопки | Под стиль сайта |
| Отключить / Включить | Пауза виджета без удаления (код на сайте перестанет отвечать) |
Что видит и что не видит посетитель
- ✅ Ответы из вашей базы знаний в красивом чат-окне, история его переписки сохраняется в браузере.
- ✅ Приветствие формируется из вашего персонального промта — бот «говорит голосом компании».
- ❌ Ссылок на файлы-источники посетитель не видит — они остаются только в вашем основном чате.
- Все вопросы посетителей попадают к вам в 📊 Аналитику вместе с вашими собственными.
Безопасность
- Код вставки содержит персональный ключ — не публикуйте его публично, виджет с таким ключом может ответить и с чужого сайта (если не заданы разрешённые домены). Удалить или отключить виджет можно в один клик.
- На виджет действуют лимиты: не более 10 сообщений в минуту от одного посетителя и дневной лимит на весь виджет.
- История каждого посетителя изолирована: посетители не видят переписку друг друга, и она не смешивается с вашим основным чатом.
Частые вопросы
Виджет не появился после вставки кода. Проверьте, что код вставлен именно на тех страницах, где ждёте кнопку, и что сайт работает по HTTPS (или открываете на localhost). На Tilda блоки «HTML-код» иногда обрезают <script> — используйте настройку кодов страницы.
Кнопка есть, а чат пустой. Откройется ли виджет при переходе по прямой ссылке /widget/ключ на вашем домене — если там «не настроен для данного сайта», добавьте домен в разрешённые.
Как изменить ключ? Удалите виджет и создайте новый, затем обновите код на сайте.