디스코드 봇 만들기#20자동 환영 메시지·온보딩 만들기! 규칙 동의 버튼으로 자동 역할 부여 (파이썬 예제)

pip install -U discord.py python-dotenv

python -c "import discord; print(discord.__version__)"

DISCORD_TOKEN=여기에_봇_토큰_붙여넣기
GUILD_ID=테스트용_서버_ID
WELCOME_CHANNEL_ID=환영_메시지_보낼_채널_ID
GOODBYE_CHANNEL_ID=이탈_메시지_보낼_채널_ID
MEMBER_ROLE_ID=동의하면_줄_역할_ID

intents = discord.Intents.default()
intents.message_content = True
intents.members = True    # ← 오늘 실제로 쓰는 인텐트!
intents.polls = True

def build_welcome_embed(self, member: discord.Member) -> discord.Embed:
    embed = discord.Embed(
        title=f"{member.display_name}님, 환영해요! 🎉",
        description=(
            f"{member.mention} 님이 서버에 들어왔어요.\n"
            "규칙 채널에서 **동의 버튼**을 누르면 바로 활동할 수 있어요!"
        ),
        color=discord.Color.from_str("#5865F2"),
        timestamp=discord.utils.utcnow(),
    )
    embed.set_thumbnail(url=member.display_avatar.url)
    embed.add_field(
        name="계정 생성일",
        value=discord.utils.format_dt(member.created_at, "D"),
        inline=True,
    )
    embed.add_field(name="지금 멤버 수", value=f"{member.guild.member_count}명", inline=True)
    embed.set_footer(text=f"ID: {member.id}")
    return embed

@commands.Cog.listener()
async def on_member_join(self, member: discord.Member):
    if member.bot:
        return

    channel = member.guild.get_channel(WELCOME_CHANNEL_ID) or member.guild.system_channel
    if channel is None:
        print("[Onboarding] 환영 채널을 못 찾았어요!")
        return

    await channel.send(embed=self.build_welcome_embed(member))

@commands.Cog.listener()
async def on_member_remove(self, member: discord.Member):
    if member.bot:
        return

    channel = member.guild.get_channel(GOODBYE_CHANNEL_ID) or member.guild.system_channel
    if channel is None:
        return

    await channel.send(
        f"👋 **{member.display_name}** 님이 서버를 떠났어요. "
        f"(남은 인원 {member.guild.member_count}명)"
    )

class RuleAgreeView(discord.ui.View):
    """규칙 동의 버튼 패널 (영구 뷰)"""

    def __init__(self):
        super().__init__(timeout=None)          # ① 시간 제한 없음

    @discord.ui.button(
        label="규칙에 동의합니다",
        style=discord.ButtonStyle.success,
        emoji="✅",
        custom_id="onboarding:agree",           # ② 고정 ID
    )
    async def agree(self, interaction: discord.Interaction, button: discord.ui.Button):
        role = interaction.guild.get_role(MEMBER_ROLE_ID)

        if role is None:
            await interaction.response.send_message(
                "역할 설정이 잘못됐어요. 관리자에게 알려주세요 🙏", ephemeral=True
            )
            return

        if role in interaction.user.roles:
            await interaction.response.send_message("이미 동의하셨어요! 😊", ephemeral=True)
            return

        try:
            await interaction.user.add_roles(role, reason="규칙 동의 버튼 클릭")
        except discord.Forbidden:
            await interaction.response.send_message(
                "권한이 부족해서 역할을 드리지 못했어요 😢", ephemeral=True
            )
            return

        await interaction.response.send_message(
            f"환영해요! **{role.name}** 역할을 드렸어요 🎉", ephemeral=True
        )

async def cog_load(self):
    self.bot.add_view(RuleAgreeView())    # ③ 재등록
    print("[Onboarding] 규칙 동의 패널 등록 완료!")

# discord.py 2.x / Python 3.8+
# 디스코드 봇 만들기 #20 - 자동 환영 메시지·온보딩

import os

import discord
from discord import app_commands
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()

WELCOME_CHANNEL_ID = int(os.getenv("WELCOME_CHANNEL_ID", "0"))
GOODBYE_CHANNEL_ID = int(os.getenv("GOODBYE_CHANNEL_ID", "0"))
MEMBER_ROLE_ID = int(os.getenv("MEMBER_ROLE_ID", "0"))

BRAND_COLOR = discord.Color.from_str("#5865F2")

RULES_TEXT = (
    "**1.** 서로 존중해주세요. 욕설·비방은 즉시 제재돼요\n"
    "**2.** 광고·도배·스팸 링크 금지\n"
    "**3.** 채널 주제에 맞게 대화해주세요\n"
    "**4.** 디스코드 이용약관을 지켜주세요\n\n"
    "다 읽으셨다면 아래 버튼을 눌러주세요! 👇"
)

class RuleAgreeView(discord.ui.View):
    """규칙 동의 버튼 패널 (영구 뷰)"""

    def __init__(self):
        super().__init__(timeout=None)

    @discord.ui.button(
        label="규칙에 동의합니다",
        style=discord.ButtonStyle.success,
        emoji="✅",
        custom_id="onboarding:agree",
    )
    async def agree(self, interaction: discord.Interaction, button: discord.ui.Button):
        role = interaction.guild.get_role(MEMBER_ROLE_ID)

        if role is None:
            await interaction.response.send_message(
                "역할 설정이 잘못됐어요. 관리자에게 알려주세요 🙏", ephemeral=True
            )
            return

        if role in interaction.user.roles:
            await interaction.response.send_message("이미 동의하셨어요! 😊", ephemeral=True)
            return

        try:
            await interaction.user.add_roles(role, reason="규칙 동의 버튼 클릭")
        except discord.Forbidden:
            await interaction.response.send_message(
                "권한이 부족해서 역할을 드리지 못했어요 😢 (봇 역할 순서를 확인해주세요)",
                ephemeral=True,
            )
            return

        await interaction.response.send_message(
            f"환영해요! **{role.name}** 역할을 드렸어요 🎉", ephemeral=True
        )

class Onboarding(commands.Cog):
    """새 멤버 환영·자동 역할 부여"""

    def __init__(self, bot: commands.Bot):
        self.bot = bot

    async def cog_load(self):
        self.bot.add_view(RuleAgreeView())
        print("[Onboarding] 규칙 동의 패널 등록 완료!")

    def build_welcome_embed(self, member: discord.Member) -> discord.Embed:
        embed = discord.Embed(
            title=f"{member.display_name}님, 환영해요! 🎉",
            description=(
                f"{member.mention} 님이 서버에 들어왔어요.\n"
                "규칙 채널에서 **동의 버튼**을 누르면 바로 활동할 수 있어요!"
            ),
            color=BRAND_COLOR,
            timestamp=discord.utils.utcnow(),
        )
        embed.set_thumbnail(url=member.display_avatar.url)
        embed.add_field(
            name="계정 생성일",
            value=discord.utils.format_dt(member.created_at, "D"),
            inline=True,
        )
        embed.add_field(
            name="지금 멤버 수", value=f"{member.guild.member_count}명", inline=True
        )
        embed.set_footer(text=f"ID: {member.id}")
        return embed

    def pick_channel(self, guild: discord.Guild, channel_id: int):
        return guild.get_channel(channel_id) or guild.system_channel

    @commands.Cog.listener()
    async def on_member_join(self, member: discord.Member):
        if member.bot:
            return

        channel = self.pick_channel(member.guild, WELCOME_CHANNEL_ID)
        if channel is None:
            print("[Onboarding] 환영 채널을 못 찾았어요!")
            return

        await channel.send(embed=self.build_welcome_embed(member))

    @commands.Cog.listener()
    async def on_member_remove(self, member: discord.Member):
        if member.bot:
            return

        channel = self.pick_channel(member.guild, GOODBYE_CHANNEL_ID)
        if channel is None:
            return

        await channel.send(
            f"👋 **{member.display_name}** 님이 서버를 떠났어요. "
            f"(남은 인원 {member.guild.member_count}명)"
        )

    @app_commands.command(name="규칙패널", description="규칙 동의 버튼 패널을 이 채널에 설치해요")
    @app_commands.checks.has_permissions(manage_guild=True)
    async def setup_panel(self, interaction: discord.Interaction):
        embed = discord.Embed(
            title="📜 서버 규칙",
            description=RULES_TEXT,
            color=BRAND_COLOR,
        )
        await interaction.channel.send(embed=embed, view=RuleAgreeView())
        await interaction.response.send_message("규칙 패널을 설치했어요! ✅", ephemeral=True)

    @setup_panel.error
    async def setup_panel_error(self, interaction: discord.Interaction, error):
        if isinstance(error, app_commands.MissingPermissions):
            await interaction.response.send_message(
                "이 명령어는 **서버 관리** 권한이 있어야 쓸 수 있어요 🔒", ephemeral=True
            )

async def setup(bot: commands.Bot):
    await bot.add_cog(Onboarding(bot))

server-bot/
├─ .env
├─ .gitignore
├─ bot.py
└─ cogs/
   ├─ admin.py
   ├─ poll.py            # #18 투표
   └─ onboarding.py      # ← 오늘 추가!

[Onboarding] 규칙 동의 패널 등록 완료!
[Poll] 준비 완료!
✅ cogs.admin 불러옴
✅ cogs.onboarding 불러옴
✅ cogs.poll 불러옴
MojangBot#1234 로그인 성공! (Cog 3개)

환영해요! 멤버 역할을 드렸어요 🎉