Объявления VTC

Система объявлений VTC позволяет вашему персоналу автоматически публиковать обновления в Discord, когда в вашей VTC происходит что-то важное. Примеры включают: вступление нового участника, отправку заявки на рекрутинг или отмену мероприятия.

Сообщения отправляются через вебхуки Discord, которые вы создаёте на своём собственном сервере. Вы сами выбираете, о каких именно событиях нужно объявлять и как должно выглядеть каждое конкретное сообщение.

Требования

Модуль VTC Announcements должен быть включен для вашей VTC на платформе TrucklineMP.
Вам нужен Discord-сервер, на котором у вас есть права создавать вебхуки (Настройки сервера → Интеграции → Вебхуки).
Сотрудникам, настраивающим объявления, необходимы соответствующие разрешения VTC (см. раздел Разрешения ниже).

Доступ к объявлениям

Откройте профиль вашей VTC и перейдите в раздел Manage.
Выберите пункт Announcements в боковом меню управления (находится под Members).
Добавьте вебхук, а затем включите нужные вам события.

Вы можете добавить до 10 вебхуков на одну VTC. Используйте несколько вебхуков, если хотите направлять разные темы в разные каналы (например, один канал для рекрутинга, а другой для мероприятий).

Настройка вебхука

Создание вебхука в Discord

В приложении Discord откройте нужный канал.
Перейдите в Настроить канал → Интеграция → Вебхуки → Новый вебхук.
Скопируйте URL-адрес вебхука. Он выглядит как https://discord.com/api/webhooks/....

Добавление вебхука в TrucklineMP

На странице Announcements нажмите Add webhook.
Задайте ему понятное имя (например, Лог персонала или Оповещения рекрутинга).
Вставьте скопированный URL-адрес Discord-вебхука и сохраните.

URL-адреса вебхуков хранятся в зашифрованном виде. После создания в списке будет отображаться только замаскированная версия адреса.

Разрешения

Назначаются через руководство Роли и разрешения VTC:

Разрешение	Назначение
`announcements.manage`	Создание, редактирование и удаление вебхуков; изменение шаблонов событий; экспорт конфигурации
`announcements.view`	Просмотр вебхуков и журнала доставки сообщений
`announcements.test`	Отправка тестовых сообщений без права на полное управление

Выдавайте право manage только руководству или отделу кадров HR. Выдавайте view сотрудникам, которым нужно лишь убедиться в успешной доставке сообщений. Разрешение test полезно для стажёров, которым нужно проверить работоспособность без изменения боевой конфигурации.

Настройка событий

У каждого вебхука есть свой собственный список событий. Разверните нужную группу (Участники, Рекрутинг, Мероприятия и т.д.), затем включайте или отключайте отдельные события.

Шаблоны по умолчанию

Большинство событий поставляются с разумным стандартизированным оформлением Discord-сообщения. Оставьте галочку Use default message template включенной, если вам не требуется полный контроль над дизайном.

Пользовательские шаблоны

Отключите использование шаблона по умолчанию, чтобы отредактировать:

Текст сообщения (необязательный обычный текст над карточкой)
Заголовок, описание, URL, цвет, подвал
Имя пользователя и аватар вебхука переопределение только для этого конкретного события

Используйте переменные (список которых приведён в боковой панели на вкладке настроек) для вставки актуальных данных. Пример: **{member.name}** присоединился к {vtc.name}.

Массовые действия

All on / All off в заголовке каждой группы включает или отключает сразу все события в этой группе.
Пресеты Minimal, Detailed staff log и Public-friendly применяют готовую стартовую конфигурацию. Detailed включает вообще все события; Public-friendly включает меньший, безопасный для участников набор.

Упоминание роли (необязательно)

Для каждого события вы можете задать ID роли для пинга (пинг роли Discord). Когда событие сработает, в сообщение будет добавлен тег <@&roleId>, чтобы соответствующая роль получила уведомление.

Условная доставка (необязательно)

К каждому событию можно добавить условия срабатывания:

Тихие часы с указанием часового пояса, времени начала и окончания (в это окно объявления будут игнорироваться).
Только при открытом наборе (срабатывает, только если в вашей VTC открыт рекрутинг).
Требовать наличие роли (срабатывает, только если целевой участник обладает определённой ролью в VTC).

Переменные шаблонов

Переменные автоматически заменяются на актуальные значения при отправке сообщения. Основные переменные:

Переменная	Значение
`{vtc.name}`	Отображаемое название VTC
`{vtc.handle}`	Идентификатор VTC (со знаком @)
`{vtc.url}`	Ссылка на публичный профиль VTC
`{member.name}`	Имя участника, которого касается событие
`{actor.name}`	Имя сотрудника персонала, выполнившего действие
`{role.name}`	Название роли
`{application.id}`	ID заявки на вступление
`{news.title}`	Заголовок опубликованной новости
`{event.name}`	Название мероприятия
`{event.url}`	Ссылка на страницу мероприятия
`{reason}`	Текст причины или примечания
`{timestamp}`	Время события в часовом поясе UTC

Пользовательский интерфейс отображает полный список всех поддерживаемых переменных. Нажмите на любую из них, чтобы скопировать её в свой шаблон.

Поддерживаемые события

События сгруппированы в интерфейсе управления. Все они отключены по умолчанию, за исключением присоединения участника, выхода участника и исключения участника для новых вебхуков.

Участники

Участник присоединился
Участник покинул VTC
Участник исключён
Роль назначена участнику
Роль снята с участника

Рекрутинг

Заявка отправлена
Заявка одобрена
Заявка отклонена
Заявка отозвана

Приглашения

Приглашение создано
Приглашение использовано
Приглашение отозвано

Новости

Новость опубликована
Новость обновлена
Новость удалена

Мероприятия

Мероприятие создано
Мероприятие обновлено
Мероприятие отменено
Объявление на мероприятии (сообщение персонала для участников)
Статус RSVP изменён
Отметка о присутствии
Участник одобрен (если требуется ручное одобрение)
Мероприятие отменено автоматически (нет регистраций до начала)

Роли

Роль создана
Роль обновлена
Роль удалена

Управление

Права собственности переданы
Запись добавлена в чёрный список
Запись удалена из чёрного списка
Настройки обновлены
Рекрутинг открыт или закрыт
VTC расформирована
Discord-сервер отвязан от VTC

Верификация

Заявка на верификацию отправлена
Верификация одобрена
Верификация отклонена

Режимы доставки

Мгновенный (по умолчанию)

Каждое включенное событие отправляется в Discord сразу же, как только оно происходит. Неудачные отправки повторяются автоматически (до трёх попыток с увеличивающимся интервалом).

Ежедневная сводка

Когда на вебхуке включена daily digest, события ставятся в очередь и объединяются в единый ежедневный сводный пост вместо немедленной отправки. Полезно для VTC с высокой активностью, которые хотят иметь канал для персонала без постоянного потока пингов.

Внутреннее дублирование в приложении (необязательно)

Вы можете включить параметр mirror in app для вебхука. При срабатывании объявления персонал с разрешением announcements.view также получит внутрисистемное уведомление прямо на сайте TrucklineMP. Эта функция не заменяет Discord; она даёт сотрудникам резервную ленту уведомлений внутри самой платформы.

Тестирование, экспорт и дублирование

Кнопка Send test берёт случайное событие-образец и публикует предпросмотр сообщения в Discord. Между тестовыми отправками есть небольшая задержка.
Кнопка Duplicate копирует конфигурацию событий вебхука в новый вебхук (по умолчанию он создаётся отключенным, пока вы его не активируете).
Кнопка Export скачивает конфигурацию ваших шаблонов в виде файла JSON для резервного копирования или переноса в другую VTC.

Всегда выполняйте тестовую отправку после изменения шаблонов или URL-адресов вебхуков.

Журнал доставки

Откройте вкладку Delivery log, чтобы посмотреть последние отправки для выбранного вебхука.

Фильтруйте логи по успеху или неудаче отправки или по системному имени события.
Строки с ошибками показывают HTTP-статус и текст ошибки от серверов Discord.
Используйте кнопку Resend на строке с ошибкой, чтобы поставить новую попытку отправки в очередь.

Если вебхук выдаёт ошибку слишком много раз подряд, он может быть автоматически отключен для защиты вашего канала от сломанных ссылок. Включите его обратно в настройках вебхука после исправления адреса Discord. При возникновении такой ситуации на странице появится предупреждающий баннер.

Опции уровня вебхука

Помимо настроек каждого отдельного события, сам вебхук поддерживает:

Имя пользователя и аватар по умолчанию (используются, если конкретный шаблон события не переопределяет их)
Переключатель Включено / Отключено для всего вебхука целиком
Режим доставки (мгновенный или ежедневная сводка)

Советы и рекомендации

Используйте разные каналы для разной аудитории. Публичному каналу #announcements могут понадобиться только уведомления о вступлении новых участников и публикации новостей. Приватный канал #staff-log может использовать полный пресет Detailed.

Начинайте с малого. Включите несколько событий, протестируйте их, а затем расширяйте список. Если включить всё сразу, будет сложно отследить неверно настроенные шаблоны.

Держите ссылки на вебхуки в секрете. Любой человек, у которого есть этот URL, может отправлять сообщения в ваш канал. Если ссылка утекла, удалите вебхук в Discord, создайте новый и обновите его в TrucklineMP.

Соотносите разрешения с уровнем ответственности. Далеко не каждому офицеру нужно право announcements.manage. Разрешений на просмотр и тестирование достаточно для многих должностей.

Проверяйте журнал доставки после переносов конфигураций. Если Discord возвращает ошибку 404, значит, вебхук был удалён на стороне самого Discord. Создайте новый вебхук и вставьте новый URL.

Устранение неполадок

Сообщения не появляются в Discord

Убедитесь, что сам вебхук включен и конкретное событие также включено.
Проверьте Журнал доставки на наличие ошибок.
Убедитесь, что вебхук всё ещё существует в Настройках сервера Discord.
Проверьте, включен ли модуль VTC Announcements для вашей компании.

Сообщения перестали приходить, хотя раньше всё работало

Возможно, вебхук был автоматически отключен после серии неудачных попыток доставки. Исправьте URL и включите его снова.
Возможно, Discord удалил ваш вебхук. Создайте новый.

Тестовые сообщения отправляются, а реальные события — нет

Возможно, событие отключено, или его блокирует какое-либо условие (тихие часы, фильтр открытого рекрутинга, требование роли).
В режиме ежедневной сводки сообщения ставятся в очередь до момента публикации самой сводки.

Неправильные имена или отсутствующие данные в сообщении

Проверьте ваши переменные шаблона. Опечатка вроде {member.name} вместо {target.name} кардинально меняет то, что будет показано.
Пользовательские шаблоны, в которых пропущены переменные, всё равно будут работать, но статический текст не будет содержать никаких динамических данных.

Связанные руководства

Роли и разрешения VTC: выдача разрешений на управление объявлениями
Управление участниками VTC: действия, запускающие события участников
Рекрутинг в VTC: события заявок и переключение статуса набора
Верификация Discord для VTC: не связано с объявлениями; привязывает ваш сервер для отображения в профиле
Общие настройки: идентификация VTC и параметры рекрутинга