Discord Bot で参加時の歓迎メッセージ・ロール自動付与を作る方法
新しいメンバーがサーバーに参加したときに、歓迎メッセージを送ったり、ロールを自動で付けたりする機能は、多くのサーバーで使われています。このページでは、discord.py で参加・退出を検知する方法と、歓迎メッセージ・ロール付与・DM 送信の作り方、うまく動かないときの確認ポイントを説明します。
まず必要な設定:Server Members Intent
メンバーの参加・退出を受け取るには、特権インテントの Server Members Intent が必要です。これがないと、on_member_join は呼ばれません。
- Discord Developer Portal → 対象の Bot →「Bot」を開きます。
- 「SERVER MEMBERS INTENT」をオンにして「Save Changes」を押します。
- コードでも
intents.members = Trueを指定します。
特権インテントについては「特権インテントとは?」で詳しく説明しています。
歓迎メッセージを送る
import discord
from discord.ext import commands
intents = discord.Intents.default()
intents.members = True
bot = commands.Bot(command_prefix="!", intents=intents)
WELCOME_CHANNEL_ID = 123456789012345678 # 歓迎メッセージを送るチャンネルの ID
@bot.event
async def on_member_join(member: discord.Member):
channel = member.guild.get_channel(WELCOME_CHANNEL_ID)
if channel is None:
return
embed = discord.Embed(
title="ようこそ!",
description=f"{member.mention} さん、{member.guild.name} へようこそ!\nまずはルールを確認してください。",
color=0x22c55e,
)
embed.set_thumbnail(url=member.display_avatar.url)
embed.set_footer(text=f"{member.guild.member_count} 人目のメンバーです")
await channel.send(embed=embed)
チャンネル ID は、Discord の設定で「開発者モード」をオンにすると、チャンネルを右クリック →「チャンネル ID をコピー」で取得できます。
ロールを自動で付ける
AUTO_ROLE_ID = 234567890123456789 # 付けたいロールの ID
@bot.event
async def on_member_join(member: discord.Member):
role = member.guild.get_role(AUTO_ROLE_ID)
if role:
try:
await member.add_roles(role, reason="参加時の自動付与")
except discord.Forbidden:
print("ロールを付ける権限がありません")
歓迎メッセージとロール付与を両方したい場合は、1つの on_member_join の中にまとめて書きます(同じ名前の関数を2つ書くと、後の方だけが動きます)。
DM で案内を送る
try:
await member.send(f"{member.guild.name} へようこそ! #ルール チャンネルを読んでから参加してください。")
except discord.Forbidden:
pass # DM を受け取らない設定の人には送れない
DM を受け付けない設定の人もいるので、送れなかったときにエラーで止まらないようにしておきます。
退出したときに通知する
@bot.event
async def on_member_remove(member: discord.Member):
channel = member.guild.get_channel(WELCOME_CHANNEL_ID)
if channel:
await channel.send(f"{member.display_name} さんが退出しました。")
うまく動かないときの確認ポイント
on_member_join が呼ばれない
Developer Portal の Server Members Intent と、コードの intents.members = True の両方を確認します。設定後は Bot の再起動が必要です。
ロールが付かない(Missing Permissions)
- Bot に「ロールの管理」の権限があるか
- Bot のロールが、付けたいロールより上にあるか(サーバー設定 → ロールで並び替え)
Bot が止まっていると何も起きない
参加イベントは、そのとき Bot が動いていないと受け取れません。歓迎メッセージやロール付与を確実に動かすには、Bot を24時間動かしておく必要があります。StellaHost なら月額 ¥180 から、止まらないサーバーで動かせます。
まとめ
- 参加・退出の検知には Server Members Intent が必要
on_member_joinで歓迎メッセージ・ロール付与・DM をまとめて処理する- ロールが付かないときは、権限とロールの並び順を確認する
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →ほかのガイド
Discord Bot のレート制限(429 Too Many Requests)の原因と対処法Bot のログに出る 429・We are being rate limited の意味と、ループでの連続送信や短すぎる定期処理などの原因、待ち時間を入れるなどの対処法を解説します。読む →
discord.py のよくあるエラー一覧と解決方法【まとめ】LoginFailure・PrivilegedIntentsRequired・ModuleNotFoundError・Missing Permissions・インタラクションに失敗しました など、discord.py でよく出るエラーの意味と直し方を一覧にまとめました。読む →
requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法サーバーで ModuleNotFoundError が出る原因と、requirements.txt の書き方・自動で作る方法・バージョン指定・import 名とインストール名が違うライブラリの一覧を解説します。読む →
discord.py の Cog でコマンドをファイルごとに分ける方法discord.py 2.x の Cog を使って、コマンドやイベントを機能ごとのファイルに分ける方法を解説。setup・load_extension・再読み込み・よくあるエラーまで紹介します。読む →
discord.py で定期実行する方法|tasks.loop で毎日・毎時の自動投稿discord.py の tasks.loop で、一定間隔・毎日決まった時刻(日本時間)に処理を実行する方法と、開始・停止、エラー時の対処、よくある失敗を解説します。読む →
Discord Bot でデータを保存する方法|SQLite でポイント・レベル機能を作る再起動しても消えないデータを、SQLite(aiosqlite)で Discord Bot に保存する方法を解説。ポイント機能・ランキングのサンプルコードと、サーバーでの注意点を紹介します。読む →