Перейти к содержимому
Paper Bot/Документация

Панели

Панель — витрина, точка входа для пользователя: сообщение с кнопкой в канале (или команда). Панель решает, как выглядит вход и какие категории в нём предложить. Как ведёт себя сам тикет — права, роли, тексты, кнопки, лимиты, логи — настраивается в категориях. Панелей на сервере может быть несколько — «Поддержка», «Жалобы», «Продажи».

Где настраивается

СпособЧто можно
Веб-панель → Панели → панельВкладки «Категории» и «Сообщение» (там же кнопка «Открыть тикет»); справа — как сообщение будет выглядеть в канале, ссылка на тикеты этой панели и проверка панели. Имя и позиция — в меню «⋯» в шапке.
/ticket setupМастер настройки: набор тем обращений, панель «default», категории каналов и канал с кнопкой.
/panel …Создание, отправка, стиль, тексты — см. Команды.
Правки, которые видны в самом сообщении панели (имя, стиль, кнопка, embed, категории), пересылаются в канал автоматически. Если бот не смог обновить сообщение, веб-панель покажет предупреждение — настройки при этом уже сохранены.

Стили

Кнопка в канале
Что видит пользователь
Embed с кнопкой «Открыть тикет». Нажатие → выбор категории (если их 2+) → форма или сразу канал.
Когда выбирать
Основной вариант.
Мультипанель
Что видит пользователь
Одно сообщение на несколько панелей: кнопки или выпадающий список. Отдельная сущность, см. ниже.
Когда выбирать
Когда панелей несколько и не хочется по сообщению на каждую.
Кнопки категорий
Что видит пользователь
По кнопке на каждую категорию панели, цвет кнопки — у категории («Цвет кнопки»). Нажатие → форма или сразу канал этой категории.
Когда выбирать
Когда тем немного и хочется убрать шаг выбора.
Команда
Что видит пользователь
Кнопки нет; в сообщении инструкция. Тикет открывают через /ticket open [панель].
Когда выбирать
Когда не нужен отдельный канал с кнопкой.

Мультипанель

Несколько панелей в одном сообщении: «Жалоба | Поддержка | Заявка в стафф». Создаётся внизу раздела «Панели»; нужны хотя бы две панели. Нажатие на кнопку или пункт ведёт ровно туда же, куда ведёт собственная кнопка этой панели — категории панели и их настройки действуют как обычно, мультипанель ничего своего в тикет не добавляет.

ПараметрЧто делает
Стиль«Кнопки» — по кнопке на панель, до 25 (по 5 в ряд). «Выпадающий список» — одно меню, пункт = панель; компактнее при 5+ панелях.
Панели и порядокКакие панели входят и в каком порядке. Одна панель может быть в нескольких мультипанелях; своё сообщение у панели при этом не обязательно — «Проверка настроек» считает её отправленной.
Подпись пунктаУ каждой панели в мультипанели — своя подпись, эмодзи и цвет кнопки. Пусто — имя панели и эмодзи/цвет её кнопки «Открыть тикет».
ПревьюВ форме сверху — как сообщение будет выглядеть в канале: embed, кнопки или список с пунктами. Обновляется по мере правок.
КаналКуда публиковать. Задан — сообщение отправляется (или обновляется) при сохранении; без канала мультипанель только сохраняется.
ОформлениеЗаголовок, описание, цвет и остальные поля embed — тот же редактор, что у сообщения панели. По умолчанию заголовок — название мультипанели.
Переименовали панель или поменяли подпись её кнопки — мультипанели с ней перерисуются сами. Пока панель входит в мультипанель, удалить её нельзя. Удаление мультипанели убирает только её сообщение: панели и тикеты не трогает.

Категории панели

Какие категории предлагать в этой панели и в каком порядке. Категории можно задать свою подпись, эмодзи, описание и цвет кнопки — только для этой панели; одна и та же категория в другой панели может называться иначе. Звёздочка — категория «по умолчанию»: если категория одна, выбора нет и тикет сразу открывается в ней. До 25 категорий. Поведение тикета задаёт сама категория.

Сообщение и стиль

Текст и embed сообщения панели (заголовок, описание, цвет, картинки, подвал, автор), стиль и канал публикации. Превью показывает сообщение так, как его увидит пользователь. Кнопка «Отправить» в шапке публикует или обновляет сообщение.

Кнопка «Открыть тикет»

Эмодзи, подпись и цвет главной кнопки на сообщении панели. По умолчанию — 🎫 «Открыть тикет», зелёная. Кнопки внутри тикета настраиваются у категории.

Персонал, права, кнопки, вопросы, лимиты, часы, взятие в работу, эскалация и логи настраиваются в категории. Нумерация тикетов (цифр в номере) — одна на сервер, в Настройках.

Копия панели

Меню «⋯» в шапке панели → «Копировать»: новая панель с оформлением исходной и теми же категориями — они не дублируются, копия показывает те же самые. Не копируются опубликованное сообщение и номер — копию надо отправить в канал самостоятельно.

Удаление панели

  • •Сообщение панели в канале удаляется; открытые тикеты остаются и работают по настройкам своей категории.
  • •Панель, которая входит в мультипанель, удалить нельзя — сначала уберите её из мультипанели.
  • •Номер панели не переиспользуется.
  • •Категории не удаляются — остаются на сервере и в других панелях, где стоят.