Как работает бот, как подключить его на сайт и что настроить в личном кабинете — от первого запуска до тонкой настройки.
Бот отвечает посетителям вашего сайта на основе загруженной вами базы знаний (RAG — retrieval-augmented generation): документов, страниц сайта и FAQ. Он не выдумывает ответы — если в базе знаний нет информации по вопросу, бот честно говорит об этом и предлагает связаться с оператором, вместо того чтобы придумывать что-то на ходу.
Виджет работает на сайте клиента полностью в браузере посетителя — это один <script>-тег, рендерящийся в изолированном Shadow DOM, поэтому он не конфликтует со стилями и скриптами сайта. Тот же бот и та же база знаний одновременно отвечают в Telegram, если канал подключён.
Универсальный способ, работающий на любом сайте независимо от движка. Bot ID и API-ключ выдаются в личном кабинете на странице настроек бота. Код добавляется один раз, перед закрывающим тегом </body>, на каждой странице сайта, где должен появляться бот:
<script src="https://scriptsystems.ru/widget.js" data-bot-id="ВАШ_BOT_ID" data-api-key="ВАШ_API_КЛЮЧ" data-color="#4f46e5" ></script>
Готовый сниппет с уже подставленными данными вашего бота показан в личном кабинете на странице бота, в разделе «Установка на сайт».
Модули автоматизируют вставку того же тега через привычную админку CMS — не нужно редактировать шаблоны вручную. Скачиваются на странице «Интеграции»:
Для самописных сайтов на Yii2, Django, Flask/FastAPI и других стеках отдельного модуля не требуется — тот же тег вставляется один раз в базовый layout/шаблон. Примеры для конкретных фреймворков — на странице «Интеграции».
Файл widget.js один и тот же для всех ботов — в нём нет встроенных данных клиента, только логика виджета; данные конкретного бота (Bot ID, API-ключ, цвет) передаются через атрибуты тега <script>. Обычно достаточно подключать его напрямую с scriptsystems.ru — так обновления и исправления приходят автоматически.
Если политика CSP на сайте клиента блокирует сторонние <script src>, файл можно скачать и разместить у себя — ссылка «Скачать widget.js» есть в личном кабинете на странице настроек бота, в разделе «Установка на сайт». При самостоятельном хостинге обновления не будут приходить автоматически — файл придётся перезаливать вручную.
Прежде чем виджет заработает на сайте, домен нужно подтвердить через TXT-запись DNS — это защищает от подключения бота на чужом сайте без ведома владельца. Без подтверждённого домена виджет не откроется ни на одном сайте, даже с правильно вставленным кодом. Управление доменами — в личном кабинете на странице бота, вкладка «Домены».
В настройках бота можно задать системные инструкции — как боту представляться, в каком тоне отвечать, что предлагать в конце диалога (например, оставить контакт). Инструкции применяются ко всем каналам бота (сайт и Telegram) одинаково.
Источники базы знаний — загруженные документы, ссылки на страницы сайта или готовый FAQ. Бот ищет релевантные фрагменты по вопросу посетителя и отвечает, опираясь на них, а не на общие догадки о вашем бизнесе. Количество источников, максимальный размер одного файла и объём распознаваемого текста ограничены тарифом (раздел «Тарифы и лимиты» ниже).
На странице настроек бота можно настроить, без единой строчки кода:
По умолчанию виджет показывается на всех страницах подтверждённого домена. Правилами показа можно ограничить бота отдельными страницами или масками URL (например, только на страницах каталога) — полезно, если на сайте несколько разделов и бот должен появляться не везде. Количество правил ограничено тарифом.
Тот же бот и та же база знаний, что и в виджете на сайте — отвечает в Telegram без дополнительной настройки логики. Чтобы подключить: создайте бота у @BotFather в Telegram, скопируйте выданный токен и вставьте его в личном кабинете: страница бота → «Каналы» → Telegram.
Лиды, собранные ботом (контакты, оставленные в диалоге), можно пересылать в свою CRM одним HTTP-запросом — укажите URL вебхука в личном кабинете: страница бота → «Каналы» → «CRM (вебхук)». Количество вложений к заявкам в месяц (файлы, приложенные посетителем к обращению) ограничено тарифом.
Каждый бот использует отдельный API-ключ, который подставляется в код виджета (data-api-key). Ключ показывается в открытом виде только один раз — сразу после создания бота или перевыпуска. Перевыпустить ключ можно на странице бота в любой момент — например, если он случайно оказался в публичном репозитории; после перевыпуска старый ключ перестаёт работать, и код на сайте нужно обновить.
Обычная сессия в личном кабинете действует 3 дня. На странице входа есть переключатель «Запомнить меня на 10 дней» — с ним сессия не запрашивает пароль повторно дольше. Если сессия истекла, при следующем действии в личном кабинете вы автоматически будете перенаправлены на страницу входа.
Каждый тариф ограничивает число ботов, сообщений в месяц, источников базы знаний, доменов, правил показа и вложений к заявкам — актуальные цифры и цены смотрите на странице «Тарифы». Лимит сообщений считается за текущий расчётный период подписки и обнуляется в начале следующего периода. При достижении лимита бот не отвечает до продления или перехода на тариф выше — в личном кабинете заранее появляется уведомление об этом.
Нужно ли программировать?
Нет. Инструкции для бота, база знаний, каналы и правила показа настраиваются в личном кабинете — без разработчика. На сайт нужно вставить один готовый фрагмент кода, это займёт пару минут.
Бот отключён — почему виджет всё ещё виден на сайте?
Не должен быть виден — при отключении бота виджет перестаёт отображаться на всех подтверждённых доменах в течение нескольких минут (пока не истечёт короткое кэширование файла виджета в браузере посетителя).
Что будет, если закончится тариф?
Боты перестают отвечать до продления подписки или перехода на другой тариф; настройки, база знаний и история диалогов при этом сохраняются.
Остались вопросы?
Напишите нам через форму обратной связи на главной странице.
Скрипт Системы