Настройте первую категорию тикетов
В TicketCord «категория» - это категория каналов Discord, сворачиваемый заголовок в сайдбаре сервера. Быстрый путь - команда /setup, ручной - ниже.
Что значит «категория» в TicketCord
Мы используем встроенные категории каналов Discord - отдельной концепции учить не нужно. Каждый новый тикет становится текстовым каналом внутри выбранной вами категории, а бот управляет правами на уровне каждого канала, чтобы его видели только автор запроса и команда.
Быстрый путь: /setup
Вместо ручного создания всего подряд запустите /setup на своём сервере. Команда доступна только пользователям с правом Discord Administrator и настраивает всю Discord-часть за один заход:
- Создаёт категорию Tickets для открытых тикетов и категорию Closed Tickets.
- Создаёт две роли команды - роль Ticket Admin с полными правами на тикеты и роль Ticket Support с доступом на чтение и ответы. (На бесплатном тарифе они называются TicketCord Admin / TicketCord Support.)
- Применяет переопределения прав: обе роли команды видят тикеты и действуют в них,
@everyone- запрещено. - Переставляет новые роли сразу под собственную роль бота, чтобы иерархия ролей Discord позволяла боту ими управлять.
Чтобы команда сработала, боту нужен либо Administrator, либо Manage Channels + Manage Roles на уровне сервера (приглашение запрашивает их по умолчанию). Если на сервере включено требование Discord о 2FA для модераторских действий, то у аккаунта, создавшего бота в Discord Developer Portal, тоже должна быть включена 2FA - это правило Discord, не наше.
Если у вас уже есть похожие категории или роли
Прежде чем что-либо создавать, /setup сканирует сервер на наличие категорий и ролей, чьи имена похожи на прежнюю настройку тикетов (например, «Tickets», «Closed Tickets», «Ticket Admin», «Ticket Support»). Если такие находятся, вы получаете три кнопки:
- Использовать существующие - оставить текущие ресурсы нетронутыми; вы сами укажете их в дашборде.
- Создать всё равно - создать новые со слегка другими именами, чтобы не было конфликтов.
- Отмена - выйти, ничего не меняя.
Настройку всё равно нужно завершить на сайте
Вот что чаще всего упускают. /setup создаёт только инфраструктуру на стороне Discord. Он не сообщает TicketCord, какие категории и роли использовать - это делается в дашборде. После выполнения команды вернитесь в Конфигурацию и выберите новые ресурсы в мастере настройки. Без этого шага тикеты по-прежнему не будут открываться.
Или: создайте категории сами
- На сервере создайте категорию с названием вроде Открытые тикеты.
- По желанию создайте вторую с названием Закрытые тикеты - TicketCord может переносить решённые каналы туда вместо удаления, что полезно для истории аудита.
- Сделайте обе категории приватными по умолчанию: в правах категории запретите View Channel для
@everyoneи разрешите его роли команды и боту TicketCord.
Укажите их TicketCord
Откройте мастер настройки в дашборде или перейдите в Конфигурация > Каналы. Выберите категорию для открытых тикетов - можно выбрать несколько, чтобы тикеты распределялись между ними по мере заполнения (Discord ограничивает каждую категорию 50 каналами). Если вы создали категорию для закрытых, укажите её как место для закрытых тикетов.
Обе настройки принимают список, так что позже можно добавить ещё категории, не заменяя уже выбранные.
Что бот делает с правами
Когда клиент открывает тикет, TicketCord создаёт новый текстовый канал внутри категории открытых и добавляет три переопределения прав: запрещает @everyone View Channel, даёт автору запроса View + Send + Read History и даёт то же самое ролям команды. Права на уровне категории остаются нетронутыми.
Что дальше
Теперь тикетам есть куда попадать - можно создать панель тикетов, чтобы у клиентов была кнопка.