Руководство пользователя
Веб-виджет для сайта
Веб-виджет добавляет на сайт чат с вашим агентом. Вы можете настроить его внешний вид, приветствие, быстрые кнопки и рабочие часы.
Настраивать виджет может администратор или владелец.
Открыть настройки
- «Агенты» → нужный агент → вкладка «Каналы».
- Откройте карточку веб-виджета.
- Убедитесь, что канал включён: выключенный канал означает, что виджет на сайте не появится, какие бы настройки вы ни сохранили.
Окно разделено на четыре вкладки — «Внешний вид», «Контент», «Поведение», «Установка» — и предпросмотр справа. Предпросмотр статичный: он показывает, как виджет будет выглядеть, но переписываться в нём нельзя. Чтобы проверить ответы агента, откройте тестовый диалог.
Внешний вид
| Настройка | Значения | По умолчанию |
|---|---|---|
| «Цвет виджета» | 8 готовых цветов или любой свой через палитру | Синий #2563eb |
| «Позиция» | Справа или слева внизу | Справа |
| «Размер кнопки» | S (48 px), M (56 px), L (64 px) | M |
| «Скругление углов» | Ползунок 0–32 px | 16 px |
| «Тема виджета» | Светлая, тёмная, авто | Авто — подстраивается под тему устройства посетителя |
| «Показывать "Powered by SmartDialogue"» | Да / нет | Включено |
Контент
| Настройка | Ограничение | Если не заполнить |
|---|---|---|
| «Имя бота» | До 50 символов | Показывается имя агента из настроек |
| «URL аватара» | HTTPS-ссылка на изображение, до 2048 символов | В заголовке чата остаётся 🤖. Он также появится, если изображение не загрузится |
| «Приветственное сообщение» | Без жёсткого ограничения длины, но длинный текст займёт весь экран телефона | Стандартное приветствие с именем агента |
| «Быстрые кнопки» | До 5 кнопок, каждая до 30 символов. Добавляются по Enter, удаляются крестиком | Кнопок не будет |
Быстрые кнопки — это подсказки, которые посетитель нажимает вместо набора текста. Пишите их как вопрос клиента («Цены», «Сроки доставки», «Позвать человека»), а не как команду боту.
Поведение
| Настройка | Значения | Что означает |
|---|---|---|
| «Автооткрытие виджета» | 0–120 секунд | Через сколько секунд окно чата раскроется само. 0 — таймер отключён |
| «Открытие по прокрутке» | 0–100% | Какая доля доступной прокрутки страницы откроет чат. 0 — отключено, 100% — в конце страницы |
| «Задержка приветствия» | 0–30 секунд | Через сколько появится облачко с приветствием у свёрнутой кнопки. 0 — сразу |
| «Показывать на мобильных» | Да / нет | Выключите, если на телефоне виджет мешает вёрстке сайта |
| «Звук при новом сообщении» | Да / нет | Звуковой сигнал у посетителя |
| «Бейдж непрочитанных» | Да / нет | Счётчик на свёрнутой кнопке |
Если включены таймер и открытие по прокрутке, сработает первое условие. После ручного или автоматического открытия чат больше не раскроется сам до перезагрузки страницы. Если оба условия выключены, посетитель открывает его по клику. На странице без прокрутки работает только таймер.
Открытие по прокрутке работает при установке через Script. В варианте iframe окно чата сразу открыто и не отслеживает прокрутку страницы сайта. Настройка «Показывать на мобильных» тоже относится к Script: виджет скрывается при ширине окна меньше 768 px и появляется при увеличении ширины. Видимость iframe задаётся на вашем сайте.
Рабочие часы
Включаются отдельным переключателем; после этого выбираются час начала и час окончания (из списка 00:00–23:00) и текст «Сообщение вне рабочих часов».
При настройке учтите:
- Рабочие часы виджета — не то же самое, что рабочее окно напоминаний. Это две независимые настройки.
- Вне рабочих часов виджет не отключается: посетитель видит ваше офлайн- сообщение, но по-прежнему может написать. Агент продолжает отвечать, если он включён.
- Часы считаются по часовому поясу аккаунта из раздела «Настройки».
Установка на сайт
На вкладке «Установка» два готовых фрагмента кода с кнопкой копирования:
| Вариант | Когда использовать |
|---|---|
| Script | Обычный случай. Вставьте строку перед закрывающим </body> на сайте |
| iframe | Если на сайте строгая политика безопасности и внешние скрипты запрещены |
Код вставляется один раз. Все дальнейшие изменения — цвет, тексты, кнопки, рабочие часы — подхватываются сайтом автоматически: переустанавливать код после каждой правки не нужно.
Кастомный CSS
Поле на той же вкладке. Стили применяются к виджету на сайте посетителя.
| Ограничение | Подробности |
|---|---|
| Длина | До 5000 символов. Более длинный стиль не сохранится |
| Запрещённые конструкции | @import, expression(), behavior:, -moz-binding, javascript:, а также закрывающий тег </style |
| Внешние ссылки | url() и image-set() только на локальные пути и data:image/. Ссылки на сторонние сайты (шрифты, картинки с чужих доменов) отклоняются |
Ошибка показывается при сохранении, а не позже — если стиль принят, он будет отдан посетителям. Внешние ссылки ограничены, потому что загрузка стилей с чужого домена передавала бы ему сведения о посещениях вашего сайта.
Виджет отображается в изолированном контейнере, поэтому ваши стили не сломают вёрстку сайта, но и стили сайта не влияют на виджет.
Сохранение
Кнопка «Сохранить настройки» — под вкладками. Изменения не применяются по мере ввода: пока вы не сохранили, посетители видят прежний виджет. Переключение между вкладками ничего не теряет — сохраняйте один раз в конце.
Смежные темы: настройки агента, тестовый диалог с агентом.