Главная вкладка и приветствие
Что посетитель видит на главной, тексты приветствия, новости и статьи внизу главной, авто-открытие и закреплённый баннер.
Структура главной
Открыв виджет, посетитель обычно попадает на вкладку «Главная». Исключения: если у него есть открытое обращение, виджет сразу открывает этот диалог, а при включённом «Сразу открывать чат с приветствием» — новый диалог. Сверху вниз на главной:
- Закреплённый баннер — если включён и отмечен для «Главной» (см. ниже).
- Приветствие — заголовок «Привет 👋» и подзаголовок «Чем помочь?» (или ваши тексты).
- Рабочие часы — «Сейчас в сети до …» или сообщение вне рабочих часов, если включено «Показывать рабочие часы в виджете».
- Сообщение об отсутствии — если сейчас действует сегмент отсутствия.
- «Последнее сообщение» — карточка последнего обращения посетителя, если оно есть. Клик открывает этот диалог.
- «Задать вопрос» — основная кнопка: начинает новое обращение.
- Последние новости — от одной до трёх карточек свежих новостей для клиентов (по умолчанию две). В карточке — обложка (картинка новости, а если её нет — значок-мегафон на фоне акцентного цвета), заголовок до двух строк, подпись вида «Новость · 2 дн. назад» и стрелка. Нажатие открывает новость.
- Статьи базы знаний — поле «Поиск по статьям», популярные статьи плитками или списком и ссылка «Все статьи». Нажатие на поле открывает вкладку «Помощь» сразу с курсором в поиске, «Все статьи» — вкладку «Помощь».
Два последних блока настраиваются в Конструктор виджетаПриветствиеВнизу главной (см. ниже).
Тексты приветствия
НастройкиКонструктор виджетаПриветствие. Тексты задаются отдельно для русского и английского — язык правки переключается над разделом.
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| welcome.title | string | "Привет 👋" | «Заголовок hero» — крупный заголовок главной. |
| welcome.subtitle | string | "Чем помочь?" | «Подзаголовок hero». Если сейчас действует сегмент приветствия, вместо него показывается текст сегмента. |
| welcome.message | string | — | «Приветственное сообщение (опционально)» — вторая строка на кнопке «Задать вопрос» и заголовок в начале диалога (вместо «Добро пожаловать!»). Например: «Обычно отвечаем за 5 минут». |
| welcome.button_text | string | "Написать" | «Текст CTA-кнопки» — текст на кнопке-лончере в углу сайта. Пока он задан, лончер — «пилюля» с иконкой и текстом; пустое поле — круглая кнопка. Надпись на кнопке «Задать вопрос» он не меняет. |
| welcome.quick_replies | { id, label }[] | [] | «Быстрые ответы» — до 8 кнопок в начале нового диалога. Клик отправляет текст кнопки как сообщение посетителя. |
Внизу главной: новости и статьи
НастройкиКонструктор виджетаПриветствиеВнизу главной — два блока под кнопкой «Задать вопрос»: сначала новости, затем статьи базы знаний. У каждого свой переключатель, оба включены по умолчанию.
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| welcome.home_news.enabled | boolean | true | «Последние новости» — карточки последних новостей для клиентов. Блок виден, только если включена вкладка «Новости» и сейчас действует хотя бы одна новость для клиентов. Дата в карточке — относительная, на языке виджета. |
| welcome.home_news.count | number | 2 | «Сколько новостей» — от 1 до 3 последних. |
| welcome.home_articles.enabled | boolean | true | «Популярные статьи и поиск» — поле поиска, популярные статьи и ссылка «Все статьи». Блок виден, только если включена вкладка «Помощь», база знаний входит в тариф и есть хотя бы одна опубликованная публичная статья. Без статей нет и поля поиска. |
| welcome.home_articles.layout | "tiles" | "list" | "tiles" | «Вид статей». «Плитки» — сетка в две колонки: на плитке значок акцентного цвета (значок категории статьи, если он у категории задан, иначе значок документа) и заголовок до двух строк — в одну строку он не обрезается. Если плиток нечётное число (например, публичных статей меньше, чем выбрано), последняя занимает всю строку. «Список» — строки со значком документа, заголовком до двух строк и стрелкой; между строками тонкие разделители, рамки вокруг списка нет. |
| welcome.home_articles.count | number | 4 | «Сколько статей»: для плиток — 2, 4 или 6, для списка — 3, 4 или 5. В конфиге допустимо от 2 до 6. |
Популярные статьи — самые просматриваемые из опубликованных публичных; при равных просмотрах выше та, у которой больше 👍, затем более новая. Внутренние статьи в блок не попадают никогда. Если вкладка «Новости» или «Помощь» выключена в разделе «Вкладки», конструктор пишет под переключателем блока, что он не покажется.
Авто-открытие
В том же разделе «Приветствие» настраивается, когда виджет открывается сам:
- «Задержка авто-открытия (секунды)» — через 1–3600 секунд после загрузки страницы, один раз за сессию браузера и только если посетитель ещё не открывал виджет сам. Пусто или 0 — выключено.
- «Сразу открывать чат в Telegram Mini App» — если сайт запущен как Mini App, панель открывается сразу. Ссылки из чатов Telegram (встроенный браузер) — не Mini App: там виджет сам не открывается.
- «Где открывать само» — для задержки: «Везде», «Только в обычном браузере» или «Только на компьютере». Поисковым роботам виджет сам не открывается.
- «Что открыть» — вкладка, а для «Помощи» и «Новостей» — раздел, статья или новость. Если вкладка не видна, виджет откроется как обычно.
- «Сразу открывать чат с приветствием» — клик по кнопке-лончеру ведёт не на главную, а сразу в новый диалог. Обращение создаётся, только когда посетитель что-то отправит.
Закреплённый баннер
НастройкиКонструктор виджетаЗакреплённый баннер — полоса сразу под шапкой виджета для важных временных сообщений: «Сегодня работаем до 17:00», «Технические работы 19:00–20:00».
sessionStorage посетителя: до конца сессии браузера баннер не покажется, в новой вернётся. Если изменить текст, баннер покажется снова.conversation из сохранённых конфигов читается как chat.| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| welcome.pinned_banner.enabled | boolean | false | «Включить закреплённый баннер». Без текста баннер не показывается. |
| welcome.pinned_banner.text | string | — | «Текст баннера» — до 2000 символов обычного текста; разметка и ссылки не поддерживаются. |
| welcome.pinned_banner.image_url | string | — | «URL изображения (опционально)» — маленькая иконка слева от текста (20×20). |
| welcome.pinned_banner.dismissable | boolean | true | «Может быть закрыт посетителем» — крестик справа. Закрытие запоминается в sessionStorage посетителя: до конца сессии браузера баннер не покажется, в новой вернётся. Если изменить текст, баннер покажется снова. |
| welcome.pinned_banner.show_on | ("home" | "chat" | "help" | "news")[] | ["home", "chat"] | «Показывать на» — вкладки, на которых виден баннер: «Главная», «Чат» (список обращений), «Помощь» (первая страница раздела, не внутри категории или статьи) и «Новости». Внутри открытого диалога баннера нет. Если снять все отметки, баннер не показывается нигде. Старое значение conversation из сохранённых конфигов читается как chat. |

