اتصال ربات به تلگرام
تا وقتی توکن ربات را وارد نکردهاید، ربات شما فقط داخل پنل زنده است و مشتریها در تلگرام جوابی نمیگیرند. این فصل قدمبهقدم میگوید توکن را از کجا بگیرید، کجا بچسبانید، کدام دکمه واقعاً اتصال را برقرار میکند و اگر ربات جواب نداد دقیقاً چه چیزهایی را چک کنید.
توکن، همان کلید ربات شماست
تا وقتی توکن را وارد نکردهاید، هرچه ساختهاید — پیام خوشآمد، دکمههای منو، سناریوهای کلیدواژهای — فقط داخل پنل زنده است. مشتری «کافه نبش» که در تلگرام روی ربات شما میزند، هیچ جوابی نمیگیرد. توکن آن رشتهای است که به باتساز اجازه میدهد از طرف ربات شما در تلگرام حرف بزند.
برای گرفتنش لازم نیست چیزی نصب کنید؛ همهاش داخل خود تلگرام انجام میشود و کمتر از یک دقیقه طول میکشد. همین راهنما، خلاصهشده، بالای کادر توکن در صفحهی «اتصال به پیامرسانها» هم نوشته شده است.
به صفحهی اتصال از صفحهی اصلی ربات میرسید: کارت «اتصال» را بزنید. عنوان صفحه «اتصال به پیامرسانها» است با زیرعنوان «تلگرام، بله و روبیکا — توکن، وضعیت اتصال و رفع مشکل».
- ۱در تلگرام ربات @BotFather را باز کنید.
- ۲دستور /mybots را بفرستید.
- ۳از فهرستی که میآید، ربات خودتان را انتخاب کنید.
- ۴روی API Token بزنید.
- ۵رشتهای که نشان میدهد را کپی کنید — شکلش شبیه 123456789:AAE... است.
اگر هنوز در باتفادر رباتی نساختهاید، اول باید با دستور /newbot یک ربات بسازید تا API Token داشته باشید.
چسباندن توکن و دکمهی «ذخیره توکن»
در صفحهی اتصال، کارتی هست با عنوان «تعویض توکن ربات». اگر ربات شما هنوز توکن واقعی ندارد، همین کارت عنوانش «وارد کردن توکن واقعی» است — یعنی صفحه خودش میفهمد در چه مرحلهای هستید.
توکن کپیشده را داخل کادر «توکن ربات» بچسبانید. کادر عمداً چپچین و با فونت تکعرض است تا حروف و ارقام توکن قاطی نشوند و نمونهی 123456789:AAE... را هم بهعنوان راهنما نشان میدهد. تا وقتی کادر خالی باشد، دکمهی «ذخیره توکن» غیرفعال است.
دکمهی «ذخیره توکن» را بزنید. حین ذخیره روی دکمه مینویسد «در حال ذخیره...». اگر شکل توکن درست نباشد، بالای صفحه پیام قرمز «فرمت توکن درست نیست — باید شبیه 123456789:AAE... باشد» میآید و چیزی ذخیره نمیشود. اگر شکلش درست باشد ولی تلگرام آن را نپذیرد، پیام «توکن جدید نامعتبر است.» را میبینید — یعنی احتمالاً هنگام کپی، بخشی از رشته جا افتاده یا توکن را در باتفادر باطل کردهاید.
وقتی ذخیره موفق باشد، پیام سبز «توکن جدید ذخیره شد — حالا «اتصال مجدد» را بزنید.» ظاهر میشود و کادر توکن خالی میشود. این خالی شدن عمدی است: زیر همان کادر نوشته شده «توکن مثل رمز ربات شماست — با کسی به اشتراک نگذارید. ما آن را رمزگذاریشده (AES-256) ذخیره میکنیم و دیگر هرگز نمایشش نمیدهیم.»
پیامهای سبز و قرمز بالای صفحه بعد از چند ثانیه خودشان محو میشوند. اگر پیام را ندیدید، به برچسب وضعیت در کارت «وضعیت اتصال» نگاه کنید — همان واقعیت را نشان میدهد.
دکمهای که واقعاً ربات را روشن میکند
ذخیرهی توکن بهتنهایی کافی نیست و صفحه هم همین را به شما میگوید. کاری که اتصال را برقرار میکند، دکمهی «اتصال مجدد به تلگرام» است؛ بالای صفحه، داخل کارت «وضعیت اتصال».
آن را بزنید. حین کار روی دکمه مینویسد «در حال اتصال...» و آیکنش میچرخد. در صورت موفقیت پیام «ربات به تلگرام وصل شد ✅ حالا در تلگرام /start بزنید.» را میبینید و در همان کارت، بهجای «هنوز به تلگرام وصل نشده»، نامکاربری رباتتان به شکل یک لینک قابل کلیک ظاهر میشود که مستقیم ربات را در تلگرام باز میکند.
اگر اتصال شکست بخورد، پیام خطا علتش را میگوید — مثلاً که تایید توکن ناموفق بوده یا ثبت اتصال از سمت تلگرام رد شده. در این حالت اول توکن را دوباره از باتفادر بگیرید و ذخیره کنید، بعد دوباره «اتصال مجدد به تلگرام» را بزنید.
برچسب رنگی گوشهی همان کارت، وضعیت را با یک کلمه نشان میدهد. معنی هرکدام:
| برچسب روی صفحه | یعنی چه |
|---|---|
| «متصل به تلگرام» | همهچیز درست است؛ ربات در تلگرام جواب میدهد. |
| «متصل (polling)» | وصل است و جواب میدهد، فقط از مسیر فنی دیگری پیام میگیرد. |
| «حالت آزمایشی» | هنوز توکن واقعی وارد نشده؛ ربات فقط داخل پنل کار میکند. |
| «در انتظار اتصال» | توکن ذخیره شده اما هنوز «اتصال مجدد به تلگرام» را نزدهاید. |
| «توکن تایید نشده» | توکن ذخیره شد ولی تلگرام تاییدش نکرد؛ توکن را دوباره چک کنید. |
| «در انتظار آدرس عمومی» | سمت سرور هنوز آمادهی اتصال به تلگرام نیست. |
| «خطای webhook» | ثبت اتصال شکست خورده؛ «اتصال مجدد به تلگرام» را بزنید. |
| «غیرفعال» | کلید «ربات فعال باشد» در صفحهی اصلی ربات خاموش است. |
اولین /start — لحظهی حقیقت
حالا در کارت «وضعیت اتصال» روی نامکاربری ربات بزنید تا در تلگرام باز شود، و یکبار دستور /start را بفرستید. باید پیام خوشآمد و دکمههای منویی که ساختهاید بیاید. همین. از این لحظه، مشتری «پوشاک آرام» هم دقیقاً همین را میبیند.
اگر ربات هنوز در «حالت آزمایشی» است، صفحه یک کارت بنفش با عنوان «🧪 این ربات در حالت آزمایشی است» نشان میدهد و صریح میگوید که تا توکن واقعی از باتفادر وارد نکنید، ربات در تلگرام جواب نمیدهد — هرچند میتوانید همهچیز را بچینید و در «تست ربات» ببینید.
صفحهی «تست ربات» («شبیهساز واقعی — بدون نیاز به هیچ پیامرسانی») برای همین است: قبل و بعد از اتصال، هر تغییری در منو یا سناریوها دادید، همانجا بدون درگیر کردن مشتریها امتحانش کنید.
ربات جواب نمیدهد؟ اینها را چک کنید
پایین همان صفحه، کارتی هست با عنوان «ربات جواب نمیدهد؟ اینها را چک کنید». چهار مورد دارد، به همین ترتیب — و ترتیبش هم حسابشده است: از محتملترین علت شروع میشود.
مورد اول تقریباً همیشه جواب میدهد. زیر خود دکمه هم نوشته شده «اگر ربات در تلگرام جواب نمیدهد، اول این دکمه را بزنید. معمولاً همین مشکل را حل میکند.» اتصال ممکن است بعد از تغییرات فنی سمت سرور از دست برود و این دکمه دوباره برقرارش میکند.
مورد دوم را دستکم نگیرید: اگر کلید «ربات فعال باشد» در صفحهی اصلی ربات خاموش باشد، برچسب وضعیت «غیرفعال» میشود و ربات هرچقدر هم درست وصل باشد، سکوت میکند.
- «در بالای همین صفحه دکمهی «اتصال مجدد به تلگرام» را بزنید.»
- «مطمئن شوید کلید «ربات فعال باشد» در صفحهی اصلی ربات روشن است.»
- «در تلگرام یکبار دستور /start را بفرستید.»
- «اگر عضویت اجباری روشن است، ربات باید در آن کانال ادمین باشد.»
مورد چهارم مخصوص کسانی است که عضویت اجباری کانال را روشن کردهاند. اگر ربات در آن کانال ادمین نباشد، نمیتواند عضویت را بررسی کند و کاربر پشت همان مرحله گیر میکند.
بله و روبیکا روی همین صفحه
پایینتر از بخش تلگرام، دو کارت دیگر میبینید: «اتصال به بله» و «اتصال به روبیکا». همان ربات، همان منو و همان سناریوها روی این دو پیامرسان هم اجرا میشوند؛ چیز جدیدی نمیسازید و چیزی را دوباره تنظیم نمیکنید. فقط کافی است توکن هر کدام را از بازوی BotFather@ همان پیامرسان بگیرید و در کادر «توکن ربات بله» یا «توکن ربات روبیکا» بچسبانید.
بعد از اتصال، هر کدام دکمههای خودشان را دارند: «اتصال مجدد به بله» و «قطع اتصال بله» (و مشابهش برای روبیکا). یک تفاوت را بدانید: بخش تلگرام دکمهی «قطع اتصال» ندارد — آنجا فقط میتوانید توکن را عوض کنید یا دوباره وصل شوید.
برای «آرایشگاه رها» که مشتریهایش نصفشان بله دارند، این یعنی یکبار ساختن و سهجا جواب دادن — بدون اینکه سه پنل جدا اداره کنید.
قبل از رفتن به فصل بعد
- توکن را از @BotFather گرفتید: /mybots ← انتخاب ربات ← API Token
- توکن را در کادر «توکن ربات» چسباندید و «ذخیره توکن» را زدید
- پیام «توکن جدید ذخیره شد — حالا «اتصال مجدد» را بزنید.» را دیدید
- دکمهی «اتصال مجدد به تلگرام» را زدید و پیام «ربات به تلگرام وصل شد ✅» آمد
- برچسب وضعیت روی «متصل به تلگرام» است، نه «حالت آزمایشی» یا «غیرفعال»
- کلید «ربات فعال باشد» در صفحهی اصلی ربات روشن است
- در تلگرام /start زدید و پیام خوشآمد و منو را دیدید
- اگر عضویت اجباری روشن است، ربات را در آن کانال ادمین کردهاید
سوالهای پرتکرار این فصل
توکن را ذخیره کردم ولی ربات هنوز در تلگرام جواب نمیدهد. چرا؟
چون ذخیرهی توکن و برقراری اتصال دو کار جداگانهاند. بعد از ذخیره، باید دکمهی «اتصال مجدد به تلگرام» را در کارت «وضعیت اتصال» بزنید. خود پیام موفقیت هم همین را میگوید: «توکن جدید ذخیره شد — حالا «اتصال مجدد» را بزنید.»
پیام «فرمت توکن درست نیست — باید شبیه 123456789:AAE... باشد» میگیرم.
یعنی رشتهای که چسباندهاید شکل توکن تلگرام را ندارد — معمولاً چون بخشی از آن هنگام کپی جا افتاده یا فاصلهی اضافه دارد. دوباره از @BotFather با /mybots ← ربات ← API Token کل رشته را کپی کنید.
توکنم را جایی میبینم که دوباره چکش کنم؟
نه. باتساز توکن را رمزگذاریشده (AES-256) ذخیره میکند و دیگر هرگز نمایشش نمیدهد — همانطور که در راهنمای زیر کادر نوشته شده. اگر لازمش دارید، دوباره از @BotFather بگیریدش.
وضعیت روی «حالت آزمایشی» مانده. مشکل چیست؟
مشکلی نیست؛ یعنی هنوز توکن واقعی وارد نشده. در این حالت ربات فقط در صفحهی «تست ربات» کار میکند. توکن را از باتفادر بگیرید، ذخیره کنید و «اتصال مجدد به تلگرام» را بزنید.
میتوانم اتصال تلگرام را قطع کنم؟
در این صفحه دکمهی قطع اتصال فقط برای بله و روبیکا وجود دارد («قطع اتصال بله» و «قطع اتصال روبیکا»). برای تلگرام میتوانید توکن را عوض کنید، یا کلید «ربات فعال باشد» را در صفحهی اصلی ربات خاموش کنید تا ربات پاسخ ندهد.
همین ربات را میتوانم روی بله و روبیکا هم داشته باشم؟
بله. در همان صفحه، کارتهای «اتصال به بله» و «اتصال به روبیکا» را پر کنید. همان منو و همان سناریوها روی هر سه اجرا میشوند و چیز جداگانهای نمیسازید.