ホーム › 使い方ガイド › Discord Bot で参加時の歓迎メッセージ・ロール自動付与を作る方法
GUIDE

Discord Bot で参加時の歓迎メッセージ・ロール自動付与を作る方法

新しいメンバーがサーバーに参加したときに、歓迎メッセージを送ったり、ロールを自動で付けたりする機能は、多くのサーバーで使われています。このページでは、discord.py で参加・退出を検知する方法と、歓迎メッセージ・ロール付与・DM 送信の作り方、うまく動かないときの確認ポイントを説明します。

まず必要な設定:Server Members Intent

メンバーの参加・退出を受け取るには、特権インテントの Server Members Intent が必要です。これがないと、on_member_join は呼ばれません。

  1. Discord Developer Portal → 対象の Bot →「Bot」を開きます。
  2. 「SERVER MEMBERS INTENT」をオンにして「Save Changes」を押します。
  3. コードでも 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 に保存する方法を解説。ポイント機能・ランキングのサンプルコードと、サーバーでの注意点を紹介します。読む →