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

Настройки сервера

Уровень сервера: значения по умолчанию для всех категорий и то, что категориям не принадлежит — нумерация тикетов, — автозакрытие, автоудаление, перенос настроек кодом. Доступно только администраторам; в чате часть полей меняет /config set.

Общие

Имя сервера
Что делает
Отображается в шапке веб-панели и при импорте настроек по коду.
По умолчанию
имя сервера Lolka
Префикс команд
Что делает
Префикс кастомных команд: !правила. Один символ.
По умолчанию
!
Действие при закрытии
Что делает
«Архивировать» — канал переименовывается, переезжает в категорию закрытых, автор теряет право писать. «Удалить канал» — канал удаляется сразу; запись и транскрипт остаются. Категория может переопределить.
По умолчанию
архивировать
Цифр в номере тикета
Что делает
Сколько цифр в {number}: 4 → #0057, 0 → #57. Одна настройка на весь сервер — действует на все панели и категории.
По умолчанию
4
Автозакрытие открытых тикетов
Что делает
Тикет без новых сообщений N часов (1…8760) закрывается ботом — с транскриптом и логом, как обычное закрытие. Проверка каждые 15 минут. Отдельный тикет можно поставить на паузу — /ticket pause.
По умолчанию
выкл, 48 ч
Автор покинул сервер
Что делает
Все открытые тикеты ушедшего автора закрываются тем же путём.
По умолчанию
выкл
Транскрипт в личные сообщения
Что делает
Отправлять автору HTML при закрытии. Пока недоступно — Lolka не доставляет личные сообщения от ботов; переключатель неактивен.
По умолчанию
выкл
Ответы из веб-панели
Что делает
Приписка «· из веба» к имени сотрудника у ответов, отправленных из панели: в канале видно, что отвечают не из Lolka. В самой панели такой ответ помечен значком всегда, независимо от этой галки.
По умолчанию
вкл
От чьего имени ответы из веб-панели
Что делает
«От сотрудника» — его ник и картинка (свои задаются в инбоксе, «Изменить» под полем ответа). «От сервера» — название и значок сервера; кто писал, видно в панели и транскрипте.
По умолчанию
от сотрудника
Кнопка «Транскрипт»
Что делает
Файл по кнопке в закрытом тикете получает только нажавший — или он падает в канал тикета для всех, кто его видит.
По умолчанию
только нажавшему

Доступ

Администраторы и персонал задаются во вкладке «Персонал», а не здесь — см. Персонал и доступ. Настройки сервера открыты только администраторам.

Лимиты

Глобальный лимит открытых тикетов
Что делает
Сколько тикетов может быть открыто на сервере одновременно, по всем категориям. Лимиты категорий действуют вместе с ним. 0 = без лимита.
По умолчанию
100
Макс. тикетов на пользователя
Что делает
Открытых у одного человека на всём сервере. У категории может быть свой лимит по её тикетам — действуют оба. 0 = без лимита.
По умолчанию
1
Тикетов за период
Что делает
Не больше N тикетов за X минут или часов на одного автора, считая закрытые — против «открыл-закрыл-открыл». Он же пауза между тикетами: «не больше 1 за 5 минут». Отказ говорит, через сколько можно снова. 0 = без лимита.
По умолчанию
выкл, 24 ч
Роли в обход лимитов
Что делает
На эти роли не действуют лимиты сервера и категорий. Категория добавляет свои во вкладке «Лимиты» — списки складываются.
По умолчанию
пусто

Часы поддержки

Тикеты открываются только в заданные дни и часы. Вне расписания кнопка панели, список категорий и /ticket open отвечают эфемерно: ваше сообщение (или «Поддержка сейчас не работает.») и когда откроемся — «сегодня в 09:00», «завтра», «в понедельник» — во времени сервера.

Быстрые заготовки над расписанием: «Будни 09–18», «Ежедневно 09–18», «Круглосуточно» — дальше правьте по дням.

Часовой пояс
Что делает
В нём считается расписание и показывается время в ответе бота: «…в 09:00 (UTC+3)». Города России, ближнего зарубежья и мира; рядом текущее время в поясе, чтобы не ошибиться.
По умолчанию
Москва, UTC+3
Дни и часы
Что делает
На каждый день — тумблер и интервал. Выключенный день закрыт. Одинаковое начало и конец — круглые сутки; конец раньше начала — через полночь (22:00–06:00 — вечер и следующее утро).
По умолчанию
пн–пт 09:00–18:00
Исключения
Что делает
Роли, которым часы не писаны. Администраторы (право Lolka, владелец, вкладка «Персонал») и роли поддержки сервера и категории проходят всегда.
По умолчанию
пусто
Сообщение вне часов
Что делает
Первая фраза ответа, до 500 знаков. «Откроемся …» бот дописывает сам.
По умолчанию
Поддержка сейчас не работает.

Ниже на той же вкладке — «Цель первого ответа»: за сколько минут от открытия персонал должен ответить, календарное время. Пусто — цели нет. Нужна для статистики «в срок» (Статистика); у категории может быть своя — вкладка «Лимиты».

Это умолчание для всех категорий. У категории во вкладке «Часы» можно задать свои часы или снять ограничение — см. Категории → Лимиты и часы.

Проверка стоит на всех путях открытия, включая отправку формы: если человек открыл форму в 17:59 и отправил в 18:05 — тикет не создастся, он увидит тот же ответ. Уже открытые тикеты часы не трогают — в них можно писать и закрывать их в любое время.

Каналы по умолчанию

Запасные значения для категорий, у которых соответствующее поле пустое. /ticket setup заполняет их сам: категории каналов «tickets» и «closed-tickets», канал «tickets» с сообщением панели. Каналы логов и транскриптов переехали на вкладку «Логи» — там же, что писать в лог.

Категория для тикетов
Что делает
Куда создаются каналы тикетов. Последняя ступень цепочки категория тикета → сервер.
По умолчанию
пусто
Категория архива
Что делает
Куда переезжают закрытые каналы при «архивировать». Цепочка категория → архив → категория для тикетов.
По умолчанию
пусто
В категории помещается 50 каналов — потолок платформы. Когда категория тикетов, архива или взятых заполнена, бот сам создаёт продолжение с теми же правами («Тикеты 2», «Тикеты 3»…) рядом с ней и кладёт каналы туда. Настраивать ничего не нужно; удалите продолжение — бот создаст новое, когда понадобится.

Логи

Куда бот пишет о происходящем с тикетами и что именно пишет — один раз на весь сервер. Категория при необходимости задаёт своё.

Канал логов
Что делает
Куда идут события тикетов (открыт, закрыт, взят в работу…).
По умолчанию
пусто
Что писать в лог
Что делает
Тринадцать событий галочками. Ничего не выбрано — пишутся все; отмечено хоть одно — только отмеченные.
По умолчанию
все события
Канал транскриптов
Что делает
Куда бот отправляет HTML-транскрипт при закрытии — по одному файлу на тикет. Пусто — в канал логов.
По умолчанию
пусто
Сохранять транскрипт при закрытии
Что делает
HTML всей переписки — в канал транскриптов и в веб-панель. Выключите для простых вопросов, которые хранить незачем.
По умолчанию
включено

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

Тексты и кнопки

Что бот пишет в тикете и как выглядят его кнопки — один раз на весь сервер. Категория при необходимости перекрывает текст для себя.

Сверху вкладки — «Вид сообщений бота»: цвет полоски и подпись внизу для всего сервера. Они ставятся там, где у сообщения свои не выбраны: приветствие тикета, сообщения панелей, шаблоны и сообщения событий и автоматизаций. Цвет, заданный самому сообщению, и подписи вроде «Тикет #0057» остаются как есть.

СообщениеКогда показывается
После приветствияОбычное сообщение сразу за приветствием — упоминания в нём пингуют. {support} — роли поддержки тикета. Можно выключить.
Тикет созданОтвет тому, кто открыл тикет, со ссылкой на канал.
Подтверждение закрытияВопрос перед закрытием (закрытие в два шага).
Закрытие / переоткрытиеПосле закрытия / переоткрытия.
Взять в работу / снять с себяПерсонал взял тикет / снял с себя.
Передача тикетаСотрудник передал тикет другому.
ЭскалацияТикет передан в другую категорию.
ТранскриптТранскрипт сохранён — в канал транскриптов.
Участник добавленСотрудник добавил человека в тикет.
Запрос на закрытиеАвтор просит закрыть тикет, если закрытие требует одобрения стаффа.
ОтказыЧёрный список, четыре лимита (на человека, на категорию, за период, на сервер) и кнопка, закрытая для ролей нажавшего. Видит только тот, кто нажал.
Причина автозакрытияПодставляется в {reason} сообщения о закрытии, когда тикет закрыл таймер.

У сообщения есть текст и, при желании, embed. Подстановки ({user}, {number} и другие) вставляются кликом, а незнакомая переменная подсвечивается — опечатка не уйдёт в канал как есть. Кнопка «Отправить пример в канал» показывает сообщение прямо в Lolka: бот отправит его с примерными значениями.

Рядом с сообщением может стоять «перекрыто: N» — значит, столько категорий пишут своё, и серверный текст там не применяется; по ссылке видно, какие именно. Поиск над списком ищет по названию и по тексту, счётчик показывает, сколько из настроек изменено, «Сбросить всё» возвращает сервер к встроенным текстам (свои тексты категорий при этом остаются).

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

Хранение

Две настройки: когда удалять каналы закрытых тикетов в Lolka (автоудаление) и сколько бот хранит их переписку у себя.

Хранение переписки

Хранить переписку закрытых тикетов
Что делает
Через сколько дней после закрытия бот стирает у себя сообщения тикета, HTML-транскрипт, ответы формы, тему и причину закрытия. Номер, категория и даты остаются — для статистики; настройки сервера не трогаются. Файлы, уже отправленные в каналы сервера, остаются там. От 1 до 365 дней.
По умолчанию
180

Подробнее — в политике конфиденциальности.

Автоудаление каналов

Удаляет каналы закрытых тикетов по расписанию. Запись тикета, транскрипт и статистика остаются.

Автоудаление
Что делает
Общий выключатель.
По умолчанию
выкл
Удалить через
Что делает
Дни / часы / минуты после закрытия.
По умолчанию
10 дней
Лимит сообщений
Что делает
Если в закрытом канале больше N сообщений — удалить сразу, не дожидаясь срока. 0 = не учитывать.
По умолчанию
100

Команды

Какие slash-команды бота есть на этом сервере и кому их можно выполнять. Список приходит от бота, поэтому новые команды появляются во вкладке сами. Изменения применяются по «Сохранить» сразу — перезапуск не нужен.

У каждой строки — тумблер и кнопка-бейдж справа: «все», пока ничего не настроено, иначе кратко что задано («только Поддержка», «2 роли», «видят: Администратор»). Клик по бейджу открывает настройки этой команды. «Сбросить всё» над списком возвращает все команды к умолчанию.

Тумблер
Где
у каждой команды
Что делает
Есть ли команда на сервере. Выключен — команды нет в списке ни у кого. Выключены все подкоманды группы — исчезает и группа.
Кто видит
Где
в настройках группы
Что делает
Команда есть только у участников с выбранным правом Lolka (Администратор, Управление сервером/каналами/сообщениями). Право задаётся на группу целиком — платформа не даёт разное право подкомандам.
Кому можно выполнять
Где
в настройках любой команды
Что делает
Команду видно, но выполнить может только участник с одной из выбранных ролей; остальным — «закрыта для ваших ролей», видно только им. Администраторы (право Lolka, владелец, вкладка «Персонал») проходят всегда. Встроенные проверки команды («только администратор», «только персонал») действуют поверх — роль не даёт больше, чем команда даёт сама.
Спрятать команду по роли платформа не умеет — только по праву; «кому можно» ограничивает выполнение, не видимость. Чтобы у обычных участников не было ни одной команды, поставьте всем группам право — тикеты они открывают и закрывают кнопками. Проверка прав внутри бота работает независимо от видимости: скрыть команду от того, кому она положена, безопасно, а показать тому, кому нет, — не даст ничего лишнего.

Перенос настроек

Вкладка «Перенос». Файла нет: настройки сохраняются у бота, а вы получаете код вида PB-XXXX-XXXX-XXXX-XXXX.

ЧтоКак
Экспорт«Получить код». В коде — настройки сервера, персонал и администраторы веб-панели, видимость команд, панели, категории со всеми настройками, мультипанели, кастомные команды, автоматизации. Тикеты, переписка, транскрипты и чёрный список не переносятся. Код действует сутки, его можно использовать на нескольких серверах. Если с прошлого экспорта ничего не менялось, выдаётся тот же код, а его срок продлевается ещё на сутки.
ИмпортВставьте код и нажмите «Проверить» — видно, с какого сервера код, когда он сделан и что внутри. «Импортировать» заменяет текущие настройки.
Код откатаПеред импортом бот сам сохраняет текущие настройки и показывает их код: если что-то пошло не так, импортируйте его. Действует тоже сутки.
С другого сервераРоли, каналы и категории каналов другого сервера не переносятся — выберите их заново. Автоматизации приходят выключенными.

Сброс

Режим /ticket resetЧто удаляется
Только настройкиНастройки сервера, панели (вместе с сообщениями в каналах) и категории тикета. Тикеты, их номера и чёрный список не трогаются.
Полный сбросВсё выше плюс тикеты, сообщения, транскрипты, чёрный список, кастомные команды, каналы тикетов и опустевшие категории бота. Каналы логов, транскриптов и панели остаются, если лежат вне категорий бота (созданные /ticket setup — внутри и удаляются).

Тикеты, переписку и чёрный список сброс удаляет безвозвратно. Настройки можно вернуть: в ответе команды — код отката, его импорт во вкладке «Перенос» вернёт настройки в течение суток.