Шаблоны и подстановки
Фигурные скобки в именах каналов, текстах сообщений и embed’ах заменяются на значения тикета. Неизвестный токен остаётся как есть; опечатка в шаблоне имени канала не ломает открытие — бот откатывается на стандартный шаблон.
Имя канала тикета
Категория → Поведение: три шаблона для состояний «открыт», «взят в работу», «закрыт». Имя всегда пересобирается из шаблона, а не из предыдущего имени, поэтому цепочка «взят» → снятие → закрытие → переоткрытие не копит мусор.
{number}- Значение
- Номер тикета; сколько цифр — настройка сервера
- Пример
- 0057
{user}- Значение
- Имя автора как есть — с пробелами, регистром и знаками; до 40 символов
- Пример
- Иван Петров
{panel}- Значение
- Имя панели, из которой открыт тикет, в том же виде
- Пример
- support
{staff}- Значение
- Имя сотрудника, взявшего тикет (для шаблона «взят»); до 15 символов
- Пример
- anna
{closed_by}- Значение
- Имя закрывшего (для шаблона «закрыт»); до 15 символов
- Пример
- anna
| Состояние | Стандартный шаблон |
|---|---|
| Открыт | ticket-{number}-{user} |
| Взят в работу | [{staff}]-ticket-{number}-{user} |
| Закрыт | closed-{number} |
Сообщения
Категория → Сообщения (и сообщение самой панели — на её странице): текст и embed каждого события. Доступные токены зависят от события.
{user}- Значение
- Упоминание автора тикета
- Где доступен
- Все события, кроме «Панель»
{number}- Значение
- Номер тикета с ведущими нулями
- Где доступен
- Все события, кроме «Панель»
{guild}- Значение
- Название сервера
- Где доступен
- Все события
{channel}- Значение
- Упоминание канала: тикета — или канала панели в сообщении «Панель»
- Где доступен
- Все события, кроме «Транскрипт»
{category}- Значение
- Название категории тикета («Общая», если её нет)
- Где доступен
- В тикете
{staff}- Значение
- Упоминание сотрудника, выполнившего действие
- Где доступен
- Взятие в работу, снятие, передача, эскалация
{reason}- Значение
- Причина закрытия (или «—»)
- Где доступен
- Подтверждение закрытия, закрытие
{from_category}- Значение
- Имя исходной категории
- Где доступен
- Эскалация
{to_category}- Значение
- Имя категории, куда передали
- Где доступен
- Эскалация
{moderator}- Значение
- Упоминание сотрудника
- Где доступен
- Участник добавлен
{target}- Значение
- Упоминание добавленного участника или того, кому передали тикет
- Где доступен
- Участник добавлен, передача тикета
{support}- Значение
- Упоминания ролей поддержки тикета (пингуют)
- Где доступен
- После приветствия
{messages_count}- Значение
- Число сообщений в транскрипте
- Где доступен
- Транскрипт
{open}- Значение
- Сколько тикетов уже открыто (у человека, в категории, на сервере или за период)
- Где доступен
- Отказы при открытии
{max}- Значение
- Сколько разрешено
- Где доступен
- Отказы при открытии
{period}- Значение
- Период лимита: «5 мин», «24 ч»
- Где доступен
- Отказ «за период»
{wait}- Значение
- Через сколько можно открыть снова
- Где доступен
- Отказ «за период»
{hours}- Значение
- Часы без активности
- Где доступен
- Причина автозакрытия
Приветствие категории («Приветствие в тикете» у категории) принимает те же подстановки, что сообщение «В тикете».
Кастомные команды и шаблоны ответов
Работают и в обычном тексте, и в embed’е. Переменные тикета вне его канала подставляются пустыми.
| Токен | Значение |
|---|---|
{user} | Упоминание того, кто вызвал команду (то же — {staff}) |
{guild} | Название сервера |
{channel} | Упоминание канала, где вызвана команда |
{author} | Автор тикета — в канале тикета |
{number} | Номер тикета — в канале тикета |
{category} | Тема тикета — в канале тикета |
{staff_name} | Имя того, кто вызвал, без упоминания |
{priority} | Приоритет тикета словом — в канале тикета |
{age} | Сколько тикет открыт — в канале тикета |
{support} | Упоминание ролей поддержки тикета — в канале тикета |
Форматирование
В текстах и embed’ах работает разметка платформы: **жирный**, *курсив*, `код`, упоминания <@id>, <@&id>, <#id>. Ссылки в embed’ах — [текст](url).