آموزش ساخت و تنظیمات ربات فروشگاهی در BotFather تلگرام (راهنمای صفر تا صد نام کاربری، عکس، بیو و توکن)

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

بسیاری از صاحبان آنلاین‌شاپ‌ها و کانال‌های تلگرامی تصور می‌کنند ساخت ربات نیازمند دانش کدنویسی، سرورهای لینوکسی و هزینه‌های گزاف ماهانه است؛ در حالی که ساخت هویت اولیه ربات در تلگرام کمتر از ۳ دقیقه زمان می‌برد و کاملاً رایگان است. سپس با اتصال این هویت به یک پلتفرم آماده مانند فروشگاه‌ساز تلگرام شاپینو، تمامی بخش‌های ثبت کاتالوگ، انبارداری هوشمند و صدور فاکتور بدون نیاز به حتی یک خط برنامه‌نویسی فعال می‌گردد.

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

۱. BotFather چیست و چرا دروازه رسمی تمام ربات‌های تلگرام است؟ {#what-is-botfather}

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

وظایف کلیدی بات فادر تلگرام:

1. 1
   احراز هویت و صدور توکن (HTTP API Token): ایجاد کلید دیجیتال امن برای اتصال ربات به سرورهای ابری.
2. 2
   مدیریت نام و آدرس اینترنتی: تخصیص یوزرنیم اختصاصی که مشتریان از طریق آن به فروشگاه شما وارد می‌شوند.
3. 3
   تنظیمات بصری و برندینگ: بارگذاری لوگو، عکس پروفایل، بنر خوش‌آمدگویی و متن بیوگرافی.
4. 4
   تنظیمات دستورات و منوها: تعیین لیست دستورات پیش‌فرض منوی ربات.

۲. آموزش گام‌به‌گام ساخت ربات فروشگاهی با دستور newbot {#step-by-step-newbot}

فرآیند ثبت ربات جدید بسیار روان و استاندارد طراحی شده است. مراحل زیر را قدم به قدم اجرا کنید:

“

مسیر سریع ساخت ربات در ۳ گام: [ ارسال دستور /newbot ] ──> [ تعیین نام برند تجاری ] ──> [ انتخاب نام کاربری اختصاصی یکتا ] ──> [ دریافت توکن API ]

گام اول: شروع کار با بات فادر

۱. در نوار جستجوی تلگرام عبارت @BotFather را سرچ کرده و وارد چت شوید. ۲. دکمه Start یا دستور /start را لمس کنید تا لیست فرامین برای شما ارسال گردد.

گام دوم: فراخوانی دستور ساخت ربات جدید

دستور /newbot را در کادر پیام تایپ کرده و بفرستید. بات فادر از شما می‌خواهد نام نمایشی (Name) ربات را وارد نمایید.

گام سوم: تعیین نام نمایشی فروشگاه (Bot Name)

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

گام چهارم: انتخاب نام کاربری یکتا (Username)

بات فادر از شما می‌خواهد یک آیدی یکتا (Username) تعیین کنید. قوانین تلگرام برای این آیدی عبارتند از:

• باید فقط شامل حروف انگلیسی، اعداد و خط زیرین (Underscore) باشد.
• باید حتماً با پسوند bot یا _bot خاتمه یابد.
• نباید قبلاً توسط شخص دیگری ثبت شده باشد.
• مثال‌های صحیح: ShikpooshShopBot یا shikpoosh_bot

پس از ارسال یوزرنیم معتبر، بات فادر پیام تبریک حاوی توکن دسترسی (API Token) را برای شما می‌فرستد.

۳. اصول انتخاب نام برند و نام کاربری (Username) پرفروش و استاندارد {#bot-name-and-username-rules}

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

۴. دریافت و نکات امنیتی توکن دسترسی ربات (Bot API Token) {#bot-api-token-security}

پیام نهایی BotFather شامل متنی شبیه به عبارت زیر است:

“

Use this token to access the HTTP API: 7283948123:AAFnJqL9x_kP193mZsLmQ8x9y7w2-AbcDef

این رشته کاراکتری طولانی، کلید اختصاصی ربات شما است. هر سیستمی که این توکن را در اختیار داشته باشد، می‌تواند به جای ربات پیام بفرستد، سفارش ثبت کند و کاتالوگ را مدیریت نماید.

سه اصل امنیتی حیاتی درباره توکن ربات:

1. 1
   محرمانگی مطلق: توکن را در گروه‌ها، کانال‌ها یا اسکرین‌شات‌های پشتیبانی عمومی قرار ندهید.
2. 2
   اتصال فقط به سامانه‌های معتبر: توکن را تنها در سامانه‌های استاندارد مانند سامانه امن فروشگاه‌ساز شاپینو وارد نمایید.
3. 3
   نحوه باطل کردن توکن در صورت لو رفتن (Revoke Token): اگر احساس کردید توکن شما افشا شده است: * به BotFather مراجعه کنید و دستور /mybots را بزنید. * ربات خود را انتخاب کرده و روی دکمه API Token کلیک کنید. * گزینه Revoke current token را انتخاب کنید تا توکن قبلی در یک ثانیه باطل و توکن جدید صادر شود.

۵. تنظیمات ظاهری: عکس پروفایل، متن بیوگرافی و صفحه آغازین {#bot-profile-bio-photo-setup}

یک ربات بدون عکس و بدون متن خوش‌آمدگویی، حس ربات‌های فیک یا غیرفعال را به مشتری می‌دهد. با چند فرمان ساده، ربات خود را تبدیل به یک ویترین لوکس کنید:

۱. دستور setuserpic (تنظیم عکس پروفایل ربات)

دستور /setuserpic را بفرستید، ربات مورد نظرتان را انتخاب کرده و یک تصویر باکیفیت لوگو یا نماد فروشگاه (ترجیحاً مربعی ۵۱۲×۵۱۲ پیکسل) ارسال کنید. طبق راهنمای جامع عکاسی و تولید محتوا، لوگوی با پس‌زمینه شفاف یا کنتراست بالا بهترین جلوه را دارد.

۲. دستور setdescription (متن صفحه آغازین و پیش از استارت)

دستور /setdescription متنی است که کاربر وقتی برای اولین بار وارد ربات می‌شود و هنوز دکمه Start را نزده است، در وسط صفحه مشاهده می‌کند. *متن نمونه پیشنهادی:* «به فروشگاه آنلاین ما خوش آمدید! مشاهده جدیدترین محصولات، تخفیف‌های هفتگی و ثبت سفارش خودکار با تحویل اکسپرس به سراسر کشور. برای شروع دکمه Start را لمس کنید.»

۳. دستور setabouttext (بیوگرافی پروفایل ربات)

دستور /setabouttext متنی است که در بخش اطلاعات کاربری (Profile Bio) ربات ثبت می‌شود و حداکثر ۱۲۰ کاراکتر است. *متن نمونه پیشنهادی:* «فروشگاه رسمی پوشاک شیک‌پوش | ثبت سفارش ۲۴ ساعته | پشتیبانی: @am1385ir»

۶. نحوه اتصال توکن به ربات مادر شاپینو و آغاز فروش خودکار {#connecting-token-to-shopino}

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

“

معماری جریان اتصال در شاپینو: [ توکن از BotFather ] ──> [ ثبت در ربات @ShopinoSalesBot یا پنل وب ] ──> [ فعال‌سازی وب‌هوک و زیرساخت ابری ] ──> [ راه‌اندازی فروشگاه اختصاصی آنلاین ]

۱. وارد ربات مدیریت شاپینو به نشانی @ShopinoSalesBot شوید یا به داشبورد وب شاپینو مراجعه نمایید. ۲. گزینه «افزودن فروشگاه جدید» یا «اتصال ربات فروشگاهی اختصاصی» را انتخاب کنید. ۳. توکن دریافت شده از BotFather را ارسال نمایید. ۴. موتور ابری شاپینو در کمتر از ۱۰ ثانیه وب‌هوک ایمن (Webhook) را مستقر کرده و ربات اختصاصی شما متولد می‌شود!

اکنون تمام امکانات پیشرفته از جمله مدیریت متغیرهای سایز و رنگ، سبد خرید خودکار، انبارداری و رهگیری کدهای پستی مرسولات بر روی ربات شما فعال است.

۷. خطاهای متداول در BotFather و راه‌حل رفع آن‌ها {#troubleshooting-botfather-errors}

اگر در طول فرآیند با پیامی قرمز یا اخطار مواجه شدید، نگران نباشید؛ خطاهای زیر بسیار رایج و راه‌حل آن‌ها مشخص است:

• خطای Sorry, this username is already taken: *علت:* یوزرنیم انتخابی شما قبلاً توسط کاربری دیگر در جهان ثبت شده است. *راه‌حل:* یک پسوند عددی کوتاه، پیشوند iran یا کلمه shop به آیدی اضافه کنید (مثلاً: maneli_clothing_bot).

• خطای Sorry, this username is invalid: *علت:* در نام کاربری از کاراکترهای غیرمجاز مانند فاصله، خط تیره یا فارسی استفاده کرده‌اید یا انتهای آن کلمه bot درج نشده است. *راه‌حل:* فقط از حروف انگلیسی کوچک و بزرگ و _ استفاده کنید و مطمئن شوید کلمه پایانی حتماً bot است.

• خطای Too many attempts: *علت:* به دلیل ارسال پشت سر هم دستورات در زمان کوتاه، تلگرام درخواست‌ها را موقتاً محدود کرده است. *راه‌حل:* ۲ دقیقه صبر کنید و مجدداً تلاش نمایید.

۸. سوالات متداول درباره ساخت ربات در بات فادر تلگرام {#faq}