ホーム › 使い方ガイド › Discord Bot の特権インテントとは?3つの種類・必要な場面・有効にする手順を解説
GUIDE

Discord Bot の特権インテントとは?3つの種類・必要な場面・有効にする手順を解説

Discord Bot を作っていると出てくる「特権インテント(Privileged Gateway Intents)」。メンバー一覧が取れない、コマンドに反応しない、といったトラブルの多くはこの設定が原因です。このページでは、インテントの仕組みから、3つの特権インテントの違い、有効にする手順、100サーバーを超えたときの認証まで、順番に説明します。

そもそも「インテント」とは

Discord Bot は、Discord と常につながって「メッセージが送られた」「メンバーが参加した」などのイベントを受け取って動いています。インテント(Intent)は、Bot がどの種類のイベントを受け取るかを指定する仕組みです。

必要なイベントだけを受け取るようにすることで、通信量や処理の負担を減らし、余計なデータを Bot に渡さないようにしています。

  • 通常のインテント:サーバーやチャンネルの変更、リアクションなど。コードで指定するだけで使えます。
  • 特権インテント:メンバーの情報やメッセージの本文など、個人に関わる情報を含むもの。Discord Developer Portal での許可が別に必要です。

特権インテントが必要な理由

特権インテントで受け取れる情報には、ユーザーが書いたメッセージの中身や、サーバーにいるメンバーの一覧、オンライン状態などが含まれます。どれも使い方を誤るとプライバシーに関わるため、Discord は「本当に必要な Bot だけが、開発者の同意のうえで使える」ように特別扱いしています。

そのため、特権インテントは使うと決めて自分で有効にしない限り、届きません。コードだけ書いても、Developer Portal 側で許可していなければ情報は受け取れません。

3つの特権インテントと用途

名前(Portal での表示)受け取れる情報必要になる機能の例discord.py での指定
MESSAGE CONTENTメッセージの本文・添付ファイル・埋め込み! などで始まるテキストコマンド、NG ワード検出、自動応答、メッセージログintents.message_content
SERVER MEMBERSメンバーの参加・退出・情報の更新、メンバー一覧参加時の歓迎メッセージ、ロールの自動付与、メンバー数の表示、認証パネルintents.members
PRESENCEオンライン状態、プレイ中のゲームなどのアクティビティオンライン人数の表示、「〇〇をプレイ中」に反応する機能intents.presences
スラッシュコマンド(/ から始まるコマンド)だけで動く Bot は、ほとんどの場合 Message Content は不要です。スラッシュコマンドに入力された値は、インテントがなくても受け取れます。

この症状なら、このインテントが足りていない

  • テキストコマンドに反応しない・message.content が空になる → Message Content(詳しくは「Message Content Intent の設定方法」)
  • on_member_join が呼ばれない・guild.members に自分(Bot)しかいない → Server Members
  • member.status がずっと offline になる・アクティビティが取れない → Presence

特権インテントを有効にする手順

有効にする場所は2か所あります。どちらか片方だけでは動きません。

手順1:Discord Developer Portal で許可する

  1. Discord Developer Portal を開いて、対象のアプリケーション(Bot)を選びます。
  2. 左のメニューから「Bot」を開きます。
  3. 下のほうにある「Privileged Gateway Intents」で、使うものだけをオンにします(PRESENCE INTENT / SERVER MEMBERS INTENT / MESSAGE CONTENT INTENT)。
  4. 画面下に出る「Save Changes」を押して保存します。

手順2:コードで有効にする(discord.py)

Portal で許可しただけでは、Bot はまだその情報を要求していません。コードでも、使うインテントを指定します。

import discord
from discord.ext import commands

intents = discord.Intents.default()  # 通常のインテントはこれで有効
intents.message_content = True        # メッセージの本文を読む
intents.members = True                # メンバーの参加・退出を受け取る
# intents.presences = True            # オンライン状態が必要なときだけ

bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_member_join(member):
    channel = member.guild.system_channel
    if channel:
        await channel.send(f"{member.mention} さん、ようこそ!")

bot.run(TOKEN)
コードで有効にしたのに Portal 側がオフだと、起動時に PrivilegedIntentsRequired というエラーで止まります。この場合は、手順1の設定と保存を確認してください。

手順3:Bot を再起動して確認する

設定を保存したら、Bot を再起動します。StellaHost で動かしている場合は、サーバー画面の「再起動」を押せば反映されます。起動時のログに Privileged message content intent is missing などの警告が出ていなければ成功です。

100サーバー以上の Bot は「認証」が必要

参加しているサーバーが 100 を超える Bot は、Discord による認証(Verification)を受けないと、新しいサーバーに参加できなくなります。そして特権インテントを使い続けるには、認証の申請の中で「なぜそのインテントが必要か」を説明して許可をもらう必要があります。

  • Bot が 75 サーバーほどに近づくと、Developer Portal に認証の案内が出ます。早めに準備しておくと安心です。
  • 申請では、本人確認と、各特権インテントの使い道(どの機能で、どんな情報を、どう扱うか)を説明します。
  • 「とりあえずオンにしていた」インテントは、理由を説明できないと許可されません。使っていないものは、申請前にオフにしておきましょう。
100 サーバー未満の Bot は、Developer Portal でオンにするだけで特権インテントを使えます。審査はありません。

特権インテントを使うときの注意点

  • 必要なものだけ有効にする:使わないインテントまでオンにすると、無駄なイベントを受け取って処理が重くなり、認証の審査でも不利になります。
  • 受け取った情報は大切に扱う:メッセージの本文やメンバー情報を保存する場合は、何のために使うのかを明確にし、必要以上に溜め込まないようにします。
  • Members と Presence は通信量が増える:大きなサーバーではイベントの数が多くなり、メモリの使用量も増えます。サーバーのメモリに余裕を持たせておくと安心です。
  • トークンの管理も忘れずに:特権インテントを持つ Bot のトークンが漏れると、メッセージやメンバー情報が見られてしまいます。トークンはコードに直接書かず、.env などで管理しましょう。

よくある質問

Q. 特権インテントをオンにするのにお金はかかりますか?

かかりません。Developer Portal でオンにするのも、100 サーバー以上の Bot の認証も無料です。

Q. Intents.all() を使えば全部まとめて有効にできますか?

コード上は discord.Intents.all() で全部を要求できますが、Portal 側で許可していないインテントがあると起動時にエラーになります。また、使わないインテントまで受け取ることになるので、必要なものだけを指定するのがおすすめです。

Q. スラッシュコマンドだけの Bot にも特権インテントは必要ですか?

基本的には不要です。ただし、コマンドの中でメンバー一覧を取得したり、参加・退出を検知したりする場合は Server Members が必要になります。

Q. 設定したのに反映されません。

Portal の「Save Changes」を押したか、コードで intents を Bot(または Client)に渡しているか、Bot を再起動したかを確認してください。3つのうちどれかが抜けていることがほとんどです。

まとめ

  • インテントは「Bot が受け取るイベントの種類」を決める仕組みで、個人に関わる情報を含む3つが特権インテント
  • Message Content・Server Members・Presence は、Developer Portal とコードの両方で有効にする
  • 100 サーバーを超える Bot は認証が必要で、各インテントの使い道の説明を求められる
  • 必要なものだけを有効にし、受け取った情報は大切に扱う

Discord Bot を、月 ¥180 で24時間。

支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

discord.py の始め方|Discord Bot を作ってオンラインにするまで【初心者向け】Python で Discord Bot を作る手順を、Developer Portal での Bot 作成・トークン取得・サーバーへの招待から、最初のスラッシュコマンドを動かすまで初心者向けに解説します。読む → discord.py でスラッシュコマンドを作る方法|引数・選択肢・権限までdiscord.py 2.x でスラッシュコマンドを作る方法を解説。基本の書き方から、引数・選択肢・本人だけに見える返信・管理者限定・defer・すぐに反映させる方法まで紹介します。読む → Discord Bot のトークンが漏れたときの対処法と、安全な管理方法Bot のトークンが漏れたときにすぐやること(再発行・被害確認・権限の見直し)と、.env と .gitignore を使った漏れないための管理方法を解説します。読む → Discord Bot をサーバーに招待する方法と、権限(パーミッション)の選び方OAuth2 の URL Generator で招待 URL を作る手順と、用途別のおすすめ権限、Missing Permissions・Missing Access の対処、ロールの順番の注意点を解説します。読む → Replit で動かしていた Discord Bot をサーバーに引っ越す手順Replit で動かしていた Python の Discord Bot を、keep_alive や Secrets を外して24時間動くサーバーへ引っ越す手順を、つまずきやすい点と一緒に解説します。読む → Discord Bot は VPS と Bot 用ホスティングのどっちで動かす?違いと選び方VPS と Bot 用ホスティングの違いを、必要な知識・手間・料金・自由度で比較。どんな人にどちらが向いているかの目安を紹介します。読む →