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 Membersmember.statusがずっと offline になる・アクティビティが取れない → Presence
特権インテントを有効にする手順
有効にする場所は2か所あります。どちらか片方だけでは動きません。
手順1:Discord Developer Portal で許可する
- Discord Developer Portal を開いて、対象のアプリケーション(Bot)を選びます。
- 左のメニューから「Bot」を開きます。
- 下のほうにある「Privileged Gateway Intents」で、使うものだけをオンにします(PRESENCE INTENT / SERVER MEMBERS INTENT / MESSAGE CONTENT INTENT)。
- 画面下に出る「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)
PrivilegedIntentsRequired というエラーで止まります。この場合は、手順1の設定と保存を確認してください。手順3:Bot を再起動して確認する
設定を保存したら、Bot を再起動します。StellaHost で動かしている場合は、サーバー画面の「再起動」を押せば反映されます。起動時のログに Privileged message content intent is missing などの警告が出ていなければ成功です。
100サーバー以上の Bot は「認証」が必要
参加しているサーバーが 100 を超える Bot は、Discord による認証(Verification)を受けないと、新しいサーバーに参加できなくなります。そして特権インテントを使い続けるには、認証の申請の中で「なぜそのインテントが必要か」を説明して許可をもらう必要があります。
- Bot が 75 サーバーほどに近づくと、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分で、日本のサーバーが自動で用意されます。 プランを見る →