SupportHubSupportHub/ docsНазад
Главная и приветствие
Виджет / Главная

Главная вкладка и приветствие

Заголовок, подзаголовок, bot menu, pinned banner, scheduled greeting — всё, что посетитель видит при первом клике.

Структура главной

Когда посетитель кликает FAB и попадает в виджет впервые, он оказывается на вкладке Главная. Сверху вниз там рендерится:

  1. Hero-блок — большой заголовок «Hi there 👋» (или ваш кастомный) и подзаголовок «Чем помочь?».
  2. Out-of-hours баннер — мягкий чип с подсказкой, если сейчас вне рабочих часов и show_work_hours включён.
  3. Away-greeting баннер — отдельный блок для hours.away_segments (например, обед или праздник).
  4. «Последнее сообщение» — клик на карточку открывает прошлый разговор посетителя. Появляется только если у визитёра есть тикет в этом workspace.
  5. «Задать вопрос» — основная CTA-кнопка с круглым акцентным бейджем и иконкой-самолётиком.
  6. Bot menu — список ваших быстрых действий («Написать в Telegram», «Открыть FAQ», «Связаться с продажами»).
  7. Pinned banner — закреплённое объявление от команды (промо, объявление об обновлении, технические работы).

Hero-блок

welcome.title
Тип: stringПо умолчанию: "Hi there 👋"
Большой заголовок главной. Эмодзи в начале/конце выглядит уместно.
welcome.subtitle
Тип: stringПо умолчанию: "Чем помочь?"
Подзаголовок под title. Если задан greeting_segments с активным сегментом, посетитель увидит сообщение из расписания вместо этого fallback'а.
welcome.message
Тип: stringПо умолчанию: —
Дополнительное предложение под подзаголовком. Хорошо подходит для конкретики: «Обычно отвечаем за 5 минут» или «Сегодня в поддержке Алина и Иван».
welcome.button_text
Тип: stringПо умолчанию: "Написать"
Текст внутри FAB-pill, если он развёрнут (когда задан, FAB становится pill вида «💬 Написать»).

Bot menu

welcome.bot_menu — массив быстрых действий. Каждое:

id
Тип: stringПо умолчанию: —
Стабильный идентификатор пункта (для аналитики кликов).
label
Тип: stringПо умолчанию: —
Текст на кнопке; до 200 символов.
action
Тип: "open_chat" | "url" | "deeplink" | "command"По умолчанию: —
Что делать по клику: открыть чат с предзаполненным текстом, открыть URL во внешнем окне, deeplink в приложение или встроенная команда виджета.
url
Тип: stringПо умолчанию: —
Целевая ссылка для url/deeplink.
welcome.bot_menu (пример)json
[
  {
    "id": "tg",
    "label": "Написать в Telegram",
    "action": "url",
    "url": "https://t.me/your_bot"
  },
  {
    "id": "faq",
    "label": "Открыть базу знаний",
    "action": "command",
    "url": "open_help_tab"
  },
  {
    "id": "billing",
    "label": "Вопрос по биллингу",
    "action": "open_chat",
    "url": "Здравствуйте, у меня вопрос по оплате."
  }
]

Pinned banner

Закреплённый блок поверх главной — для важных, временных сообщений: «Сегодня работаем до 17:00», «Релиз v2.5: что нового», «Технические работы 19:00-20:00 МСК».

welcome.pinned_banner.enabled
Тип: booleanПо умолчанию: false
Включить/выключить блок без правки текста.
welcome.pinned_banner.text
Тип: stringПо умолчанию: —
Текст до 2000 символов; markdown НЕ поддерживается, обычный текст.
welcome.pinned_banner.image_url
Тип: stringПо умолчанию: —
Иконка/иллюстрация слева. Хорошо смотрятся 64×64 PNG/SVG.
welcome.pinned_banner.dismissable
Тип: booleanПо умолчанию: true
Можно ли посетителю закрыть баннер крестиком. Закрытие персистится в его localStorage — повторно не покажется.
welcome.pinned_banner.show_on
Тип: string[] ("home", "conversation")По умолчанию: ["home", "conversation"]
На каких вкладках показывать. Используйте ["home"], чтобы баннер не отвлекал от диалога.
Была ли страница полезной?