Текстовый виджет — это умный онлайн-чат, который вы устанавливаете на свой сайт. В отличие от обычных чатов, где оператор должен отвечать вручную, здесь с вашими клиентами общается искусственный интеллект (ИИ).

Создание нового виджета

Перейдите в раздел Текстовые AI виджеты.
Нажмите кнопку Создать.
Заполните основные настройки (Название, Приветствие).
Важно! Привяжите к виджету созданную AI Функцию (AI Tool). Если вы этого не сделаете, виджет не будет понимать, как ему общаться и в какой роли выступать.

Настройка виджета

После создания вы можете тонко настроить виджет, нажав на иконку карандаша (редактировать) в таблице.

Основные параметры

Внешний вид: Измените цвет кнопки и окна чата, чтобы он подходил под корпоративные цвета вашего бренда. Вы также можете изменить текст приветственного сообщения.
Поведение ИИ: Выберите нужную AI Функцию. Именно от неё зависит стиль общения бота и то, какие Базы Знаний он использует для поиска ответов на вопросы.

💡 Совет: Если бот отвечает неправильно или выдумывает факты (галлюцинирует), проблема скорее всего кроется не в виджете, а в недостаточной информации в привязанной Базе Знаний или неточном промпте в AI Функции.

Установка виджета на сайт

Чтобы виджет появился на вашем сайте:

В списке виджетов нажмите кнопку Код (иконка вида < >) рядом с нужным виджетом.
Скопируйте предложенный HTML-код.
Вставьте этот скрипт в HTML-разметку вашего сайта перед закрывающим тегом </body> или внутри head.

Где искать настройки вставки в популярных CMS:

Tilda: Редактор сайта -> Настройки сайта -> Ещё -> HTML-код для вставки внутрь <head> или <body>.
WordPress: Используйте плагин "Insert Headers and Footers" или вставьте код в файл footer.php вашей темы.
Bitrix (Битрикс): Добавьте код в шаблон сайта (header.php или footer.php).

Справочник настроек виджета

В интерфейсе виджетов вам встретятся несколько важных окон настройки. Ниже подробно описано каждое поле в них.

1. Мастер создания виджета

Это окно появляется при нажатии кнопки Создать. Оно состоит из 6 шагов:

Шаг 1: Основное.
- Название виджета: Внутреннее имя (например: «Ассистент поддержки»).
- Приветственное сообщение: Первое сообщение, которое бот напишет клиенту.
Шаг 2: Ваш сайт.
- Адрес сайта: Укажите URL. ИИ перейдет по нему, прочитает контент и использует эти знания при автоматической генерации инструкции (промпта) на следующем шаге.
Шаг 3: AI (Интеллект).
- Имя ассистента: Как пользователя будут звать в чате (например, «Алекс»).
- Быстрый выбор роли / Описание роли: Кем будет ваш бот (например, «Менеджер по продажам»). Нажмите «Сгенерировать», и ИИ сам напишет себе сложную инструкцию.
- Системный промпт: Главная инструкция для ИИ, которую вы можете дописать вручную.
- Модель ИИ: Выбор нейросети (отличаются по скорости и цене).
Шаг 4: Внешний вид.
- Цвет темы: Основной цвет элементов чата.
- Аватар ассистента: Выбор иконки/картинки бота из предложенных вариантов.
Шаг 5: База знаний.
- Загрузка файлов: (PDF, DOCX, TXT), на основе которых бот будет консультировать клиентов.
Шаг 6: Готово.
- Итоговый предпросмотр того, как будет выглядеть чат на вашем сайте.

2. Редактирование виджета

Это основное окно управления. Открывается по клику на иконку «Карандаш» в списке виджетов. Состоит из множества вкладок:

Вкладка «Основные»:

Название виджета и Приветственное сообщение.
Активен: Выключатель виджета. Если выключен — чат пропадет с вашего сайта.
Часовой пояс бота: Влияет на понимание ботом слов вроде «сегодня» и «завтра».

Вкладка «Каналы»:

Telegram: Позволяет подключить бота к Telegram. Нажмите «Настроить», чтобы открыть окно ввода токена (см. ниже).
WhatsApp (Green API): Позволяет подключить бота к вашему номеру WhatsApp через сервис Green API.

Вкладка «AI Настройки»:

Включить AI: Если выключить, бот не будет отвечать на вопросы (чат будет работать только для перевода на оператора).
Потоковая генерация: Бот печатает ответ по буквам.
Модель ИИ: Выбор основной нейросети.
Системный промпт: Главная инструкция. Здесь же есть подсказки по переменным.
Креативность (Температура): От 0.3 (строго по фактам) до 2.0 (творчески).
Макс. токенов: Ограничение длины одного ответа.
Глубина диалога (History): Сколько предыдущих сообщений бот «помнит» для контекста (например, 10).
Уровень рассуждений (Reasoning): Доступно для моделей серии 'o1' — глубина обдумывания ответа.
Модель для простых задач: Выбор быстрой и дешевой нейросети для служебных фоновых задач (например, саммаризации).

Вкладка «Системные функции»:

Разрешить вызов оператора: Показывает кнопку перевода диалога на человека.
Работа по расписанию: Задает часы, когда оператор доступен (Начало/Конец/Часовой пояс).
Использовать память (ContextPlugin): ИИ будет запоминать важные факты о клиенте.
Семантическая маршрутизация (Fast Path): Использование дешевых моделей для мгновенного ответа на простые сообщения («привет»).
Разрешить голосовые сообщения / файлы: Клиенты смогут прикреплять аудио и документы. Устанавливается лимит (в МБ).

Вкладка «Внешний вид»:

Цвет темы: Основной.
Аватар: Готовые иконки, ссылка URL или загрузка вашей картинки.
Фон чата: Сплошной цвет, паттерн или загрузка вашей картинки на фон диалога.

Вкладка «Безопасность»:

Разрешенные домены: Список сайтов (через запятую), где разрешено грузить этот виджет. Защита от кражи кода.
Лимиты: Максимальное кол-во ответов ИИ в сутки для защиты от спама.

Вкладка «Кнопка»:

Настройки круглой кнопки, открывающей чат: Цвет, Градиент, Неоновое свечение, Пульсация, Расположение (слева/справа), Отступы от краев (X/Y) и выбор Иконки кнопки.

Вкладка «База знаний (RAG)»:

Использовать Базу Знаний: Привязка ранее созданной Базы Знаний.
Количество результатов: Сколько фрагментов текста из базы передавать ИИ.
Контекст поиска: Глубина анализа истории при поиске по базе.
Модель для рерайта: Вспомогательная нейросеть для поиска.

3. Интеграция с Telegram (Webhook)

Окно настройки Telegram (открывается из вкладки «Каналы» редактора).

Bot Token: Сюда нужно вставить токен, полученный от @@BotFather в Telegram (например, 12345:ABC-DEF).
Webhook URL: системный адрес, который бот пропишет в Telegram.
Кнопки: Прямо здесь вы можете «Установить Webhook», «Удалить» или проверить валидность токена.
Запретить новые сессии: Бот будет общаться только со старыми клиентами, игнорируя новых.
Канал активен: Общий рубильник интеграции.

4. Интеграция с WhatsApp (Green API)

Окно настройки WhatsApp (открывается из вкладки «Каналы» редактора). Для работы вам потребуется аккаунт в сервисе Green API.

Instance ID: Идентификатор вашего инстанса из личного кабинета Green API.
API Token: Секретный токен для доступа.
Webhook URL: системный адрес, который вы должны скопировать и вставить в настройки Green API в качестве адреса для получения уведомлений (входящих сообщений).
Запретить новые сессии: Аналогично Telegram, позволяет отключить реакцию бота на сообщения от новых номеров.
Канал активен: Включает и выключает обработку сообщений из WhatsApp.

5. Интеграция с Telegram (User Account через Green API)

Альтернативный метод подключения Telegram не через бота, а через обычный пользовательский аккаунт с использованием Green API.

API URL: Базовый URL вашего инстанса Green API (например, https://7103.api.greenapi.com).
ID Instance: Идентификатор инстанса Telegram в Green API.
API Token Instance: Ваш секретный токен инстанса.
Webhook URL: Адрес, который система автоматически установит в Green API по нажатию кнопки «Установить Webhook».
Канал активен: Включает и выключает работу бота в этом Telegram-аккаунте.

6. Дополнительные окна виджетов

Переменные Промпта: Информационное окно с таблицей тегов ({{Date}}, {{WidgetName}}), которые можно использовать в Системном Промпте.
Глобальные лимиты: Позволяет установить жесткие ограничения на длину сообщений и частоту запросов для дополнительной безопасности.
Тестовый чат: (Иконка глаза в таблице). Позволяет проверить работу бота прямо в админке.
Код для вставки: (Иконка < >). Содержит HTML код и JavaScript сниппеты для установки на сайт. Код отображается в специальном окне с подсветкой синтаксиса. Разделен на Стандартный, Расширенный и API варианты.
Статистика: (Иконка графика). Подробный дашборд с показателями по виджету за выбранный период дат (Количество чатов, расходы, график по часам, донат-чарты эффективности). Доступна выгрузка в Excel.

Мониторинг и Статистика

Подробную информацию о том, как оценивать эффективность виджетов, читайте в разделе Статистика и Аналитика.

Текстовые AI виджеты