Discord Bot がメッセージを読めない?Message Content Intent の設定方法
「!help のようなコマンドに反応しない」「message.content が空っぽになる」――この症状のほとんどは、Message Content Intent が有効になっていないことが原因です。設定は2か所(Discord Developer Portal とコード)で必要です。
Message Content Intent とは
Discord では、Bot がメッセージの「本文」を読むには、特別な許可(Privileged Intent)が必要です。これが Message Content Intent です。許可がないと、Bot はメッセージが送られたことは分かっても、中身(message.content)は空の文字列として受け取ります。
次のような Bot で必要になります。
!や?などのプレフィックスで動くコマンド(commands.Botのテキストコマンド)- メッセージの内容に反応する自動応答・NG ワード検出
- メッセージの内容を記録するログ機能
スラッシュコマンド(
/ から始まるコマンド)だけで動く Bot には、この設定は必要ありません。症状:こんなときはこれが原因
- 起動時のログに
Privileged message content intent is missing, commands may not work as expected.と出る - テキストコマンドに反応しない
print(message.content)が空になる- 起動時に
PrivilegedIntentsRequiredというエラーで止まる(コードでは有効にしたのに、Portal 側が無効のとき)
手順1:Discord Developer Portal で有効にする
- Discord Developer Portal を開き、対象の Bot(アプリケーション)を選びます。
- 左のメニューから「Bot」を開きます。
- 「Privileged Gateway Intents」の中にある MESSAGE CONTENT INTENT をオンにします。
- 画面下の「Save Changes」を押して保存します。
参加しているサーバーが多い(100 以上)Bot は、この Intent を使うのに Discord の審査(認証)が必要です。小規模な Bot ならオンにするだけで使えます。
手順2:コードで有効にする(discord.py)
Portal でオンにしただけでは足りません。コード側でも message_content を有効にします。
import discord
from discord.ext import commands
intents = discord.Intents.default()
intents.message_content = True # ← これを追加
bot = commands.Bot(command_prefix="!", intents=intents)
@bot.command()
async def ping(ctx):
await ctx.send("pong!")
bot.run(TOKEN)
discord.Client を使っている場合も同じく、intents.message_content = True を指定した intents を渡します。
手順3:Bot を再起動して確認する
設定を保存したら、Bot を再起動します。StellaHost で動かしている場合は、サーバー画面の「再起動」を押してください。起動時のログから Privileged message content intent is missing の警告が消えていれば成功です。
ほかの Privileged Intent
同じ画面には、ほかにも次の2つがあります。必要なときだけオンにしてください。
- SERVER MEMBERS INTENT:メンバーの参加・退出の検知、メンバー一覧の取得に必要(
intents.members = True) - PRESENCE INTENT:メンバーのオンライン状態やアクティビティの取得に必要(
intents.presences = True)
まとめ
- メッセージの中身を読む Bot には、Message Content Intent が必要
- Discord Developer Portal と、コードの
intents.message_content = Trueの両方で有効にする - 設定後は Bot を再起動して、ログの警告が消えたか確認する
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →ほかのガイド
Discord Bot を24時間動かす方法|PCを閉じても止まらないPC を閉じると止まってしまう Discord Bot を、24時間動かし続ける方法を解説。自分の PC・無料ホスティング・Bot 用サーバーの違いと、月額 ¥180 から始められる手順を紹介します。読む →
Python で作った Discord Bot をサーバーで動かす手順discord.py などで作った Bot を、main.py と requirements.txt を置くだけでサーバーで動かす手順を解説。トークンの安全な置き方や、よくあるエラーの対処も紹介します。読む →
Discord Bot が勝手に止まる・落ちる原因と対処法Discord Bot がいつの間にかオフラインになる原因を、PC・回線・プログラムのエラー・メモリ不足・レート制限・トークンの順に解説。ログの見方と、止まりにくくする対策を紹介します。読む →
無料の Discord Bot ホスティングと有料の違い|どっちを選ぶ?無料ホスティングによくある制限(スリープ・稼働時間の上限・リソース不足)と、有料ホスティングとの違いを比較。用途別にどちらを選べばよいかの目安を紹介します。読む →
Discord Bot の特権インテントとは?3つの種類・必要な場面・有効にする手順を解説特権インテント(Privileged Gateway Intents)の仕組みと、Message Content・Server Members・Presence の違い、Developer Portal とコードでの有効化、100サーバー以上の認証まで解説します。読む →
discord.py の始め方|Discord Bot を作ってオンラインにするまで【初心者向け】Python で Discord Bot を作る手順を、Developer Portal での Bot 作成・トークン取得・サーバーへの招待から、最初のスラッシュコマンドを動かすまで初心者向けに解説します。読む →