توکن ربات چیست؟ راهنمای گرفتن توکن ربات تلگرام
توکن ربات یک کلید محرمانه است که باتفادر (BotFather) هنگام ساختن ربات تلگرام به شما میدهد. شکلش یک رشتهٔ بلند از عدد و حرف انگلیسی است، چیزی شبیه 1234567890:ABCdefGhIJKlmNoPQRsTuVwxyz. هر ابزاری که این رشته را داشته باشد میتواند به‌جای ربات شما پیام بگیرد و جواب بدهد؛ برای همین باید مثل رمز عبور نگهش دارید.
آموزش‌های ساخت ربات معمولاً به یک جملهٔ کوتاه می‌رسند: «حالا توکن را بگیرید و وصل کنید». کار همان‌جا گیر می‌کند، چون کسی نگفته توکن از کجا می‌آید، چه شکلی است و بعد از گرفتنش چه میشود. این راهنما همین تکه را کامل می‌کند: گرفتن توکن از باتفادر در چند دقیقه، قاعده‌های نام کاربری، این‌که توکن بهتنهایی چرا کاری نمیکند، چک‌لیست «ربات جواب نمیدهد» و نگه‌داری امن. یک نکته را هم از همین اول بگوییم: اگر ربات را با هدهدهاب میسازید، اصلاً توکن دست‌به‌دست نمیکنید؛ پایین‌تر توضیح داده‌ایم چرا.
- توکن ربات تلگرام یک رشتهٔ محرمانه است: بخش قبل از دونقطه شناسهٔ عددی ربات است و بخش بعد، کلید آن.
- توکن را باتفادر با دستور
/newbotمیدهد؛ رایگان است و کارت بانکی نمیخواهد. - نام کاربری ربات ۵ تا ۳۲ نویسه است، فقط حرف انگلیسی، عدد و زیرخط می‌پذیرد و باید به bot ختم شود.
- خودِ توکن کاری نمیکند؛ باید ابزاری پشتش باشد که تصمیم بگیرد ربات چه جوابی بدهد.
- تلگرام پیام‌های هر ربات را فقط به یک مقصد می‌فرستد؛ یک توکن را هم‌زمان در دو ابزار وصل نکنید.
- اگر توکن لو رفت، با
/revokeباطلش کنید؛ ربات، نام و مخاطب‌ها سر جایشان میمانند. - در هدهدهاب توکن را جایی نمی‌چسبانید؛ اتصال تلگرام از «ربات مدیر» انجام میشود.
توکن ربات تلگرام دقیقاً چیست؟
توکن یک رشته است با دو تکه که یک دونقطه از هم جدایشان می‌کند، مثل 1234567890:ABCdefGhIJKlmNoPQRsTuVwxyz. تکهٔ اول شناسهٔ عددی ربات است و تکهٔ دوم کلید محرمانه‌اش. هر برنامهای که بخواهد از طرف ربات شما پیام بفرستد یا پیام کاربران را بخواند، باید همین رشته را به تلگرام نشان بدهد.
ساده‌اش این است که توکن، نام کاربری و رمز عبور ربات است در یک رشته. دو چیز دربارهٔ آن همیشه درست است: یکتاست و برای ربات دیگری صادر نمی‌شود؛ و محرمانه است، چون تلگرام فرقی بین شما و کسی که توکن شما را دارد نمی‌گذارد. اگر به جزئیات فنی علاقه دارید، راهنمای رسمی ربات‌های تلگرام نقطهٔ شروع است.
باتفادر؛ جایی که ربات شما ثبت میشود
باتفادر خودش یک ربات تلگرام است؛ رباتی که تلگرام با آن ربات‌های تازه را ثبت می‌کند و توکن میدهد. داخل تلگرام حساب رسمی باتفادر را باز کنید و به تیک آبی کنار نامش دقت کنید؛ حسابهای همنام و جعلی برای همین ساخته می‌شوند که توکن شما را بگیرند.
همهٔ کارها با دستورهایی انجام میشود که با / شروع می‌شوند و مثل یک پیام معمولی می‌فرستید. چیزی نصب نمیکنید و از تلگرام بیرون نمی‌روید؛ کل کار روی همان گوشی‌ای انجام میشود که پیج‌تان را با آن اداره می‌کنید.
قدم‌به‌قدم: از /newbot تا گرفتن توکن
کل کار چند دقیقه طول می‌کشد و هزینه‌ای ندارد:
- ۱ · دستور را بفرستید. در چت باتفادر
/newbotرا تایپ و ارسال کنید. باتفادر می‌پرسد ربات چه نامی داشته باشد. - ۲ · نام نمایشی بدهید. همان اسمی که مشتری بالای صفحهٔ چت می‌بیند، مثلاً «پشتیبانی فروشگاه ستاره». فارسی و فاصله‌دار هم میتواند باشد و بعداً عوض‌شدنی است.
- ۳ · نام کاربری بدهید. نشانی یکتای ربات است، مثل
SetareShop_bot. اگر قبلاً گرفته شده باشد، باتفادر می‌خواهد یکی دیگر انتخاب کنید. قاعده‌هایش در بخش بعد آمده است. - ۴ · توکن را بردارید. باتفادر یک پیام تبریک می‌فرستد که توکن داخل آن است. رویش بزنید تا کپی شود.
- ۵ · جای امنی نگهش دارید. یک یادداشت خصوصی یا نرم‌افزار مدیریت رمز؛ نه گروه کاری و نه اسکرین‌شات.
قاعده‌های نام و نام کاربری ربات در یک نگاه
بیشتر کسانی که در مرحلهٔ سوم گیر می‌کنند، یکی از این قاعده‌ها را رعایت نکرده‌اند. قاعده‌ها را تلگرام گذاشته است، نه رباتساز شما:
| چیز | قاعده | بعداً عوض میشود؟ |
|---|---|---|
| نام نمایشی | آزاد؛ فارسی، انگلیسی و فاصله | بله، با /setname |
| نام کاربری | ۵ تا ۳۲ نویسه؛ فقط حرف انگلیسی، عدد و زیرخط؛ باید به bot ختم شود | از اول درست انتخابش کنید؛ هر لینکی که به مشتری داده‌اید به آن وابسته است |
| عکس ربات | یک تصویر مربعی | بله، با /setuserpic |
| توضیح ربات | متنی که کاربر پیش از شروع گفتگو می‌بیند | بله، با /setdescription |
| توکن | یک رشته برای هر ربات | بله، با /revoke توکن تازه می‌گیرید |
نام کاربری را کوتاه و شبیه نام برندتان بگیرید. مشتری آن را روی کارت و بسته‌بندی می‌بیند و باید بتواند بدون غلط تایپش کند.
اگر تازه با موضوع آشنا شده‌اید، ربات تلگرام چیست را بخوانید؛ و برای کل مسیر، از تعریف کار ربات تا انتشار، آموزش ساخت ربات تلگرام را ببینید.
توکن را کجا وصل کنیم تا ربات جان بگیرد؟
این را بیشتر آموزش‌ها نمی‌گویند: توکن بهتنهایی هیچ کاری نمیکند. اگر همین حالا به رباتی که ساخته‌اید پیام بدهید، جوابی نمی‌گیرید، چون هنوز چیزی پشت آن نیست که تصمیم بگیرد چه بگوید. توکن کلید در است؛ کسی باید پشت در بنشیند.
آن «کسی» یکی از این سه چیز است و جای توکن در هر کدام فرق دارد:
- کدی که خودتان یا برنامه‌نویس مینویسید. توکن در تنظیمات محرمانهٔ همان برنامه می‌نشیند، نه داخل کد و نه در مخزن عمومی.
- ربات‌سازهایی که توکن می‌خواهند. توکن را در صفحهٔ اتصال همان سرویس وارد می‌کنید. پیش از این کار مطمئن شوید سرویس را می‌شناسید؛ با این توکن میتواند از طرف ربات شما به همهٔ مخاطب‌هایتان پیام بدهد.
- هدهدهاب. توکن را جایی نمی‌چسبانید. «ربات مدیر» هدهدهاب را در تلگرام باز می‌کنید، دکمهٔ «ساخت ربات تلگرام» را می‌زنید و تأیید می‌کنید؛ بعد به بخش اتصال‌های پنل برمی‌گردید و نام و شناسهٔ همان ربات را تأیید می‌کنید. وصل‌شدن تلگرام هنوز انتشار نیست: نسخهٔ ربات را خودتان مرور و تأیید می‌کنید و بعد منتشر میشود.
بی‌پرده: پس اگر با هدهدهاب میسازید، چرا این راهنما را بخوانید؟ چون ربات باز هم یک ربات تلگرام معمولی است. نام و عکسش را بعداً در باتفادر عوض می‌کنید، و دانستن این‌که توکن چیست کمک می‌کند آن را هیچ‌وقت به کسی یا سرویسی که نمی‌شناسید ندهید. هدهدهاب جایی برای واردکردن دستی توکن تلگرام ندارد؛ اگر از قبل ربات دارید و می‌خواهید همان را با همان نام کاربری نگه دارید، پیش از شروع از پشتیبانی بپرسید.
برای این‌که ببینید پشت در چه کسی میتواند بنشیند، ساخت ربات هوش مصنوعی تلگرام را بخوانید؛ الگوی ربات فروشگاهی و ربات پشتیبانی هم دو نمونهٔ رایج‌اند.
ربات جواب نمیدهد؛ چه چیزی را چک کنیم؟
تقریباً همیشه مشکل یکی از این‌هاست، نه خودِ تلگرام. اگر توکن را خودتان در ابزاری وارد کرده‌اید، به این ترتیب بروید:
- توکن ناقص یا با فاصلهٔ اضافه کپی شده است. توکن را کپی کنید، دستی تایپ نکنید؛ یک فاصله در اول یا آخر رشته کافی است تا اتصال برقرار نشود.
- همان توکن جای دیگری هم وصل است. تلگرام پیام‌های هر ربات را فقط به یک مقصد می‌فرستد. اگر توکن را قبلاً به ابزار دیگری داده‌اید، هر اتصال تازه قبلی را از کار می‌اندازد و برعکس. اتصال قدیمی را قطع کنید، یا با
/revokeتوکن تازه بگیرید تا هر اتصال قدیمی‌ای باطل شود. - ربات هنوز منتشر یا فعال نشده است. ثبت توکن معمولاً یک قدم است و روشن‌کردن ربات قدم بعد.
- هیچ جوابی برای شروع گفتگو تعریف نشده است. دست‌کم برای
/start، یعنی اولین چیزی که هر کاربر می‌فرستد، یک پاسخ بگذارید.
اگر ربات را با هدهدهاب ساخته‌اید، فهرست فرق می‌کند، چون توکنی در کار نیست:
- اتصال تلگرام را در پنل تأیید کرده‌اید؟ ساختن ربات در «ربات مدیر» کافی نیست؛ نام و شناسه باید در پنل تأیید شود.
- نسخهٔ ربات منتشر شده است؟ اتصال و انتشار دو مرحلهٔ جدا هستند.
- دورهٔ آزمایشی ۷ روزه تمام نشده است؟ بعد از آن، روشن‌ماندن ربات به یکی از پلن‌ها نیاز دارد.
- در خودِ تلگرام امتحان کرده‌اید؟ پیش‌نمایش داخل پنل جای پیام‌دادن واقعی به ربات را نمی‌گیرد.
امنیت توکن؛ اشتباه‌هایی که نباید بکنید
هرکس توکن را داشته باشد، ربات را دارد: میتواند به مخاطب‌های شما پیام بدهد و اعتبارتان را خرج کند. چهار قاعدهٔ ساده:
- توکن را در گروه، کانال یا شبکهٔ اجتماعی نفرستید؛ حتی برای پرسیدن یک سؤال فنی.
- آن را داخل کدی که روی مخزن عمومی (مثل گیت‌هاب) می‌رود نگذارید.
- توکن را فقط به سرویسی بدهید که می‌شناسید و واقعاً ربات را اجرا می‌کند.
- اگر شک کردید جایی لو رفته، معطل نکنید؛ باطلش کنید و توکن تازه بگیرید.
باطل‌کردن ساده است: در چت باتفادر /revoke را بفرستید و ربات را انتخاب کنید. توکن قدیمی همان لحظه از کار میافتد و توکن تازه صادر میشود. ربات، نام و مخاطبهایش دست‌نخورده میمانند؛ فقط باید توکن تازه را در ابزاری که ربات را اجرا می‌کند جایگزین کنید.
بی‌پرده: هیچ ابزاری، از جمله هدهدهاب، نمی‌تواند توکنی را که خودتان جای عمومی گذاشته‌اید امن نگه دارد. لو رفتنش برگشت‌پذیر است، اما بهتر است پیش نیاید.
چند دستور پرکاربرد باتفادر
باتفادر جز ساختن ربات، چند دستور دیگر هم دارد که بعداً به کارتان می‌آید:
| دستور | کاری که انجام میدهد |
|---|---|
/newbot | ساخت یک ربات جدید و گرفتن توکن |
/mybots | فهرست ربات‌هایی که ساخته‌اید و مدیریتشان |
/token | دیدن دوبارهٔ توکن یک ربات موجود |
/revoke | باطل‌کردن توکن فعلی و صدور توکن تازه |
/setname | تغییر نام نمایشی ربات |
/setdescription | توضیحی که کاربر پیش از شروع گفتگو می‌بیند |
/setuserpic | تغییر عکس ربات |
/deletebot | حذف کامل و همیشگی یک ربات |
جزئیات فنی هر قابلیت در مرجع رسمی Bot API تلگرام آمده است و دریافت پرداخت درون ربات هم راهنمای رسمی خودش را دارد.
۷ روز رایگان بساز و تست کنبدون کد · بدون کارت بانکی
سؤال‌های پرتکرار
- توکن ربات چیست؟
- توکن ربات یک رشتهٔ محرمانه است که باتفادر هنگام ساخت ربات تلگرام میدهد. بخش قبل از دونقطه شناسهٔ عددی ربات است و بخش بعد کلید آن. هر برنامهای که این رشته را داشته باشد میتواند از طرف ربات پیام بفرستد و بگیرد.
- توکن ربات تلگرام را از کجا بگیرم؟
- از باتفادر (BotFather)، ربات رسمی تلگرام. چت را باز کنید، دستور /newbot را بفرستید، یک نام نمایشی و یک نام کاربری که به bot ختم میشود بدهید؛ پیام بعدی باتفادر توکن شماست.
- BotFather تلگرام همان باتفادر رسمی است؟
- بله. BotFather حساب رسمی تلگرام برای ساخت و مدیریت رباتهاست. از نشانی t.me/botfather واردش شوید و به تیک آبی دقت کنید؛ توکن را به حسابهای همنام ندهید.
- گرفتن توکن ربات تلگرام هزینه دارد؟
- نه. رایگان است، کارت بانکی یا اشتراک نمیخواهد و چند دقیقه بیشتر طول نمیکشد.
- بعد از گرفتن توکن باید چه کار کنم؟
- توکن بهتنهایی کاری نمیکند؛ باید ابزاری پشت آن باشد که جوابهای ربات را بسازد: کدی که خودتان مینویسید یا یک رباتساز. اگر با هدهدهاب میسازید، توکن را جایی وارد نمیکنید؛ اتصال تلگرام از «ربات مدیر» هدهدهاب انجام میشود.
- توکن را وارد کردم اما ربات جواب نمیدهد؛ مشکل کجاست؟
- معمولاً یکی از این چهار مورد: توکن با فاصلهٔ اضافه کپی شده، همان توکن در ابزار دیگری هم وصل است، ربات هنوز فعال یا منتشر نشده، یا هیچ پاسخی برای /start تعریف نشده است.
- اگر توکن ربات لو برود چه اتفاقی میافتد؟
- هرکس توکن را داشته باشد میتواند از طرف ربات شما پیام بدهد. در چت باتفادر دستور /revoke را بفرستید تا توکن قدیمی باطل و توکن تازه صادر شود؛ ربات و مخاطبهایش سر جایشان میمانند.
