
توکن یک کلید محرمانه است که به 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 وارد کنید. بعد از آن پروژه ساخته میشود.
این روش دوم برای ساخت ربات جدید و دریافت 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 ارسال کنید و آخرین مرحلهای را که انجام دادهاید توضیح دهید. خود توکن را پیوست نکنید. در اسکرینشات، آن را کامل مخفی کنید.
توکن به مدیریت ربات دسترسی میدهد، بنابراین با آن مثل رمز عبور رفتار کنید. آن را منتشر نکنید و برای افراد ناشناس نفرستید. کلید را فقط در فیلد مخصوصِ سرویسی وارد کنید که به اتصال ربات به آن اعتماد دارید.