01Что вам нужно
Нужны три вещи. Во-первых, аккаунт Twitch, вошедший в панель управления Bagel. Во-вторых, канал Premium: Discord это бета-модуль, который открыт только для каналов Premium, пока идёт бета-тестирование. В-третьих, аккаунт Discord, которому принадлежит сервер или у которого есть «Управлять сервером». Bagel можно добавить только на сервер, где у вас есть одно из этих условий.
02Добавьте Bagel на свой сервер
- Откройте страницу Discord
В меню панели управления откройте «Discord».
- Запустите подключение
Выберите «Добавить сервер». Если кнопка неактивна, см. таблицу в конце этого руководства.
- Войдите в Discord, если потребуется
Откроется Discord. Используйте аккаунт Discord, которому принадлежит сервер или у которого есть право «Управлять сервером». Bagel один раз запрашивает у Discord ваш список серверов, чтобы построить следующую страницу. Список никогда не сохраняется.
- Найдите свой сервер
В разделе «Серверы под вашим управлением» найдите свой сервер. Используйте «Найти сервер», чтобы искать по названию. Сервера нет в списке? Нужно право «Управлять сервером» на нём.
- Выберите «Добавить Bagel сюда»
Нажмите «Добавить Bagel сюда» в этой строке. Discord откроет экран подтверждения.
- Оставьте все права отмеченными и авторизуйте
Discord покажет права, которые запрашивает Bagel. Панель управления просит оставить все их отмеченными. Затем выберите «Авторизовать», кнопку, указанную в панели управления для экрана подтверждения Discord.
- Пусть Bagel настроит сервер
Bagel входит на сервер и настраивает его. Панель управления открывает страницу этого сервера. Если на сервере уже были каналы, Bagel оставит их и сообщит вам об этом.
Серверов пока нет? На странице Discord кнопка «Создать мой Discord» создаст сервер по шаблону Bagel. Каждый сервер хранит свои каналы, роли и настройки, и можно подключить сколько угодно серверов.
03Основные права, которые запрашивает Bagel
| Право | Зачем Bagel его запрашивает |
|---|---|
| Выгонять участников, Банить участников, Тайм-аут участников | Модерация. |
| Управлять ролями, Управлять каналами | Для настройки сервера: каналы и роли, которые нужны Bagel. |
| Изменять никнейм | Для применения премиум-имени. Серверам, добавленным до того, как Bagel запросил это право, нужно «Авторизовать Bagel заново» (см. таблицу ниже). |
| Права на сообщения, голосовые каналы и журнал аудита, а также другие | Экран подтверждения Discord также перечисляет права на просмотр каналов, отправку и управление сообщениями, добавление реакций, встраивание ссылок, прикрепление файлов, чтение истории сообщений, подключение к голосовым каналам и перемещение в них участников, использование команд приложений и просмотр журнала аудита. Всего Bagel запрашивает 17 прав. Строки выше основные. |
04Чтение списка серверов
| Что говорит строка | Что можно сделать |
|---|---|
| «Bagel ещё не на этом сервере.» | Выберите «Добавить Bagel сюда». |
| «Bagel уже на этом сервере.» | Выберите «Открыть», чтобы управлять им. Выберите «Добавить Bagel снова», чтобы пройти экран подтверждения Discord заново, например если вы сняли галочку с права. |
| «Bagel нужно добавить снова, чтобы он работал на этом сервере.» | «Добавить Bagel снова» выделено. Выберите его и авторизуйте в Discord. |
| «Связан с другим каналом» | Другой канал Twitch уже использует этот сервер. Попросите владельца того канала открыть сервер в Bagel, перейти в «Настройки» и выбрать «Отключить». Затем добавьте сервер здесь снова. |
05Создание каналов и ролей
- Откройте свой сервер в панели управления
На странице Discord выберите «Открыть» рядом с сервером.
- Откройте его страницу настроек
В меню «Настройки сервера» выберите «Настройки».
- Найдите «Структура сервера»
Карточка «Структура сервера» объясняет, что делает кнопка.
- Выберите «Создать недостающие каналы и роли»
Bagel добавляет недостающие каналы и роли, которые ему нужны, и использует роли, закреплённые вами на странице «Роли». Ничего не удаляется. Сообщение «Сервер настроен.» подтверждает это.
Если на сервере уже были свои каналы, Bagel оставит их и добавит только нужное. Остальные выберите на странице «Каналы».
06Исправление порядка ролей
Бот может управлять только ролями, которые стоят ниже его самой высокой роли. Если Bagel не может выдать роль, его роль стоит слишком низко в списке. Вот решение.
- Откройте настройки сервера в Discord
В Discord откройте «Настройки сервера» для сервера.
- Откройте «Роли»
Выберите «Роли».
- Перетащите роль Bagel выше
Перетащите роль Bagel выше ролей, которыми он управляет, затем сохраните.
- Повторите попытку в панели управления
Повторите действие, которое не удалось. Если Discord не позволяет переместить роль, попросите владельца сервера сделать это.
07Отключить или удалить Bagel
- Откройте страницу «Настройки сервера»
На странице Discord выберите «Открыть» рядом с сервером, затем «Настройки» в меню «Настройки сервера».
- Перейдите в «Опасные действия»
Прокрутите вниз до «Опасные действия».
- Выберите «Отключить»
Подтвердите «Отключить Discord?», нажав «Отключить». Bagel прекращает публикации и забывает, к какому серверу привязан этот канал. Ваши каналы и роли остаются без изменений. Bagel остаётся на сервере.
- Чтобы убрать бота, выгоните его в Discord
Панель управления советует нажать правой кнопкой мыши на Bagel в списке участников сервера в Discord и выбрать «Выгнать». Для этого нужно право «Выгонять участников» или статус владельца сервера. Если вы не видите «Выгнать», попросите владельца сервера.
08Если что-то пошло не так
| Что вы видите | Что это значит | Что делать |
|---|---|---|
| «Только Premium во время бета-тестирования» | Ваш канал не Premium. Во время бета-тестирования Discord доступен только для каналов Premium. | Выберите «Посмотреть тарифы». Вернитесь к «Discord», когда Premium будет активен. |
| «Discord находится в бета-тестировании и доступен только для каналов Premium.» | То же ограничение, которое показывается, когда действие Discord отклонено. | Переведите канал на Premium и повторите попытку. |
| «Premium для этого канала управляется {login}. Попросите этого человека перейти на Premium на его странице «Оплата».» | Вы модератор с общим доступом, и раздел «Оплата» вам не открыт. | Попросите владельца канала перейти на Premium на его странице «Оплата». |
| Кнопка «Добавить сервер» неактивна, или «Discord не настроен на этом развёртывании (отсутствует идентификатор клиента или адрес перенаправления).» | Подключение к Discord не настроено на стороне Bagel. Ваш аккаунт здесь ни при чём. | Свяжитесь с поддержкой через страницу «Контакты» (itsbagelbot.com/contact) или на support@itsbagelbot.com. |
| «Вы отменили действие на экране Discord, поэтому ничего не добавлено. Выберите «Добавить сервер», чтобы повторить.» | Вы закрыли или отменили экран подтверждения Discord. | Снова выберите «Добавить сервер» и на экране Discord выберите «Авторизовать». |
| «Discord не показал ни одного сервера, куда можно добавить бота. Нужно быть владельцем или иметь право «Управлять сервером».» | У использованного аккаунта Discord нет серверов, куда можно добавить Bagel. | Используйте аккаунт Discord, которому принадлежит сервер или у которого есть право «Управлять сервером». |
| «Нет серверов, куда можно добавить Bagel» | Список пуст: «Bagel может присоединиться только к серверу, которым вы владеете, или где у вас есть право «Управлять сервером».» | Попросите владельца выдать право «Управлять сервером» или выберите «Создать мой Discord», чтобы начать с шаблона Bagel. |
| «Связан с другим каналом» | Другой канал Twitch уже использует этот сервер. | Попросите владельца того канала выбрать «Отключить» на странице «Настройки сервера» в Bagel. Не удаляйте Bagel с сервера. |
| «Этот сервер Discord уже связан с другим каналом Twitch. Попросите владельца того канала открыть этот сервер в Bagel, перейти в «Настройки» и выбрать «Отключить». Затем добавьте сервер здесь снова.» | Вы авторизовали Bagel на сервере, который входит в настройки другого канала. | Попросите этого владельца выбрать «Отключить», затем добавьте сервер снова. |
| «Discord отклонил действие, потому что у Bagel на этом сервере не хватает права. В Discord откройте «Настройки сервера», затем «Роли», и перетащите роль Bagel выше ролей, которыми он управляет. Если вы сняли галочку с права при добавлении Bagel, выберите «Авторизовать заново» на странице «Настройки» этого сервера и оставьте все права отмеченными.» | Роль Bagel стоит слишком низко, или одно право было снято. | Следуйте разделу «Исправление порядка ролей» выше. Если вы сняли право, выберите «Авторизовать заново» и отметьте все права. |
| «Этот сервер добавлен до того, как Bagel запросил право «Изменять никнейм», поэтому премиум-имя здесь нельзя применить. Премиум-аватар работает. Выберите «Авторизовать Bagel заново», затем «Добавить Bagel снова» рядом с этим сервером.» | Сервер добавлен со старым списком прав. | Выберите «Авторизовать Bagel заново», затем «Добавить Bagel снова» рядом с сервером и оставьте все права отмеченными. |
| «Bagel нужно добавить снова, чтобы он работал на этом сервере.» | Bagel больше не на сервере или ему нужна новая авторизация. | Выберите «Добавить Bagel снова» в списке серверов. |
| «Discord не вернул сервер. Попробуйте добавить Bagel ещё раз.» | Discord завершил подключение, не указав сервер. | Выберите «Добавить сервер» и начните заново. |
| «Срок действия ссылки Discord истёк. Начните заново с добавления Bagel.» | Страница ждала слишком долго или открыта из старой вкладки. | Откройте «Discord» и снова выберите «Добавить сервер». |
| «Не удалось сохранить подключённый сервер. Попробуйте ещё раз.» | Bagel не смог сохранить привязку к вашему серверу. | Выберите «Добавить сервер» и повторите. |
| «Кто-то сохранил настройки этого сервера раньше вас. Обновите страницу и повторите попытку.» | Двое изменили один и тот же сервер одновременно. | Выберите «Перезагрузить», затем повторите изменение. |
| «Discord ограничивает запросы. Попробуйте через минуту.» | Discord замедляет запросы. | Подождите минуту и повторите. |
| «Discord не ответил. Повторите попытку через минуту.» | Discord не ответил вовремя. | Подождите немного и повторите. |
| «Операция заняла слишком много времени. Часть могла не выполниться: перезагрузите страницу, чтобы увидеть остальное.» | Действие превысило время ожидания и, возможно, выполнено лишь наполовину. | Перезагрузите страницу и проверьте результат. |
| «Этого канала или роли больше нет на сервере. Выберите другой.» | Канал или роль удалены в Discord. | Выберите другой или выберите «Создать недостающие каналы и роли». |
| «Ни один сервер Discord пока не подключён.» | К этому каналу не привязан ни один сервер, например после «Отключить». | Выберите «Добавить сервер». |
| «Некоторые настройки были недопустимы и оставлены без изменений.» или «Сохранено, но эти настройки оставлены без изменений: {fields}.» | Некоторые значения были отклонены и сохранили прежнее значение. | Проверьте поля с пометкой «Недопустимое значение: настройка сохранила предыдущее значение.» и исправьте их. |
| «Bagel не может писать сюда» или «Bagel больше не может писать в сохранённый канал. Дайте ему право «Отправлять сообщения» или выберите другой канал.» | У Bagel нет права «Отправлять сообщения» в этом канале. | Дайте Bagel право «Отправлять сообщения» в этом канале в Discord или выберите другой канал. |
| «Включите приём обращений и сохраните, прежде чем публиковать панель заново.» | Вы попросили опубликовать панель обращений заново, когда обращения выключены. | Включите приём обращений, сохраните и опубликуйте панель заново. |
| «Не удалось получить каналы и роли вашего сервера, поэтому выбор отключён. Ничего не изменено; попробуйте чуть позже.» | Discord не вернул каналы и роли сервера. | Подождите немного и перезагрузите страницу. |
| «Не удаётся связаться с сервером. Попробуйте через минуту.» | Панель управления не смогла загрузить ваши данные Discord. | Подождите немного и перезагрузите страницу. |
| «Не удалось отключить Discord.» или «Не удалось настроить этот сервер.» | Действие не завершилось. | Повторите. Если снова не получится, напишите в поддержку через страницу «Контакты» (itsbagelbot.com/contact) или на support@itsbagelbot.com. |
| Статус «Не в сети» или «Шлюз отключился и переподключается сам. Ничего делать не нужно.» | Bagel потерял соединение с Discord и переподключается сам. | Подождите несколько минут. Если в статусе написано «Авторизовать заново», выберите «Авторизовать Bagel заново», затем «Добавить Bagel снова» рядом с сервером. |
| «Произошла ошибка на нашей стороне. Попробуйте ещё раз, а если это повторится, сообщите в поддержку.» | Неожиданная ошибка на стороне Bagel. | Повторите, затем напишите в поддержку через страницу «Контакты» (itsbagelbot.com/contact) или на support@itsbagelbot.com, если это повторяется. |
| «Не удалось сохранить настройки Discord.» | Настройки страницы сервера не сохранены. | Повторите. Если снова не получится, перезагрузите страницу и повторите изменение. |
| «Не удалось опубликовать панель обращений заново.» | Discord не принял повторную публикацию панели обращений. | Повторите через минуту. Убедитесь, что Bagel может писать в канал обращений. |
| «Discord отклонил токен бота. Его нужно заменить, прежде чем бот вернётся.» | Проблема на стороне Bagel, показанная в статусе сервера. | В панели управления ничего делать не нужно. Если это продолжается, напишите в поддержку через страницу «Контакты» (itsbagelbot.com/contact) или на support@itsbagelbot.com. |
| «Теперь боту нужно несколько шардов. Вам ничего делать не нужно, мы займёмся этим.» | Проблема на стороне Bagel, показанная в статусе сервера. | Ничего делать не нужно. Подождите: команда Bagel занимается этим. |
| «Discord отклонил интенты шлюза. Вам ничего делать не нужно, мы займёмся этим.» | Проблема на стороне Bagel, показанная в статусе сервера. | Ничего делать не нужно. Подождите: команда Bagel занимается этим. |
| «Discord не одобрил привилегированные интенты, которые нужны этому боту. Вам ничего делать не нужно, мы займёмся этим.» | Проблема на стороне Bagel, показанная в статусе сервера. | Ничего делать не нужно. Подождите: команда Bagel занимается этим. |
| «Bagel присоединился к серверу. На нём уже была структура, и её не перестраивали. Bagel подхватил распознанные каналы; выберите остальные ниже.» | Bagel присоединился к серверу и сохранил ваши существующие каналы. | Выберите пустые каналы на странице «Каналы». |