باتروم | BotRoom
آموزش شروع کارانتشار: ۲۵ آبان ۱۴۰۵زمان مطالعه: ۵ دقیقه

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

برای راه‌اندازی اولین ربات خود در پیام‌رسان بله به یک توکن از BotFather نیاز دارید. در این راهنما تمام مراحل از ساخت بازو تا تست در شبیه‌ساز باتروم را مرور می‌کنیم.

۱. ساخت بازوی جدید در @BotFather پیام‌رسان بله

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

با انتخاب گزینه ساخت بازوی جدید (/newbot)، از شما دو مورد خواسته می‌شود: نام نمایشی بازو (به فارسی یا انگلیسی) و نام کاربری (Username) که باید به کلمه bot ختم شود.

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

۲. ثبت توکن و اعتبارسنجی خودکار (getMe) در باتروم

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

نکته مهم این است که می‌توانید چندین بازوی بله را همزمان در یک پنل مدیریت کنید و برای هر کدام جریان گفتگو، محصولات یا تقویم نوبت‌دهی مجزا بسازید.

۳. فعال‌سازی وبهوک با یک کلیک و پردازش بدون تایم‌اوت

در روش‌های سنتی، برنامه‌نویسان باید گواهی SSL تنظیم کنند و آدرس وبهوک را دستی ست کنند. در باتروم، کافی است کلید «فعال‌سازی وبهوک» را بزنید تا ارتباط بازو با یک کلیک برقرار شود و هر زمان خواستید آن را متوقف کنید.

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

۴. تست در شبیه‌ساز زنده پیش از انتشار عمومی

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

سایر راهنماهای ساخت بازوی پیام‌رسان بله