Бренд и шапка
Акцентный цвет, тема, язык виджета, логотип и шапка, кнопка-лончер, «Powered by» и эмодзи для реакций.
Где настраивается
НастройкиКонструктор виджетаБрендинг. Все изменения уходят в cfg.brand; превью справа обновляется сразу, а посетители увидят их после кнопки «Опубликовать».
Цвет и тема
#RRGGBB.auto следует за системной настройкой посетителя через prefers-color-scheme и переключается сразу, когда посетитель меняет тему системы.| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| accent_color | string | #6366f1 | «Акцентный цвет» — кнопка-лончер, кнопка отправки, сообщения посетителя и другие акценты. Бэкенд принимает только формат #RRGGBB. |
| accent_gradient | { from_color, to_color, angle } | null | «Градиент акцента» — двухцветный градиент на кнопке-лончере и акцентных фонах. Текст и рамки остаются на сплошном акцентном цвете. Пусто — без градиента. |
| theme | "light" | "dark" | "auto" | "auto" | «Тема» панели: «Авто (системная)», «Светлая», «Тёмная». auto следует за системной настройкой посетителя через prefers-color-scheme и переключается сразу, когда посетитель меняет тему системы. |
Язык виджета
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| language | "auto" | "ru" | "en" | "auto" | «Язык виджета», сразу под «Темой»: «Авто», «Всегда русский» или «Всегда английский». |
«Всегда русский» и «Всегда английский» показывают всем посетителям один язык. На нём всё: кнопки и надписи виджета, даты, ваши тексты из конструктора (из вариантов RU/EN берётся этот) и язык, который виджет сообщает серверу, — поэтому и системные сообщения посетителю приходят на нём. Предпросмотр в конструкторе тоже переключается на этот язык. Язык, заданный на сайте через data-locale или SupportHub.init({ locale }), при этом не действует.
«Авто» (по умолчанию) выбирает язык по порядку:
- Язык, который задал сайт:
SupportHub.init({ locale })или атрибутdata-localeна script-теге (см. установку виджета). Он действует всегда. - Язык страницы (
<html lang="…">), затем язык браузера — но только если тексты проекта есть на этом языке. - Иначе — основной язык проекта.
Тексты проекта есть на языке, если на нём доступен каждый текст, который вы меняли в конструкторе: приветствие и подзаголовок, заголовок и подзаголовок шапки, название проекта, тексты кнопок, быстрые ответы, темы и их поля, закреплённый баннер (если включён), включённые системные сообщения, тексты email-моста (если он включён), просьба об оценке (если оценка включена) и другие. Текст с вариантами RU/EN считается для тех языков, на которых он заполнен. Текст, вписанный без вариантов по языкам, считается на языке своего алфавита: кириллица — русский, два и больше латинских слова — английский, а названия брендов, эмодзи и числа подходят к любому языку. Тексты, которые вы не меняли, есть на обоих языках.
Основной язык проекта — default_locale из настроек проекта, если он задан; иначе английский, если тексты проекта есть только на английском, а в остальных случаях русский. Что получилось, видно в публичном конфиге, в computed.locales (см. справочник полей).
Логотип и шапка
POST /api/workspaces/{ws}/widget-config/logo и встраивается в конфиг как data: URL. Вместо загрузки можно раскрыть «Использовать внешний URL» и вставить ссылку на картинку. Без логотипа в шапке показывается первая буква названия.object-fit: contain) вместо обрезки по краям (cover) — удобно для логотипов со своим фоном и отступами. У буквы вместо логотипа убирает акцентную плашку.| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| logo_url | string | — | «Логотип» в шапке, 32 px. Кнопка «Загрузить» принимает PNG / JPEG / WebP / SVG до 256 КБ; растровую картинку перед загрузкой можно обрезать. Файл уходит на POST /api/workspaces/{ws}/widget-config/logo и встраивается в конфиг как data: URL. Вместо загрузки можно раскрыть «Использовать внешний URL» и вставить ссылку на картинку. Без логотипа в шапке показывается первая буква названия. |
| logo_shape | "circle" | "rounded" | "square" | "rounded" | «Форма» логотипа (или буквы вместо него): «Круг», «Скруглённый» (углы 8 px), «Квадрат» (острые углы). |
| logo_transparent_bg | boolean | false | «Прозрачный фон». Картинка вписывается в контейнер целиком (object-fit: contain) вместо обрезки по краям (cover) — удобно для логотипов со своим фоном и отступами. У буквы вместо логотипа убирает акцентную плашку. |
| project_name | string | — | «Название проекта» — первая строка шапки. Если задано и отличается от заголовка шапки, заголовок уходит второй строкой. |
| header_title | string | "Поддержка" | «Заголовок шапки» — первая строка шапки, если название проекта не задано. |
| header_subtitle | string | — | «Подзаголовок шапки (опционально)» — вторая строка: слоган, контакты, чем занимается команда. Не показывается, если вторую строку уже занял заголовок шапки. |
Кнопка-лончер
Кнопка стоит в правом нижнем углу страницы. Пока в ПриветствиеТекст CTA-кнопки есть текст (по умолчанию «Написать»), кнопка — «пилюля» с иконкой и этим текстом; если текст стереть, остаётся круглая кнопка с иконкой.
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| launcher_icon_url | string | — | «Загрузить иконку» — своя иконка вместо стандартной иконки чата (PNG / JPEG / WebP / SVG до 256 КБ). «Сбросить» возвращает стандартную. |
| launcher_icon_only | boolean | false | «Показывать только иконку» — прячет текст на кнопке, не удаляя его. |
| launcher_icon_transparent_bg | boolean | false | «Прозрачный фон (во весь размер)» — своя иконка во всю кнопку, без акцентной подложки. Для иконок со своим фоном или формой. |
«Powered by SupportHub»
Пока панель открыта, на компьютере рядом с кнопкой виджета показывается ссылка «Powered by SupportHub». Переключатель «Скрыть «Powered by SupportHub»» в разделе «Брендинг» убирает её; он доступен на тарифах Business и Enterprise, на остальных заблокирован.
Ссылка ведёт на наш сайт и несёт метки кампании: utm_source — домен страницы, на которой стоит виджет, utm_medium=widget, utm_campaign=branding. По ним мы видим, сколько человек пришло к нам с вашего сайта. Ничего о самих посетителях в метках нет.
Эмодзи для реакций
НастройкиКонструктор виджетаНабор эмодзи, поле «Свои эмодзи» (brand.emoji_pack_id) — четыре эмодзи, которые посетитель видит, когда задерживает палец или курсор на сообщении оператора. По умолчанию ❤️ 👍 👎 🎉. Впишите свои через запятую или пробел:
❤️,🔥,👍,🎉
Берутся первые четыре. Если вписали меньше, пустые места занимают эмодзи по умолчанию из тех же позиций. Составные эмодзи (✋🏿, 🏳️🌈) не разваливаются, но эмодзи, записанные подряд без разделителя, считаются одним. Пустое поле — набор по умолчанию.
Панель реакций открывается долгим нажатием 350 мс или наведением курсора на 600 мс — только на сообщениях оператора.