سؤالات متداول
Быстрый старт
توکن ربات تلگرام را کجا پیدا کنیم؟
توکن ربات تلگرام را کجا پیدا کنیم؟

توکن ربات تلگرام را کجا پیدا کنیم؟

Anton Ingachev
۸ شهریور ۱۴۰۵

توکن یک کلید محرمانه است که به Mini Apps Builder اجازه می‌دهد ربات شما را به پروژه متصل کند. این مورد نه رمز عبور تلگرام است و نه لینک ربات. برای دریافت آن نیازی به برنامه‌نویسی ندارید.

چطور توکن را بگیریم، اگر هنوز رباتی ندارید

از BotFather رسمی باز کنید. این ابزار تلگرام برای ساخت ربات‌ها و مدیریت آن‌هاست. نام کاربری را بررسی کنید — دقیقاً @BotFather، بدون حروف و اعداد اضافی. رابط کاربری در همه پلتفرم‌ها یکسان است: Android، iOS، macOS، Windows، Linux، Web.

مراحل بعدی در چت BotFather انجام می‌شود: روی Start Bot کلیک کنید،

چنین پیامی را خواهید دید. بعد از آن می‌توانید به دو روش ربات بسازید: از طریق چت و Mini App.

ساخت ربات جدید از طریق چت

باید از پیام ارسال‌شده توسط BotFather گزینه /newbot را انتخاب کنید. کافی است روی همین متن در پیام کلیک کنید تا فرآیند ساخت ربات بلافاصله آغاز شود.

BotFather از شما می‌پرسد که برنامه را چه نامی بگذارید. این «نام» ربات/برنامه شماست که هر کاربر در تلگرام آن را می‌بیند. البته بعداً هم می‌توانید در هر زمان آن را تغییر دهید.

بعد از وارد کردن «نام»، BotFather از شما می‌خواهد username_bot را تعیین کنید - این یک ID منحصربه‌فرد است و بعد از ساخت دیگر قابل تغییر نیست. ضمن اینکه خود تلگرام هم اگر گزینه واردشده قبلاً استفاده شده باشد به شما اطلاع می‌دهد.

پس از وارد کردن username_bot چنین پیامی می‌بینید، یعنی ربات ساخته شده است. داخل پیام، bot token قرار دارد. کافی است روی آن بزنید تا کپی شود؛ در این صورت می‌توانید آن را در سایت ما وارد کنید.

توکن کپی‌شده را باید در فیلد "Token" هنگام ساخت پروژه در Mini Apps Builder وارد کنید. بعد از آن پروژه ساخته می‌شود.

ساخت ربات جدید از طریق Mini App

این روش دوم برای ساخت ربات جدید و دریافت bot token است. اگر از روش بالا استفاده کرده‌اید، لازم نیست این بخش را بخوانید.

روی دکمه "Open" در پایینِ سمت چپ، کنار فیلد وارد کردن متن در چت، کلیک می‌کنید.

چنین صفحه‌ای باز می‌شود. اگر قبلاً هیچ رباتی نساخته باشید، زیر متن "My bots" چیزی نخواهید دید. در هر صورت، الان سناریوی ساخت ربات جدید را بررسی می‌کنیم، بنابراین روی دکمه "Create a New Bot" می‌زنیم.

فیلدهای مشخص‌شده باید حتماً پر شوند. لوگو و "About" را می‌توانید بعداً در هر زمان اضافه کنید.

Bot Name - نام ربات/برنامه شماست که هر کاربر در تلگرام آن را می‌بیند. البته بعداً هم می‌توانید در هر زمان آن را تغییر دهید.

username_bot - این یک ID منحصربه‌فرد است و بعد از ساخت دیگر قابل تغییر نیست. ضمن اینکه خود تلگرام هم اگر گزینه واردشده قبلاً استفاده شده باشد به شما اطلاع می‌دهد.

پس از وارد کردن Bot Name و username_bot، روی دکمه "Create Bot" در پایین صفحه بزنید.

چنین صفحه‌ای را می‌بینید؛ روی دکمه "Copy" کلیک کنید تا Bot Token این ربات کپی شود.

بعد از زدن دکمه "Copy"، برای لحظه‌ای چنین پیغامی را خواهید دید. یعنی توکن را کپی کرده‌اید و می‌توانید آن را در سایت ما وارد کنید.

توکن کپی‌شده را باید در فیلد "Token" هنگام ساخت پروژه در Mini Apps Builder وارد کنید. بعد از آن پروژه ساخته می‌شود.

اگر نشد چه کار کنیم

مشکلچه کار کنیم
ربات موردنظر در فهرست نیستبررسی کنید حساب تلگرامی‌ای که ربات به آن تعلق دارد باز باشد. اگر شخص دیگری آن را ساخته است، از او بپرسید مالک چه کسی است.
BotFather username را نمی‌پذیرداز حروف لاتین، اعداد و زیرخط استفاده کنید و پسوند bot را اضافه کنید. اگر نام اشغال شده بود، نام دیگری انتخاب کنید.
نمی‌شود دستور را ارسال کردحتماً چت @BotFather را باز کنید و /mybots یا /newbot را در نوار پیام بفرستید.
Mini Apps Builder توکن را نمی‌پذیرددوباره آن را کپی کنید. بررسی کنید که کل رشته را بدون متن اضافی و فاصله‌ها وارد کرده‌اید.

اگر خطا باقی ماند، متن آن را برای پشتیبانی Mini Apps Builder ارسال کنید و آخرین مرحله‌ای را که انجام داده‌اید توضیح دهید. خود توکن را پیوست نکنید. در اسکرین‌شات، آن را کامل مخفی کنید.

چطور توکن را ایمن نگه داریم

توکن به مدیریت ربات دسترسی می‌دهد، بنابراین با آن مثل رمز عبور رفتار کنید. آن را منتشر نکنید و برای افراد ناشناس نفرستید. کلید را فقط در فیلد مخصوصِ سرویسی وارد کنید که به اتصال ربات به آن اعتماد دارید.

برای ساخت برنامه خود آماده‌اید؟

همین حالا شروع کنید—رایگان است!