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

Установка и запуск

Три шага до рабочей системы тикетов: добавить бота, выполнить одну команду, войти в веб-панель. Дальнейшая настройка — по желанию.

1. Добавьте бота

Кнопка «Добавить бота» на главной. Lolka покажет список прав с галочками, все отмечены. «Администратор» покрывает остальные; если снимете его, оставьте права из таблицы:

ПравоЗачем
Управлять каналамиСоздание, переименование, перемещение и удаление каналов тикетов.
Управлять ролямиДоступ к приватным каналам автору и персоналу, роли из автоматизаций.
Просматривать каналы, отправка сообщенийСообщения в тикете, сбор транскрипта.
Управлять сообщениямиОбновление сообщения панели и панели тикета.
Упоминание @everyone, @here и всех ролейПинг ролей персонала о новом тикете, даже если роль нельзя упоминать.
Обходить медленный режимБот пишет в канал тикета без задержки, если там включён медленный режим.
Управлять вебхукамиОтветы сотрудников из веб-панели — они уходят вебхуком, от имени сотрудника. Без него не работают только ответы из веба.
Управлять участникамиШаги автоматизаций «исключить», «забанить» и «разбанить автора»: на Lolka это одно право и на кик, и на бан. Без него не работают только эти шаги.
АдминистраторПокрывает всё выше. Можно снять, если выдали остальное.

Что из этого есть у бота на вашем сервере, покажет /debug: ❌ — без этого бот не работает, ⚠️ — отвалится отдельная возможность.

Роль бота должна стоять в списке ролей выше ролей персонала — иначе Lolka не даст боту выдавать им доступ к каналам.

2. Выполните /ticket setup

Команда администратора, без параметров. Открывает мастер настройки — четыре шага, видно только вам:

  • •Чем занимается сервер — игровой или RP, сообщество, магазин, проект. Под это подбирается набор тем обращений. Пятый вариант — «Настрою сам», тогда тема будет одна, «Общая».
  • •Какие темы оставить — кнопка на тему: зелёная создастся, серая нет. Нажатие переключает.
  • •Как открывать тикеты — одна кнопка «Открыть тикет», кнопка на каждую тему или только команда /ticket open.
  • •Создать — до этой кнопки на сервере ничего не появляется.

Темы приезжают с эмодзи, описанием и вопросами формы: например «Жалоба на игрока» сразу спрашивает ник нарушителя, что произошло и доказательства. Всё это потом правится в веб-панели.

По кнопке «Создать» появляется:

Что создаётсяГде потом менять
Категория каналов «tickets»Настройки → Каналы по умолчанию → Категория для тикетов
Категория каналов «closed-tickets»Настройки → Каналы по умолчанию → Категория архива
Канал «tickets» с сообщением и кнопкойПанели → default → «Сообщение панели»
Панель «default»Панели → default

После этого кнопка в канале уже работает. Что осталось — раздать роли персонала: до этого тикеты видят только администраторы.

3. Войдите в веб-панель

  • •В любом канале сервера выполните /dashboard token. Команда доступна администраторам и персоналу.
  • •Нажмите «Открыть панель» в ответе бота. Ссылка одноразовая и живёт 5 минут; ответ видите только вы.
  • •Вы в веб-панели своего сервера. Если бот стоит на нескольких ваших серверах, повторите команду на каждом — они появятся в одном списке.

Что настроить дальше

Кто отвечает на тикеты
Где
Персонал → Роли поддержки
Темы обращений
Где
Категории → Создать, затем Панели → панель → Категории панели
Подробнее
Категории
Вопросы перед открытием
Где
Категории → категория → Сообщения
Тексты и кнопки в тикете
Где
Категории → категория → Сообщения, Кнопки
Как выглядит панель
Где
Панели → default → сообщение и стиль
Логи и транскрипты
Где
Настройки → Логи
Что делать с каналом при закрытии
Где
Настройки → Общие → Действие при закрытии
Подробнее
Закрытие
Кому запретить тикеты
Где
Чёрный список
Подробнее
Чёрный список

Без веб-панели

Всё то же можно сделать командами: /staff add, /category add, /panel …, /config set. Список — в разделе Команды. Веб-панель удобнее для матрицы прав, оформления embed’ов и вопросов формы.