Twist Documentation

Документация Twist

Twist — панельный Discord-бот для автоматизации сервера: временные голосовые комнаты, тикеты, аудит действий, автороли, верификация ролей и уведомления из VK/Twitch.

Добавление бота на сервер

  1. Откройте сайт twistbot.ru и войдите через Discord.
  2. Нажмите на карточку нужного сервера или кнопку «Пригласить».
  3. В окне Discord подтвердите добавление бота.

Для корректной работы рекомендуется оставить боту право Administrator. Если право снято, редактирование настроек в панели будет заблокировано.

Первичная настройка

  1. Перейдите в панель управления.
  2. Выберите сервер из списка «Мои серверы».
  3. Откройте нужную вкладку и нажмите «Сохранить» после изменений.

Временные голосовые

Модуль создает личные голосовые комнаты автоматически, когда пользователь заходит в хаб-канал.

Как настроить

  1. Откройте сервер в панели и перейдите во вкладку Голосовые каналы.
  2. В поле Текстовый канал выберите канал, куда бот отправит панель управления.
  3. В поле Голосовой хаб выберите канал-триггер для создания временных комнат.
  4. Нажмите Сохранить.

Как проверить

  • Зайдите в выбранный хаб под обычным участником.
  • Убедитесь, что бот создал отдельную временную комнату.
  • Проверьте, что в текстовом канале доступна панель управления комнатой.

Если хаб не выбран, комнаты создаваться не будут.

Тикеты

Тикеты позволяют участникам создавать обращения через кнопку в канале, а команде — обрабатывать их в отдельных каналах.

Что рекомендуется заполнить сразу

  • Категория для новых тикетов — куда бот будет создавать каналы обращений.
  • Роли поддержки — кто видит и обрабатывает тикеты.
  • Канал панели — где будет опубликована кнопка «Открыть тикет».
  • Канал логов — куда отправлять служебные события по тикетам.

Порядок настройки

  1. Перейдите во вкладку Тикеты.
  2. Включите модуль переключателем.
  3. Заполните категории, роли и тексты панели/внутреннего сообщения.
  4. Нажмите Сохранить.
  5. Нажмите Отправить панель в канал, чтобы опубликовать кнопку.

Как проверить

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

Аудит

Аудит фиксирует действия на сервере: сообщения, голосовые события, роли, каналы, модерацию и приглашения.

Как настроить

  1. Откройте вкладку Аудит и включите модуль.
  2. Выберите канал логов — туда будут приходить события.
  3. При необходимости укажите игнорируемые каналы/категории.
  4. Слева выберите группы событий и отметьте нужные переключатели.
  5. Нажмите Сохранить.

Как проверить

  • Сделайте тестовое действие (например, отредактируйте сообщение).
  • Проверьте, что событие появилось в выбранном канале логов.

Если событий слишком много, сначала включите только ключевые группы (Messages + Moderation).

VK/Twitch уведомления

Модуль публикует новости со стен VK-сообществ и уведомления о старте стримов Twitch прямо в Discord-каналы.

VK: порядок настройки

  1. Откройте вкладку Новости VK/Twitch и блок Новости ВК.
  2. Нажмите Добавить ещё и заполните связку:
    • пользовательский токен VK,
    • ID группы VK,
    • канал Discord для публикаций.
  3. При необходимости включите упоминания (`@everyone`/роли).
  4. Нажмите Сохранить, затем Отправить тестовую новость.

Twitch: порядок настройки

  1. В блоке Twitch добавьте связку: логин канала + канал Discord.
  2. Настройте упоминания, если нужно.
  3. Нажмите Сохранить и выполните тестовую отправку.

Если уведомления Twitch недоступны, обратитесь к администрации бота для включения интеграции Twitch на стороне сервиса.

Автороли и верификация

Автороли

Выдает выбранную роль каждому новому участнику при входе на сервер.

  1. Перейдите во вкладку Автороли.
  2. Включите переключатель Выдавать автороль.
  3. Выберите роль и нажмите Сохранить.

Роль бота должна быть выше выдаваемой роли в иерархии Discord.

Верификация ролей

Позволяет выдать роли через кнопки в сообщении. Можно включить подтверждение модератором.

  1. В блоке Верификация ролей выберите канал панели.
  2. Заполните embed: заголовок, описание, цвет, при необходимости изображение.
  3. Добавьте кнопки: для каждой кнопки укажите роль и текст.
  4. Если нужен ручной контроль — включите Требовать подтверждение и выберите канал подтверждения.
  5. Нажмите Сохранить черновик, затем Опубликовать панель в канал.

Как проверить

  • Нажмите кнопку верификации под тестовым аккаунтом.
  • Проверьте выдачу роли (или отправку запроса модераторам, если включено подтверждение).
  • Убедитесь, что событие отображается в блоке опубликованных панелей.

Требования к правам

  • У пользователя в Discord должны быть права администратора на сервере.
  • Бот должен иметь право Administrator для полноценной работы.
  • Без админки у бота изменения настроек в панели недоступны.

FAQ

Почему не открывается сервер в панели?

Проверьте, что бот добавлен на сервер и вы вошли под нужным Discord-аккаунтом.

Почему кнопки сохранения отключены?

Скорее всего, у бота нет права Administrator на этом сервере.