ホーム › 使い方ガイド › Discord Bot がメッセージを読めない?Message Content Intent の設定方法
GUIDE

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 で有効にする

  1. Discord Developer Portal を開き、対象の Bot(アプリケーション)を選びます。
  2. 左のメニューから「Bot」を開きます。
  3. 「Privileged Gateway Intents」の中にある MESSAGE CONTENT INTENT をオンにします。
  4. 画面下の「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 作成・トークン取得・サーバーへの招待から、最初のスラッシュコマンドを動かすまで初心者向けに解説します。読む →