Botアカウント作成

ライブラリとDiscord APIを使用するには、BotのDiscordアカウントを用意する必要があります。

Botのアカウント作成はとても簡単です。

  1. Make sure you're logged on to the Discord website.

  2. Navigate to the application page

  3. 「New Application」ボタンをクリックします。

    The new application button.
  4. アプリケーションの名前を決めて、「Create」をクリックします。

    The new application form filled in.
  5. 「Bot」タブへ移動し、「Add Bot」をクリックしてBotユーザーを作成します。

    • 「Yes, do it!」をクリックして続行します。

    The Add Bot button.
  6. 他人にBotの招待を許可する場合には、 Public Bot にチェックを入れてください。

    • また、必要なサービスを開発している場合を除いて、 Require OAuth2 Code Grant がオフになっていることを確認する必要があります。わからない場合は チェックを外してください

    How the Bot User options should look like for most people.
  7. 「Copy」ボタンを使ってトークンをコピーします。

    • This is not the Client Secret at the General Information page.

    警告

    It should be worth noting that this token is essentially your bot's password. You should never share this with someone else. In doing so, someone can log in to your bot and do malicious things, such as leaving servers, ban all members inside a server, or pinging everyone maliciously.

    可能性は無限にあるので、絶対に トークンを共有しないでください

    誤ってトークンを流出させてしまった場合、可能な限り速急に「Regenerate」ボタンをクリックしましょう。これによって古いトークンが無効になり、新しいトークンが再生成されます。今度からは新しいトークンを利用してログインを行う必要があります。

以上です。 これでボットアカウントが作成され、そのトークンでログインできます。

Botを招待する

Botのユーザーを作成しましたが、現時点ではどのサーバーにも参加していない状態です。

Botを招待したい場合は、そのための招待URLを作成する必要があります。

  1. Make sure you're logged on to the Discord website.

  2. Navigate to the application page

  3. Botのページを開きます。

  4. 「OAuth2」タブへ移動します。

    How the OAuth2 page should look like.
  5. 「scopes」下にある「bot」チェックボックスを選択してください。

    The scopes checkbox with "bot" ticked.
  6. 「Bot Permissions」からBotの機能に必要な権限を選択してください。

    • Botに「管理者」権限を要求させることによる影響は認識しておきましょう。

    • Bot owners must have 2FA enabled for certain actions and permissions when added in servers that have Server-Wide 2FA enabled. Check the 2FA support page for more information.

    The permission checkboxes with some permissions checked.
  7. 結果的に生成されたURLを使ってBotをサーバーに追加することができます。URLをコピーしてブラウザに貼り付け、Botを招待したいサーバーを選択した後、「認証」をクリックしてください。

注釈

Botを追加する人には「サーバー管理」権限が必要です。

このURLを実行時に動的に生成したい場合は、 discord.Permissions インターフェイスから discord.utils.oauth_url() を使用できます。