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