پرش به محتویات

ساخت و مدیریت ربات با BotFather

ربات رسمی @BotFather در پیام‌رسان کدمیت، ابزار مرکزی برای ساخت، پیکربندی، دریافت توکن و مدیریت ربات‌های شماست.

شروع گفتگو با BotFather

  1. در کدمیت، شناسه @botfather را جستجو کرده و وارد گفتگو با آن شوید.
  2. دکمه Start یا دستور /start را ارسال کنید. منوی تعاملی دستورات نمایش داده می‌شود.
/newbot - ساخت ربات جدید
/mybots - مشاهده و مدیریت لیست ربات‌ها

ویرایش مشخصات:
/setname - تغییر نام نمایشی ربات
/setdescription - تغییر متن توضیحات (Description)
/setabouttext - تغییر بیوگرافی و متن About
/setuserpic - تغییر عکس پروفایل ربات
/setcommands - تنظیم لیست دستورات پیشنهادی
/deletebot - حذف ربات

تنظیمات و امنیت:
/token - دریافت و مشاهده توکن ربات
/revoke - باطل کردن توکن فعلی و ساخت توکن جدید
/setwebhook - تنظیم آدرس وب‌هوک
/deletewebhook - حذف وب‌هوک و بازگشت به Polling
/cancel - انصراف از عملیات جاری

مراحل ساخت ربات جدید (/newbot)

  1. دستور /newbot را ارسال کنید یا از دکمه شیشه‌ای New Bot استفاده کنید.
  2. نام نمایشی (Display Name) ربات خود را بفرستید (مثال: دستیار پشتیبانی فروشگاه).
  3. نام کاربری (Username) را ارسال کنید:
    • نام کاربری باید به کلمه bot ختم شود (مانند ShopSupportBot یا shop_support_bot).
    • نام کاربری باید بین ۵ تا ۳۲ کاراکتر بوده و فقط شامل حروف انگلیسی، اعداد و زیرخط (_) باشد.
  4. پس از تأیید، BotFather پیام تبریک و توکن اختصاصی API را به شما نمایش می‌دهد:

/// warning | حفاظت از توکن ربات توکن ربات کلید دسترسی به تمام امکانات و پیام‌های ربات شماست. هرگز آن را در مخازن عمومی گیت (Git) یا در فرانت‌اند منتشر نکنید. ///

نمونه توکن دریافتی: 

cc88a81be3ef:jDbheaJb1yh1cFBb96zPHMd99pQb4kulF_K1Fsoj6pk

مدیریت مشخصات و تنظیمات ربات

۱. ویرایش نام (/setname)

نام نمایشی ربات را تا سقف ۱۰۰ کاراکتر تغییر می‌دهد. 

/setname @MyCustomBot ربات هوشمند من

۲. ویرایش توضیحات (/setdescription)

متنی که پیش از استارت ربات به کاربران در صفحه چت نمایش داده می‌شود (حداکثر ۵۱۲ کاراکتر). 

/setdescription @MyCustomBot این ربات برای استعلام قیمت و وضعیت سفارشات شما طراحی شده است.

۳. ویرایش درباره ربات (/setabouttext)

متنی که در بیوگرافی و پروفایل ربات نمایش داده می‌شود (حداکثر ۱۲۰ کاراکتر). 

/setabouttext @MyCustomBot پشتیبانی ۲۴ ساعته و استعلام سفارشات

۴. تغییر عکس پروفایل (/setuserpic)

با ارسال /setuserpic @MyCustomBot، عکس مورد نظرتان را برای BotFather بفرستید تا بلافاصله به عنوان آواتار ربات تنظیم شود.

۵. تنظیم لیست دستورات (/setcommands)

لیستی از دستورات را ارسال کنید تا هنگامی که کاربر علامت / را در چت تایپ می‌کند نمایش داده شوند: 

start - شروع به کار و نمایش منوی اصلی
help - راهنما و پشتیبانی
status - استعلام وضعیت حساب کاربری

۶. باطل‌کردن و بازتولید توکن (/revoke)

در صورتی که توکن شما فاش شد، بلافاصله دستور /revoke @MyCustomBot را ارسال کنید تا توکن قبلی باطل شده و توکن جدید تولید شود.