ساخت ربات Discord با پایتون برای مدیریت گروه‌ها و اطلاع‌رسانی خودکار 🤖💬

Discord دیگر فقط یک پلتفرم برای گیمرها نیست؛ این یک ابزار ارتباطی قدرتمند برای جوامع آنلاین، تیم‌های کاری، کلاس‌های آموزشی و گروه‌های علاقه‌مند است. اما با رشد یک سرور دیسکورد، مدیریت آن به شدت چالش‌برانگیز می‌شود. پاسخ به سوالات تکراری، خوشامدگویی به اعضای جدید، مدیریت نقش‌ها (Roles) و ارسال اطلاعیه‌های منظم، همگی کارهایی هستند که می‌توانند به راحتی توسط یک ربات (Bot) انجام شوند. خوشبختانه، با قدرت و سادگی زبان پایتون (Python)، شما می‌توانید ربات‌های سفارشی خود را بسازید که دقیقاً مطابق نیازهای جامعه شما عمل کنند.

چرا پایتون و `discord.py`؟ 🤔

در حالی که زبان‌های مختلفی می‌توانند با API دیسکورد ارتباط برقرار کنند، پایتون به لطف کتابخانه فوق‌العاده `discord.py` (و فورک‌های محبوب آن مانند `py-cord` یا `nextcord`)، به انتخاب اول بسیاری از توسعه‌دهندگان تبدیل شده است.

• سادگی پایتون: سینتکس خوانا و ساده پایتون به شما اجازه می‌دهد تا بر منطق ربات تمرکز کنید، نه بر پیچیدگی‌های زبان.
• برنامه‌نویسی ناهمزمان (Asynchronous):** کتابخانه `discord.py` بر پایه `asyncio` پایتون ساخته شده است. این یعنی ربات شما می‌تواند هزاران رویداد (مانند پیام‌های همزمان کاربران) را بدون مسدود شدن (Block) مدیریت کند.
• جامعه بزرگ: مستندات فراوان، آموزش‌های متعدد و جامعه پشتیبانی قوی، یادگیری و رفع اشکال را بسیار آسان می‌کند.
• اکوسیستم قدرتمند: شما به راحتی می‌توانید ربات دیسکورد خود را به سایر ابزارهای پایتون (مانند وب‌اسکرپینگ، تحلیل داده یا حتی هوش مصنوعی) متصل کنید.

گام‌های اولیه: راه‌اندازی ربات (قبل از کدنویسی) 🛠️

قبل از نوشتن اولین خط کد پایتون، باید هویت ربات خود را در دیسکورد ایجاد کنید.

1. نصب کتابخانه: ابتدا کتابخانه را نصب کنید (معمولاً `pip install py-cord` یا `pip install nextcord` توصیه می‌شود که فورک‌های فعال `discord.py` هستند).

   pip install py-cord

2. پورتال توسعه‌دهندگان دیسکورد: به Discord Developer Portal بروید و وارد حساب کاربری خود شوید.
3. ساخت اپلیکیشن: یک “New Application” بسازید و نامی برای آن انتخاب کنید.
4. ساخت ربات: از منوی کناری به تب “Bot” بروید و روی “Add Bot” کلیک کنید.
5. دریافت توکن (Token):** در همین صفحه، روی “Reset Token” کلیک کنید. یک رشته طولانی به شما نمایش داده می‌شود. این رشته، رمز عبور ربات شماست. (هشدار: هرگز این توکن را با هیچکس به اشتراک نگذارید!)
6. فعال‌سازی Intents (بسیار مهم):** در همان صفحه Bot، گزینه‌های “Privileged Gateway Intents” را پیدا کنید. حداقل گزینه‌های `PRESENCE INTENT`، `SERVER MEMBERS INTENT` و `MESSAGE CONTENT INTENT` را فعال (روشن) کنید. بدون این گزینه‌ها، ربات شما به بسیاری از رویدادها (مانند ورود کاربر یا خواندن پیام‌ها) دسترسی نخواهد داشت.
7. دعوت ربات به سرور: به تب “OAuth2” بروید، “URL Generator” را انتخاب کنید. در بخش “Scopes”، تیک `bot` و `applications.commands` را بزنید. سپس در بخش “Bot Permissions”، دسترسی‌های مورد نیاز (مانند `Send Messages`, `Read Messages`, `Manage Roles`) را انتخاب کنید. لینک ساخته شده را کپی و در مرورگر خود باز کنید تا ربات را به سرور تستی خود اضافه نمایید.

کدنویسی: مدیریت گروه و اطلاع‌رسانی خودکار 🚀

حالا که ربات آماده است، بیایید دو سناریوی اصلی عنوان مقاله را پیاده‌سازی کنیم:

import discord
from discord.ext import commands

# فعال کردن Intents
intents = discord.Intents.default()
intents.members = True # <-- فعال کردن intent مربوط به اعضا
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)

# رویداد: زمانی که ربات آماده به کار می‌شود
@bot.event
async def on_ready():
    print(f'ربات با نام {bot.user} با موفقیت وارد شد!')
    print('------')

# رویداد: اطلاع‌رسانی خودکار هنگام ورود عضو جدید
@bot.event
async def on_member_join(member):
    # ID کانالی که می‌خواهید پیام خوشامدگویی در آن ارسال شود
    welcome_channel_id = 123456789012345678 
    channel = bot.get_channel(welcome_channel_id)
    
    if channel:
        # ساخت یک پیام زیبا با Embed
        embed = discord.Embed(
            title="کاربر جدید وارد شد!",
            description=f"سلام {member.mention}، به سرور ما خوش آمدی!",
            color=discord.Color.green()
        )
        embed.set_thumbnail(url=member.avatar.url)
        embed.set_footer(text=f"ID کاربر: {member.id}")
        
        await channel.send(embed=embed)
        
        # همچنین می‌توانید یک نقش (Role) پیش‌فرض به کاربر بدهید
        try:
            role = discord.utils.get(member.guild.roles, name="Member")
            if role:
                await member.add_roles(role)
        except Exception as e:
            print(f"خطا در افزودن نقش: {e}")

# توکن ربات خود را (که کپی کردید) در اینجا قرار دهید
# هشدار امنیتی: هرگز این توکن را در کد عمومی به اشتراک نگذارید!
BOT_TOKEN = "YOUR_SECRET_BOT_TOKEN_GOES_HERE" 
bot.run(BOT_TOKEN)
        

# (ادامه کد قبلی، این بخش را قبل از bot.run اضافه کنید)

# دستور: سلام کردن (برای تست)
@bot.command()
async def hello(ctx):
    await ctx.send(f"سلام {ctx.author.mention}!")

# دستور: مدیریت گروه (Kick کردن کاربر)
@bot.command()
@commands.has_permissions(kick_members=True) # <-- مدیریت نقش‌ها: فقط ادمین‌ها
async def kick(ctx, member: discord.Member, *, reason: str = "دلیلی ذکر نشده"):
    """
    یک کاربر را از سرور اخراج می‌کند.
    مثال استفاده: !kick @Username اسپم کردن
    """
    try:
        await member.kick(reason=reason)
        await ctx.send(f"کاربر {member.mention} با موفقیت اخراج شد. دلیل: {reason}")
    except discord.Forbidden:
        await ctx.send("خطا: ربات دسترسی لازم برای اخراج این کاربر را ندارد.")
    except Exception as e:
        await ctx.send(f"خطای ناشناخته: {e}")

# مدیریت خطای دسترسی برای دستور Kick
@kick.error
async def kick_error(ctx, error):
    if isinstance(error, commands.MissingPermissions):
        await ctx.send("شما دسترسی لازم برای استفاده از این دستور را ندارید.")
    elif isinstance(error, commands.MissingRequiredArgument):
        await ctx.send("لطفاً کاربری که می‌خواهید اخراج کنید را منشن کنید.")

# (بخش bot.run در انتهای کد باقی می‌ماند)
        

گام‌های بعدی: حرفه‌ای شدن 🚀

• Cogs:** وقتی ربات شما بزرگ می‌شود، تمام دستورات را در یک فایل نریزید. از `Cogs` برای دسته‌بندی و سازماندهی دستورات خود در فایل‌های پایتون مجزا استفاده کنید (مثلاً `management.py`, `fun.py`, `notifications.py`).
• Tasks Loop:** از `tasks.loop` برای ایجاد کارهای زمان‌بندی شده استفاده کنید. مثلاً رباتی که هر صبح ساعت ۹ یک پیام "صبح بخیر" یا آمار روزانه ارسال کند.
• امنیت توکن: هرگز توکن خود را مستقیماً در کد ننویسید. از فایل `.env` (با کتابخانه `python-dotenv`) یا متغیرهای محیطی سرور (Environment Variables) برای نگهداری آن استفاده کنید.

جمع‌بندی ✅

پایتون و کتابخانه `discord.py` ابزاری فوق‌العاده برای اتوماسیون و هوشمندسازی جوامع آنلاین هستند. ساخت رباتی که به کاربران جدید خوشامد بگوید یا به مدیران در مدیریت گروه کمک کند، یک پروژه عملی عالی برای تقویت مهارت‌های پایتون، به خصوص در زمینه برنامه‌نویسی ناهمزمان (Asyncio) و کار با APIها است. این مهارت‌ها نه تنها جذاب هستند، بلکه در دوره‌های پیشرفته آموزش پایتون در آموزشگاه البرز به صورت کامل پوشش داده می‌شوند.