آیا می‌توان با BotFather یک ربات ساده برای گروه تلگرام ساخت؟
مقدمه: BotFather چیست و چه قابلیت‌هایی دارد؟
بسیاری از کاربران تلگرام که به دنبال ساخت یک ربات ساده برای گروه خود هستند، ابتدا با BotFather آشنا می‌شوند. این ربات رسمی تلگرام، فرآیند ایجاد و مدیریت ربات‌های شخص ثالث را انجام می‌دهد. با کمک آن می‌توانید ربات جدیدی بسازید، نام و عکس آن را تنظیم کنید، دستورات پیش‌فرض را تعریف کنید و حتی سطح دسترسی ربات را در گروه‌ها مشخص کنید. اما سؤال کلیدی اینجاست: آیا BotFather به تنهایی برای ساخت یک ربات کاملاً کاربردی کافی است؟ پاسخ کوتاه: خیر. BotFather تنها ابزار ثبت و پیکربندی اولیه است؛ برای پاسخ به پیام‌ها، مدیریت اعضا یا اجرای دستورات سفارشی باید ربات خود را با Telegram Bot API و یک زبان برنامه‌نویسی کدنویسی کنید. در این مقاله گام به گام یاد می‌گیرید که چگونه با BotFather ربات خود را ساخته، تنظیمات اولیه را انجام دهید و سپس با حداقل کدنویسی آن را برای گروه خود کاربردی کنید.
مراحل ایجاد ربات با BotFather
۱. شروع کار با دستور /newbot
برای شروع، حساب @BotFather را در تلگرام باز کنید و دستور /newbot را ارسال کنید. BotFather از شما می‌خواهد نامی برای ربات انتخاب کنید – این نام در چت نمایش داده می‌شود. سپس یک نام کاربری (username) برای ربات وارد کنید که باید به bot ختم شود (مثلاً MySampleGroupBot). اگر نام کاربری تکراری نباشد، BotFather یک توکن API به شما می‌دهد. این توکن کلید اصلی ارتباط با ربات شماست و باید آن را محرمانه نگه دارید.
⚠️ نکته امنیتی
توکن ربات را با هیچ کس به اشتراک نگذارید. اگر به اشتباه فاش شد، بلافاصله با دستور /revoke در BotFather توکن را باطل کرده و توکن جدید صادر کنید.
۲. تنظیمات اولیه ربات
پس از دریافت توکن می‌توانید از BotFather برای تنظیم موارد زیر استفاده کنید. این تنظیمات ظاهر و رفتار اولیه ربات را مشخص می‌کنند؛ برای مثال، توضیحات و عکس در نمای عمومی ربات نمایش داده می‌شود:
- تنظیم توضیحات و درباره – با دستور
/setdescriptionو/setabouttextمتنی تعریف کنید که هنگام شروع ربات نمایش داده شود. - تنظیم عکس ربات – با
/setuserpicیک تصویر برای آواتار ربات انتخاب کنید. - تنظیم دستورات – با
/setcommandsلیست دستوراتی که ربات می‌پذیرد را تعریف کنید (در بخش بعد توضیح داده می‌شود).
تنظیمات پیشرفته ربات در BotFather
تنظیم دستورات با /setcommands
تعریف دستورات پیشنهادی با /setcommands یکی از قابلیت‌های مفید BotFather است که به کاربران کمک می‌کند تا به راحتی با ربات تعامل کنند. با ارسال این دستور و انتخاب ربات خود، می‌توانید لیستی از دستورات به همراه توضیح کوتاه بفرستید. هر دستور در یک خط با ساختار command - description نوشته می‌شود. به عنوان مثال:
start - شروع کار با ربات help - راهنما rules - قوانین گروه report - گزارش تخلف
این دستورات در منوی ربات داخل گروه نمایش داده می‌شود و کاربران می‌توانند با کلیک روی آن‌ها دستور را ارسال کنند. توجه کنید که این فقط یک تعریف اولیه است و برای پردازش واقعی دستورات باید در کد ربات خود آن‌ها را پیاده‌سازی کنید.
تنظیم حریم خصوصی با /setprivacy
دستور /setprivacy تعیین می‌کند که ربات شما فقط پیام‌هایی را که مستقیماً خطاب به آن هستند دریافت کند یا همه پیام‌های گروه را ببیند. سه حالت وجود دارد:
- Enabled (فعال) – ربات فقط پیام‌هایی را که با دستور شروع می‌شوند یا شامل منشن آن است دریافت می‌کند. مناسب برای ربات‌هایی که نیازی به دیدن تمام مکالمات ندارند.
- Disabled (غیرفعال) – ربات تمام پیام‌های گروه را دریافت می‌کند. برای ربات‌های مدیریتی یا تحلیل محتوا ضروری است.
💡 پیشنهاد
اگر ربات شما فقط به دستورات خاصی پاسخ می‌دهد، حالت Enabled را انتخاب کنید تا حریم خصوصی گروه حفظ شود. اگر ربات نیاز به اسکن خودکار پیام‌ها دارد (مثلاً فیلتر کلمات)، حالت Disabled را انتخاب کنید.
افزودن ربات به گروه
پس از ساخت ربات، باید آن را به گروه خود اضافه کنید. برای این کار از روش‌های زیر استفاده کنید:
- در گروه، روی نام گروه کلیک کرده و افزودن عضو را انتخاب کنید. نام کاربری ربات را جستجو کرده و اضافه کنید.
- ربات را به عنوان ادمین منصوب کنید (در صورت نیاز). برای این کار به تنظیمات گروه → ادمین‌ها رفته و ربات را ادمین کنید. برخی قابلیت‌ها مانند حذف پیام یا بن کردن اعضا نیاز به دسترسی ادمین دارند.
- دسترسی‌های لازم شامل حذف پیام‌ها، بن کردن کاربران و پین کردن پیام را متناسب با عملکرد ربات تنظیم کنید.
محدودیت‌های BotFather: چه کارهایی را نمی‌توان انجام داد؟
بسیاری از تازه‌کارها فکر می‌کنند BotFather یک ویرایشگر بصری است و می‌توانند رباتی با منطق پیچیده بدون کدنویسی بسازند، اما واقعیت این است که BotFather فقط یک رابط مدیریتی است و قابلیت‌های زیر را ندارد:
- ارسال خودکار پیام به گروه (مثلاً خوش‌آمدگویی به اعضای جدید).
- پردازش دستورات سفارشی (مثلاً /poll یا /warn).
- تعامل با پایگاه داده یا ذخیره اطلاعات کاربران.
- مدیریت پیشرفته گروه مانند حذف خودکار اسپم یا فیلتر محتوا.
- ارسال پیام‌های زمان‌بندی شده.
بنابراین برای ساخت یک ربات ساده اما کاربردی، نیاز به برنامه‌نویسی دارید. خوشبختانه با استفاده از کتابخانه‌های ساده مانند python-telegram-bot یا node-telegram-bot-api می‌توانید در کمتر از ۵۰ خط کد یک ربات پایه‌ای بسازید.
برنامه‌نویسی ربات برای پاسخ به پیام‌های گروه
انتخاب زبان و کتابخانه
محبوب‌ترین زبان‌ها برای توسعه ربات تلگرام پایتون و جاوااسکریپت (Node.js) هستند. برای پایتون، کتابخانه python-telegram-bot (آخرین نسخه تا زمان نگارش این مقاله) یکی از پایدارترین گزینه‌هاست. برای نصب آن از دستور pip install python-telegram-bot استفاده کنید. برای Node.js نیز کتابخانه node-telegram-bot-api رایج است.
ساختار ابتدایی ربات (نمونه کد)
در اینجا یک نمونه کد ساده به زبان پایتون ارائه می‌دهیم که با استفاده از python-telegram-bot نوشته شده است. این ربات به دستور /start پاسخ می‌دهد و یک پیام خوش‌آمدگویی ارسال می‌کند.
import logging
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes
# توکن خود را اینجا قرار دهید
TOKEN = "1234567890:ABCdefghIJKlmnoPQRstuVWXyz123456789"
logging.basicConfig(level=logging.INFO)
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text("سلام! من یک ربات ساده برای گروه شما هستم.")
def main():
app = Application.builder().token(TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.run_polling()
if __name__ == "__main__":
main()این کد پایه‌ای پس از اجرا، ربات را به سرور تلگرام متصل کرده و منتظر دریافت پیام می‌ماند. می‌توانید با افزودن CommandHandler برای دستورات دیگر مانند /help ربات را گسترش دهید.
⚠️ هشدار
هرگز توکن ربات را در کدهای اشتراکی (مثل گیت‌هاب) قرار ندهید. از متغیرهای محیطی یا فایل‌های پیکربندی استفاده کنید.
مدیریت دستورات سفارشی
برای افزودن دستورات بیشتر، کافی است توابع جدیدی مانند help_command تعریف کنید و آن‌ها را به برنامه اضافه کنید. همچنین می‌توانید از MessageHandler برای پاسخ به پیام‌های معمولی استفاده کنید. مثلاً رباتی که به کلمه کلیدی "سلام" پاسخ دهد:
from telegram.ext import MessageHandler, filters
async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message.text == "سلام":
await update.message.reply_text("سلام! چطور می‌توانم کمک کنم؟")
def main():
# ...
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))سناریوهای کاربردی برای ربات گروه
ربات خوش‌آمدگویی به اعضای جدید
یکی از رایج‌ترین نیازها، ارسال پیام خوش‌آمدگویی به اعضای جدید گروه است. برای این کار از ChatMemberHandler استفاده کنید. نمونه کد:
from telegram.ext import ChatMemberHandler
async def welcome(update: Update, context: ContextTypes.DEFAULT_TYPE):
for member in update.chat_member.new_chat_members:
await update.effective_chat.send_message(
f"خوش آمدید {member.full_name} به گروه!"
)
app.add_handler(ChatMemberHandler(welcome, ChatMemberHandler.CHAT_MEMBER))ربات نظرسنجی سریع
ربات نظرسنجی می‌تواند با دستور /poll یک نظرسنجی ساده ایجاد کند. تلگرام خود قابلیت نظرسنجی دارد، اما ربات شما می‌تواند گزینه‌های بیشتری ارائه دهد و نتایج را ذخیره کند. برای ارسال نظرسنجی از متد send_poll استفاده کنید.
عیب‌یابی رایج
در جدول زیر رایج‌ترین مشکلات و راه‌حل‌های آن‌ها فهرست شده است:
| نشانه | علت احتمالی | راه‌حل |
|---|---|---|
| ربات در گروه هیچ پاسخی نمی‌دهد | ربات ادمین نیست یا دسترسی لازم ندارد | ربات را ادمین کنید و اجازه «ارسال پیام» را فعال کنید. |
| دستورات در منوی ربات ظاهر نمی‌شوند | دستورات در BotFather تنظیم نشده‌اند | دستور /setcommands را اجرا کنید. |
| ربات پیام‌های عادی را نمی‌بیند | حالت حریم خصوصی فعال است | با /setprivacy حالت را به Disabled تغییر دهید. |
| توکن نامعتبر است | توکن عوض شده یا اشتباه وارد شده | از BotFather توکن جدید بگیرید. |
بهترین روش‌ها (Best Practices)
رعایت این نکات به پایداری و امنیت ربات شما کمک می‌کند:
- حداقل دسترسی‌ها: فقط دسترسی‌هایی را به ربات بدهید که واقعاً نیاز دارد. مثلاً اگر ربات فقط پیام خوش‌آمدگویی می‌فرستد، نیازی به دسترسی بن کردن ندارد.
- ثبت خطاها (Logging): از کتابخانه logging برای ثبت خطاهای ربات استفاده کنید تا در صورت بروز مشکل، بتوانید علت را پیدا کنید.
- استفاده از Webhook: در سرورهای تولیدی به جای Polling از Webhook استفاده کنید تا سرعت پاسخ‌دهی افزایش یابد.
- محدود کردن نرخ (Rate Limiting): تلگرام محدودیت تعداد پیام در ثانیه دارد؛ بنابراین درخواست‌های ربات را کنترل کنید.
- مستندسازی دستورات: با استفاده از
/setcommandsلیست واضحی از دستورات به کاربران ارائه دهید.
چک‌لیست سناریوهای قابل اعمال و غیرقابل اعمال
| سناریو | کفایت BotFather | راهکار |
|---|---|---|
| رباتی که فقط یک دستور ساده دارد (مثلاً /start) | خیر | کدنویسی حداقل ۵ خط |
| ربات خوش‌آمدگویی خودکار | خیر | کدنویسی با ChatMemberHandler |
| ربات فیلتر کلمات نامناسب | خیر | کدنویسی با MessageHandler |
| ربات نظرسنجی با گزینه‌های دلخواه | خیر | کدنویسی با send_poll |
| تغییر نام یا عکس ربات | بله | دستورات BotFather |
پرسش‌های متداول
سوالات رایج کاربران
آیا می‌توان بدون برنامه‌نویسی یک ربات گروه ساخت؟
خیر. BotFather فقط ربات را ثبت می‌کند و تنظیمات اولیه را انجام می‌دهد. برای اینکه ربات در گروه فعالیت کند (مثلاً به پیام‌ها پاسخ دهد) باید با استفاده از Telegram Bot API کدنویسی کنید. ربات‌های آماده (third-party) وجود دارند اما نمی‌توان آن‌ها را با BotFather ساخت.
چگونه ربات خود را به گروه اضافه کنم؟
می‌توانید از طریق بخش «افزودن عضو» در تنظیمات گروه، نام کاربری ربات را جستجو کرده و اضافه کنید. همچنین ربات را به عنوان ادمین منصوب کنید تا دسترسی‌های لازم را داشته باشد.
آیا می‌توانم رباتی بسازم که پیام‌های همه اعضا را ببیند؟
بله. با دستور /setprivacy در BotFather می‌توانید حالت privacy را روی Disabled قرار دهید تا ربات تمام پیام‌های گروه را دریافت کند. توجه کنید که برای این کار ربات باید ادمین باشد.
آیا توکن ربات را می‌توانم بعداً تغییر دهم؟
بله. در BotFather با ارسال /mybots ربات خود را انتخاب کنید و از گزینه Revoke Token استفاده کنید. سپس توکن جدیدی دریافت خواهید کرد.
حداقل دانش برنامه‌نویسی برای ساخت ربات چقدر است؟
برای یک ربات ساده کافیست با مفاهیم پایه پایتون (متغیرها، توابع، async) آشنا باشید. نمونه کدهایی که در این مقاله ارائه شد با کمی تغییر قابل استفاده هستند. منابع آموزشی رایگان زیادی نیز در دسترس است.
نتیجه‌گیری
در این مقاله یاد گرفتید که BotFather ابزاری ضروری برای ثبت و پیکربندی اولیه ربات تلگرام است، اما برای ساخت یک ربات ساده برای گروه نیاز به برنامه‌نویسی با Telegram Bot API دارید. با BotFather می‌توانید نام، دستورات و حریم خصوصی ربات را تنظیم کنید، اما منطق اصلی پاسخ‌دهی در کد شما پیاده‌سازی می‌شود. با استفاده از کتابخانه‌هایی مانند python-telegram-bot می‌توانید رباتی بسازید که به دستورات پاسخ دهد، به اعضای جدید خوش‌آمد بگوید و محتوا را فیلتر کند. توصیه می‌کنم ابتدا یک ربات ساده با یک دستور شروع کنید و به تدریج قابلیت‌های بیشتری اضافه کنید. برای یادگیری بیشتر، به مستندات رسمی Telegram Bot API مراجعه نمایید.