Транскрипты и логи
Транскрипт — HTML-файл со всей перепиской тикета, создаётся при закрытии. Лог — поток событий (открыт, закрыт, взят в работу…) в канал логов (категории или сервера) и в раздел «Логи» веб-панели.
Транскрипт
| Вопрос | Ответ |
|---|---|
| Когда создаётся | При любом закрытии: кнопкой, командой, автозакрытием, при выходе автора, из веб-панели. /ticket delete транскрипт не делает. |
| Что внутри | Все сообщения канала с автором и временем, вложения ссылками, embed’ы, приветствие и ответы формы. |
| Куда отправляется | Файлом — в один канал: канал транскриптов (категория → сервер), а если он не задан — в канал логов. И всегда — в веб-панель → Транскрипты. В личные сообщения — пока нет: Lolka не доставляет личные сообщения от ботов. |
| Упоминания | Пользователи, роли и каналы показываются именами (@Егор, @Модератор, #общий) — как в чате; имена запоминаются в момент закрытия, поэтому не пропадают, когда человек уходит с сервера. Если имя неизвестно — голый id. Клик по упоминанию копирует id. Так же в карточке тикета в веб-панели. |
| Кто видит | Персонал и админы — в канале и в веб-панели. Автор — если у него есть доступ к каналу транскриптов. Приватный тикет — исключение: его транскрипт не уходит в канал транскриптов, а в веб-панели его видят только администраторы, взявший, тот, кто сделал тикет приватным, и участники. |
| Сколько хранится | По сроку хранения сервера — по умолчанию 180 дней после закрытия, не больше года (Настройки → Хранение); раньше — если тикет уничтожен в веб-панели или выполнен полный /ticket reset. Автоудаление каналов транскрипт не трогает; файл, отправленный в канал транскриптов, остаётся в канале. |
Пусто в обоих — файл уходит в канал логов; в веб-панели он есть всегда.
Раздел «Транскрипты» в веб-панели
Таблица: номер, автор, категория, сколько сообщений, дата закрытия. Действия — открыть превью, скачать HTML, скачать все одним ZIP-архивом. Кнопка «Транскрипт» в закрытом канале отдаёт файл только нажавшему (или, если так настроено, кладёт его в канал тикета). Не чаще раза в минуту: каждому — свой файл, в канал тикета — один на всех.
Поиск
Одно поле ищет сразу в двух местах: по списку транскриптов (номер, тема, автор) и по тексту переписки. Находки в переписке — ниже списка: тикет, сколько совпадений и до трёх кусков текста вокруг слова, со ссылками на транскрипт и на сам тикет. Находятся и тикеты, у которых транскрипт выключен, — переписка хранится в базе.
Логи
Каждое событие — embed с номером тикета, панелью, автором и деталями (причина закрытия, кто закрыл). Что писать в лог, задаётся один раз в настройках сервера; ничего не выбрано — пишутся все события. Категория может задать свой список — тогда для её тикетов действует он.
Сюда же бот сам пишет, если у него отняли нужные права («Управлять каналами», «Управлять ролями» и другие): раз в сутки он сверяет свои права и сообщает, чего не хватает и что из-за этого не работает, — и ещё раз, когда права вернули. Одно и то же каждый день не повторяется.
События
ticket_created- Событие
- Открыт
- Детали в логе
- Автор, категория, панель
ticket_closed- Событие
- Закрыт
- Детали в логе
- Кто закрыл, причина
ticket_reopened- Событие
- Переоткрыт
- Детали в логе
- Кто
ticket_deleted- Событие
- Удалён
- Детали в логе
- Кто
ticket_claimed- Событие
- Взят в работу
- Детали в логе
- Кто
ticket_unclaimed- Событие
- Тикет снят с сотрудника
- Детали в логе
- Кто
ticket_renamed- Событие
- Переименован
- Детали в логе
- Новое имя
ticket_escalated- Событие
- Эскалирован
- Детали в логе
- Из какой категории в какую
ticket_private- Событие
- Приватность
- Детали в логе
- Кто скрыл тикет от персонала или вернул
transcript_saved- Событие
- Транскрипт сохранён
- Детали в логе
- Канал с файлом (если файл сам ушёл в канал логов — строки нет)
message_deleted- Событие
- Сообщение удалено в тикете
- Детали в логе
- Автор, текст
user_added- Событие
- Участник добавлен
- Детали в логе
- Кто кого
user_removed- Событие
- Участник убран
- Детали в логе
- Кто кого
Раздел «Логи» в веб-панели
История действий по всем тикетам сервера: время, действие, пользователь, панель, детали. Не зависит от канала логов и фильтра событий — пишется всегда.