Создание вашего приложение

Шаги, упомянутые далее в этой статье, по сути, яляются копией шагов упомянутых в документации. Таким образом, вы можете выполнить эти действия из любого ресурса.

Примечание

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

Создание аккаунта бота

Чтобы работать с библиотекой и Discord API в целом, мы должны сначала создать аккаунт бота в Discord.

Создание аккаунта бота - довольно простой процесс.

Убедитесь, что вы авторизированы в Discord.
Перейдите на страницу приложений.
Нажмите на кнопку New Application.
Дайте приложению имя и нажмите Create.
Создайте аккаунт бота, перейдя на вкладку Bot и нажав Add Bot.
- Нажмите Yes, do it! для продолжения.
Убедитесь, что установлен флажок Public Bot, если вы хотите, чтобы другие могли приглашать вашего.
- Вы также должны убедиться, что флажок Require OAuth2 Code Grant снят, если только вы не разрабатываете службу, которая в этом нуждается. Если вы не уверены, то оставьте его снятым.
Скопируйте токен, используя кнопку Copy.
- Это не Client Secret на странице общей информации.

И это всё. Теперь у вас есть аккаунт бота, и вы можете войти с помощью этого токена.

Что касается токена бота

Предупреждение

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

Что такое токен?

Следует отметить, что токен по сути, является паролем вашего бота. Вы никогда не должны делиться им с кем-то другим. При этом кто-то может войти в вашего бота и совершать вредоносные действия, например, покидать сервера, банить всех участников на серверах или намеренно упоминать всех.

Токены выглядят следующим образом: OTA4MjgxMjk4NTU1MTA5Mzk2.YYzc4A.TB7Ng6DOnVDlpMS4idjGptsreFg (не беспокойтесь, мы сбросили этот токен!) Если он будет немного короче и больше похож на этот: CR8UbizwLgyES9LuHK7eIrXHbRTuqoEs, значит вместо токена вы скопировали свой Client Secret. Обязательно скопируйте токен, если вы хотите, чтобы ваш бот работал!

Сценарий утечки токена

Давайте представим, что у вас есть бот, находящийся на более чем 1000 серверах, и потребовалось много-много месяцев написания и терпения, чтобы получить его на этом количестве серверов. Ваш токен куда-то утёк, и теперь он у кого-то другого. Этот человек может:

Спамить на каждом сервере, на которых находится ваш бот;
Рассылать спам в личные сообщения большому количеству пользователей;
Удалять большое количество каналов;
Выгонять или банить большое количество участников на серверах;
Заставить вашего бота покинуть все серверы, к которым он присоединился;
Доступ и повреждение вашего сервера.

Всё это и многое, многое другое. Звучит довольно ужасно, не так ли? Поэтому убедитесь, что ваш токен находится в максимальной безопасности! На странице начальных файлов мы рассмотрим, как безопасно хранить ваш токен в файле конфигурации.

Осторожно

Если вы случайно "слили" свой токен, нажмите на кнопку Regenerate как можно скорее. Это уничтожит ваш старый токен и создаст новый. Теперь вам нужно использовать новый токен для входа.

Системные сообщения Discord

Системные сообщения - это официальные сообщения, которые Discord отправляет, чтобы предупредить вас о проблеме с вашим аккаунтом. Эти сообщения могут варьироваться от различных проблем с оплатой, обновлений обращений в службу поддержки и предупреждений о нарушении ToS. Вы также можете ожидать системного сообщения, если ваш токен бота был опубликован в интернете публично и был найден Discord.

Такое сообщение будет выглядеть следующим образом:

System message

Осторожно

Поскольку мы не знаем, в какой степени Discord ищет токены бота или сколько времени требуется для информирования пользователя о том, где был найден бот, мы рекомендуем не полностью полагаться на эту функцию. Но в случае, если ваш токен бота будет найден в интернете публично (скажем, в репозитории GitHub), вы можете ожидать, что Discord отправит системное сообщение на аккаунт, к которому привязан бот.

Обратите внимание, что Discord никогда не будет запрашивать ваш пароль или токен учетной записи, а системное сообщение никогда не будет запрашивать то же самое. Системные сообщения из Discord будут иметь проверенный тег СИСТЕМА, а в строке внизу личных сообщений будет сказано - "В данной ветке отображаются уведомления Discord".

System DM

Вы можете прочитать больше о подлинности этих сообщений в этой статье.

Приглашение вашего бота

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

Убедитесь, что вы авторизированы в Discord.
Перейдите на страницу приложений.
Нажмите на страницу вашего бота.
Перейдите на вкладку OAuth2.
Поставьте галочку возле botв поле scopes.
- Если вы хотите использовать слеш команды и другие взаимодействия в вашем боте, обязательно поставьте галочку возле applications.commands в поле scopes.
Отметьте права, необходимые для работы вашего бота в поле Bot Permissions.
- Пожалуйста, помните про последствия требования права Administrator (Администратор).
- Владельцы ботов должны иметь включённый 2FA для определённых действий и прав при добавлении на серверах, на которых включён общесерверный 2FA. Прочтите страницу поддержки по 2FA для дополнительной информации.
Теперь полученное приглашение можно использовать для добавления вашего бота на сервер. Скопируйте и вставьте его в свой браузер, выберите сервер, на который вы хотите пригласить бота и нажмите Авторизовать
Информация
Для этого человеку, добавляющему бота, необходимо право "Управление сервером".