گرفتن توکن ربات تلگرام از BotFather: راهنمای مرجع و گام‌به‌گام ۲۰۲۶

برای ساختن هر ربات تلگرام، اولین و مهم‌ترین قدم گرفتن «توکن» است. توکن یک رشته‌ی منحصربه‌فرد است که مثل کلید و رمز ربات شما عمل می‌کند و به برنامه یا پلتفرم ربات‌ساز اجازه می‌دهد به ربات شما متصل شود و به‌جای آن پیام بفرستد و دریافت کند. بدون توکن، هیچ رباتی کار نمی‌کند. در این آموزش جامع و گام‌به‌گام، یاد می‌گیرید چطور توکن ربات تلگرام را از BotFather بگیرید، نام و عکس ربات را تنظیم کنید، اگر توکن را گم کردید چطور دوباره پیدایش کنید، و مهم‌تر از همه، چطور از توکن خود در برابر سوءاستفاده محافظت کنید.

BotFather چیست و چرا به آن نیاز داریم؟

BotFather (که گاهی «بات فادر» هم نوشته می‌شود) اکانت رسمی خود شرکت تلگرام برای ساخت و مدیریت ربات‌هاست. به عبارت دیگر، BotFather «ربات سازنده‌ی ربات‌ها» است و همه‌ی ربات‌های تلگرام در دنیا از همین‌جا ساخته می‌شوند. این اکانت با تیک آبی تأیید و آدرس BotFather قابل شناسایی است. مراقب اکانت‌های جعلی با نام مشابه باشید؛ فقط اکانت دارای تیک آبی رسمی است. با BotFather می‌توانید ربات بسازید، نام و توضیحات آن را تغییر دهید، عکس پروفایل بگذارید، دستورات ربات را تعریف کنید و در صورت لو رفتن توکن، توکن جدید بگیرید.

چرا توکن ربات لازم است؟

شاید بپرسید چرا اصلاً به توکن نیاز داریم؟ توکن در واقع «مجوز دسترسی» به ربات شماست. تلگرام به‌خاطر امنیت اجازه نمی‌دهد هر برنامه‌ای به‌دلخواه ربات‌ها را کنترل کند؛ فقط برنامه‌ای که توکن صحیح را دارد می‌تواند به‌جای ربات پیام بفرستد و دریافت کند. به همین دلیل توکن دقیقاً مثل رمز عبور حساب بانکی است: هر کسی آن را داشته باشد، کنترل کامل ربات را در دست دارد — می‌تواند پیام‌های ربات را بخواند، به‌جای شما پیام بفرستد، وبهوک ربات را عوض کند و حتی ربات را حذف کند. وقتی توکن را به یک ربات‌ساز مثل بات‌ساز می‌دهید، آن پلتفرم با استفاده از همین توکن به ربات شما وصل می‌شود و کارهایی مثل نمایش محصول، ثبت سفارش و پاسخ خودکار را برایتان انجام می‌دهد — همه بدون اینکه شما حتی یک خط کد بنویسید.

• اتصال ربات به پلتفرم ربات‌ساز یا کد شما
• ارسال و دریافت پیام به‌جای ربات
• نمایش محصولات، گرفتن سفارش و پاسخ خودکار
• تنظیم وبهوک برای اتصال آنی به سرور
• کنترل کامل ربات از یک پنل مرکزی

آموزش گام‌به‌گام گرفتن توکن ربات تلگرام

گرفتن توکن از BotFather بسیار ساده است و کمتر از دو دقیقه طول می‌کشد. کافی است مراحل زیر را به‌ترتیب انجام دهید. این مراحل در همه‌ی نسخه‌های تلگرام (موبایل اندروید و آیفون و نسخه‌ی دسکتاپ) دقیقاً یکسان است، پس با هر دستگاهی می‌توانید ربات بسازید.

1. ۱در تلگرام عبارت BotFather را جستجو و وارد چت آن شوید (اکانت با تیک آبی)
2. ۲روی دکمه‌ی Start بزنید یا دستور start/ را بفرستید
3. ۳دستور newbot/ را تایپ و ارسال کنید
4. ۴یک نام نمایشی برای ربات انتخاب کنید (مثلاً: فروشگاه گل نرگس)
5. ۵یک آیدی یکتا که حتماً به کلمه‌ی bot ختم شود انتخاب کنید (مثلاً narges_shop_bot)
6. ۶BotFather یک پیام تبریک به‌همراه توکن به شما می‌دهد
7. ۷توکن را کپی و در جای امن نگه دارید

بیایید چند مرحله‌ی کلیدی را دقیق‌تر بررسی کنیم. در مرحله‌ی «انتخاب نام»، نام نمایشی همان چیزی است که کاربر در بالای چت می‌بیند؛ می‌تواند فارسی و شامل فاصله باشد، مثل «فروشگاه گل نرگس». اما در مرحله‌ی «انتخاب یوزرنیم»، آیدی ربات باید در کل تلگرام یکتا باشد، فقط شامل حروف انگلیسی، عدد و آندرلاین، و حتماً به کلمه‌ی bot ختم شود (مثل narges_shop_bot). اگر آیدی موردنظرتان قبلاً گرفته شده باشد، BotFather خطا می‌دهد و باید آیدی دیگری انتخاب کنید؛ معمولاً اضافه‌کردن یک کلمه یا عدد مشکل را حل می‌کند. در مرحله‌ی آخر، توکن به‌شکل یک رشته‌ی طولانی شبیه 123456789:ABCdef... به شما داده می‌شود؛ بخش اول عدد شناسه‌ی ربات و بخش دوم بعد از دونقطه، کلید واقعی دسترسی است.

تست توکن: مطمئن شوید ربات کار می‌کند

بعد از دریافت توکن، حتماً آن را تست کنید تا مطمئن شوید درست کپی شده و سالم است. ساده‌ترین راه این است که توکن را در پنل بات‌ساز در بخش «افزودن ربات» وارد کنید؛ اگر سیستم بلافاصله نام و مشخصات ربات شما را شناسایی و وضعیت «متصل» را نشان داد، یعنی توکن سالم است. اگر ربات «تأییدنشده» ماند، معمولاً یا توکن ناقص کپی شده (یک کاراکتر جا افتاده)، یا اتصال اینترنت به تلگرام برقرار نیست. در این حالت توکن را دوباره و کامل کپی کنید و اتصال را بررسی کنید.

توکن را گم کردید؟ نیازی به ساخت ربات جدید نیست

یک نکته‌ی کاربردی که خیلی از راهنماها جا می‌اندازند: اگر توکن را گم کردید یا پاک کردید، لازم نیست ربات را از نو بسازید و آیدی و دنبال‌کننده‌های قبلی را از دست بدهید. کافی است در چت BotFather دستور mybots/ را بفرستید، ربات موردنظر را از لیست انتخاب کنید و روی گزینه‌ی «API Token» بزنید؛ BotFather همان توکن فعلی را دوباره نمایش می‌دهد، بدون اینکه آن را باطل کند. این مسیر با revoke/ فرق دارد: revoke/ توکن قدیمی را باطل و توکن جدید صادر می‌کند، اما mybots/ فقط توکن فعلی را دوباره نشان می‌دهد.

تنظیم نام، توضیحات و عکس ربات

بعد از ساخت ربات، بهتر است آن را حرفه‌ای‌تر کنید. با دستور setname/ می‌توانید نام نمایشی ربات را تغییر دهید، با setdescription/ یک توضیح کوتاه که کاربر قبل از شروع می‌بیند اضافه کنید، و با setuserpic/ یک عکس پروفایل برای ربات بگذارید. یک عکس پروفایل خوب و توضیح واضح، اعتماد مشتری را بالا می‌برد. همچنین با دستور setabouttext/ می‌توانید متن «درباره» ربات را تنظیم کنید که در پروفایل ربات نمایش داده می‌شود.

نکته‌ی امنیتی حیاتی: هر کسی توکن ربات شما را داشته باشد، کنترل کامل آن را در دست می‌گیرد و می‌تواند به‌جای شما پیام بفرستد. توکن را هرگز در اسکرین‌شات، گروه‌ها، فایل‌های عمومی یا مخزن‌های کد (مثل گیت‌هاب) قرار ندهید.

اگر توکن لو رفت چه کنیم؟

اگر فکر می‌کنید توکن ربات شما لو رفته یا به دست شخص نامطمئنی افتاده، فوراً اقدام کنید. در چت BotFather دستور revoke/ را بزنید، ربات موردنظر را انتخاب کنید و BotFather یک توکن جدید به شما می‌دهد. توکن قبلی بلافاصله باطل می‌شود و دیگر کار نمی‌کند. سپس باید توکن جدید را در پنل ربات‌ساز خود جایگزین کنید. این قابلیت یکی از مهم‌ترین لایه‌های امنیتی ربات تلگرام است. یکی از رایج‌ترین و کم‌توجه‌ترین راه‌های لو رفتن توکن، جا گذاشتن آن در کد منتشرشده روی مخزن‌های عمومی (مثل گیت‌هاب) است؛ اگر با کدنویسی کار می‌کنید یا برنامه‌نویس برایتان کد می‌نویسد، هرگز توکن را مستقیم داخل کد ننویسید و از متغیر محیطی (environment variable) یا فایل تنظیمات خصوصی استفاده کنید که در کد منتشرشده قرار نمی‌گیرد.

بعد از گرفتن توکن چه کنم؟

حالا که توکن ربات تلگرام را دارید، نوبت متصل‌کردن آن به یک ربات‌ساز است. کافی است وارد پنل بات‌ساز شوید و توکن را در بخش «افزودن ربات» وارد کنید. از این لحظه می‌توانید بدون کدنویسی منوی دکمه‌ای، محصولات، پاسخ خودکار و پرداخت را تنظیم کنید و فروشگاه تلگرامی‌تان را راه بیندازید. بات‌ساز توکن شما را رمزگذاری‌شده نگه می‌دارد تا حتی اگر کسی به دیتابیس دسترسی پیدا کند، توکن قابل خواندن نباشد.

دستورات پرکاربرد BotFather که باید بشناسید

BotFather علاوه بر ساخت ربات، مجموعه‌ای از دستورات کاربردی دارد که با آن‌ها می‌توانید ربات خود را کامل مدیریت کنید. شناخت این دستورات به شما کمک می‌کند ربات حرفه‌ای‌تری داشته باشید. مهم‌ترین دستورات شامل ساخت ربات جدید، مشاهده و بازیابی توکن، تغییر نام و توضیحات، تنظیم عکس پروفایل، مدیریت دستورات ربات و باطل‌کردن توکن است. همه‌ی این دستورات با علامت اسلش (/) شروع می‌شوند و در چت BotFather قابل استفاده‌اند.

• newbot/ — ساخت یک ربات جدید و دریافت توکن
• mybots/ — مشاهده و مدیریت ربات‌هایی که ساخته‌اید، از جمله بازیابی توکن فعلی
• setname/ — تغییر نام نمایشی ربات
• setdescription/ — تنظیم توضیحات ربات
• setuserpic/ — تنظیم عکس پروفایل ربات
• setcommands/ — تعریف دستورات منوی ربات
• revoke/ — باطل‌کردن توکن فعلی و دریافت توکن جدید
• deletebot/ — حذف کامل ربات

تفاوت آیدی ربات با نام نمایشی

یکی از نکاتی که خیلی‌ها را گیج می‌کند، تفاوت بین «نام نمایشی» و «آیدی» ربات است. نام نمایشی همان چیزی است که کاربر در بالای چت می‌بیند و می‌تواند فارسی و شامل فاصله باشد، مثل «فروشگاه گل نرگس». اما آیدی ربات (یا یوزرنیم) آدرس یکتای ربات است که با @ شروع می‌شود، فقط می‌تواند شامل حروف انگلیسی، عدد و آندرلاین باشد و حتماً باید به کلمه‌ی bot ختم شود، مثل narges_shop_bot. کاربران از طریق همین آیدی ربات شما را پیدا می‌کنند، پس بهتر است آیدی کوتاه، مرتبط و به‌یادماندنی انتخاب کنید.

کدنویسی دستی یا ربات‌ساز بدون برنامه‌نویسی؟

بعد از گرفتن توکن، یک تصمیم مهم پیش روی شماست: ربات را با کدنویسی دستی بسازید یا با یک ربات‌ساز بدون برنامه‌نویسی؟ جدول زیر این دو روش را در پنج معیار کلیدی مقایسه می‌کند تا بتوانید بر اساس شرایط کسب‌وکارتان درست تصمیم بگیرید.

همان‌طور که می‌بینید، برای اکثر کسب‌وکارها ربات‌ساز بدون کدنویسی هم سریع‌تر است، هم ارزان‌تر و هم بی‌دردسرتر. فقط اگر به قابلیت کاملاً خاصی نیاز دارید (مثل ربات فروش VPN یا کانفیگ‌ساز)، کدنویسی اختصاصی منطقی می‌شود.

۸ اشتباه رایج هنگام گرفتن و نگهداری توکن ربات

خیلی از کاربران تازه‌کار در همین مرحله‌ی ساده دچار اشتباه می‌شوند و بعداً ربات‌شان کار نمی‌کند یا امنیتش به خطر می‌افتد. این هشت اشتباه رایج را بشناسید تا گرفتارشان نشوید:

• کپی‌کردن ناقص توکن — جاافتادن یک کاراکتر یا چسبیدن فاصله‌ی اضافه باعث می‌شود ربات وصل نشود.
• قراردادن توکن در گروه، اسکرین‌شات یا فایل عمومی — بزرگ‌ترین اشتباه امنیتی.
• آپلود توکن در کد منتشرشده روی گیت‌هاب یا مخزن عمومی دیگر — ربات‌های خزنده مرتباً چنین توکن‌هایی را پیدا و از آن‌ها سوءاستفاده می‌کنند.
• انتخاب یوزرنیمی که به کلمه‌ی bot ختم نمی‌شود — تلگرام آن را قبول نمی‌کند.
• اشتباه‌گرفتن «نام نمایشی» با «یوزرنیم» — این دو کاملاً متفاوت‌اند.
• استفاده از اکانت جعلی BotFather — فقط اکانت با تیک آبی رسمی است.
• فراموش‌کردن باطل‌کردن (revoke) توکن بعد از اینکه فکر می‌کنید لو رفته است.
• نگه‌نداشتن نسخه‌ی پشتیبان از توکن در یک جای امن (مثل یادداشت رمزدار).

اگر یکی از این اشتباه‌ها برایتان پیش آمد، نگران نباشید؛ تقریباً همه‌شان قابل‌جبران‌اند. مثلاً اگر توکن لو رفت با revoke/ توکن جدید بگیرید، اگر گمش کردید با mybots/ دوباره پیدایش کنید، و اگر ربات وصل نشد توکن را دوباره و کامل کپی کنید.

مثال فرضی: راه‌اندازی یک کافه با ربات تلگرام

برای درک بهتر کاربرد عملی، یک سناریوی فرضی را در نظر بگیرید: یک کافه‌ی کوچک که سفارش‌های بیرون‌بر را در دایرکت اینستاگرام و تلگرام می‌گرفت و مدام سفارش‌ها قاطی می‌شد. صاحب کافه طبق همین مراحل، در کمتر از دو دقیقه از BotFather توکن می‌گیرد، آن را در پنل بات‌ساز وارد می‌کند، منوی نوشیدنی‌ها و غذاها را با عکس و قیمت اضافه می‌کند و پرداخت کارت‌به‌کارت را فعال می‌کند. از آن لحظه، مشتری‌ها می‌توانند مستقیم از ربات سفارش بدهند، آدرس بگذارند و رسید بفرستند — بدون اینکه صاحب کافه لازم باشد تک‌تک پیام‌ها را دستی جواب بدهد. همه‌ی این مسیر با یک توکن ساده شروع می‌شود.

جمع‌بندی

گرفتن توکن از BotFather ساده‌ترین و در عین حال مهم‌ترین قدم در ساخت ربات تلگرام است. در این راهنمای مرجع یاد گرفتید BotFather چیست، چرا توکن لازم است، چطور قدم‌به‌قدم توکن بگیرید و تست کنید، اگر گمش کردید چطور دوباره پیدایش کنید، چه اشتباهاتی را نکنید و چطور از توکن محافظت کنید. حالا که توکن را دارید، نوبت مرحله‌ی هیجان‌انگیز بعدی است: ساخت و شخصی‌سازی ربات فروشگاهی خودتان و افزودن محصولات. همین حالا رایگان شروع کنید و اولین ربات‌تان را بسازید.

مقالات مرتبط