ساخت ربات تلگرام

چطور در BotFather ربات بسازیم

1. @BotFather را باز کنید و Start را بزنید.
2. دستور /newbot را بفرستید.
3. نام ربات را وارد کنید — نامی که نمایش داده می‌شود.
4. نام کاربری را وارد کنید — نشانی ربات، مثل @my_shop_bot. باید 5 تا 32 نویسه باشد، فقط حروف لاتین، رقم و زیرخط، و به bot ختم شود.
5. BotFather توکن را برایتان می‌فرستد. حالا ربات وجود دارد.

توکن: چیست و چطور امنش نگه داریم

توکن شبیه رقم و حرف‌هایی است که با دونقطه جدا شده‌اند. هر کس آن را داشته باشد ربات را کاملاً در اختیار دارد، به همین دلیل توصیهٔ تلگرام این است که آن را جای امنی نگه دارید و فقط با کسانی در میان بگذارید که به دسترسی مستقیم نیاز دارند.

• توکن را هرگز در کد عمومی، GitHub یا چت‌ها نگذارید.
• اگر لو رفت، مستندات تلگرام دستور /token در BotFather را برای ساخت توکن جدید نام می‌برد. بعد آن را در همهٔ جاهایی که برنامه‌تان استفاده می‌کند به‌روز کنید.
• توکن فقط برای ربات‌هاست. api_id و api_hash کلیدهای دیگری‌اند، برای برنامه‌هایی که به‌عنوان کاربر وارد می‌شوند: چطور بگیریمشان.

در BotFather چه چیزهایی را تنظیم کنیم

/mybots منوی تعاملی تنظیمات ربات‌هایتان را باز می‌کند؛ همین در مینی‌اپ BotFather هم هست. ظاهر ربات را با دستورهای جداگانه هم می‌شود تعیین کرد:

• /setname — نام ربات.
• /setdescription — توضیح ربات، متنی کوتاه تا 512 نویسه.
• /setabouttext — اطلاعات «دربارهٔ ربات» (About)، متنی کوتاه‌تر تا 120 نویسه.
• /setuserpic — تصویر پروفایل ربات.
• /setcommands — فهرست دستورها؛ وقتی کسی / را تایپ کند تلگرام آن‌ها را پیشنهاد می‌دهد.
• /setjoingroups — اینکه ربات را بشود به گروه‌ها اضافه کرد یا نه.
• /setprivacy — اینکه ربات در گروه‌ها کدام پیام‌ها را دریافت کند.
• /deletebot — حذف ربات و آزادکردن نام کاربری‌اش.

چطور ربات را به جواب‌دادن وادار کنیم

ربات برنامه‌ای است که از طریق Bot API با تلگرام حرف می‌زند. هر درخواست به https://api.telegram.org/bot<token>/METHOD می‌رود. برای دریافت پیام‌ها دو راه هست و با هم سازگار نیستند:

• getUpdates (long polling): برنامهٔ شما پیام‌های تازه را از تلگرام می‌پرسد. ساده‌ترین شروع است — نشانی عمومی لازم ندارید.
• Webhook: تلگرام پیام‌ها را به سرور شما می‌فرستد. HTTPS و یکی از پورت‌های 443، 80، 88 یا 8443 لازم است.

کد را می‌توانید به هر زبانی که درخواست HTTP بزند بنویسید. کتابخانه‌های محبوب: aiogram و python-telegram-bot برای Python، و grammY و Telegraf برای JavaScript. آموزش رسمی یک ربات جاوا را قدم‌به‌قدم می‌رود: از BotFather تا «Hello World». ربات را می‌توانید تا وقتی روشن است روی کامپیوتر خودتان اجرا کنید، یا روی VPS تا شبانه‌روز کار کند.

دکمه‌ها و دستورها در ربات

• دستورها کلماتی مثل /start هستند که ربات پردازششان می‌کند؛ فهرست راهنما با /setcommands تعیین می‌شود.
• دکمه‌های درون‌خطی زیر پیام متنی به چت نمی‌فرستند: فشاردادن را به ربات می‌فرستند یا پیوندی را باز می‌کنند.
• کیبوردهای پاسخ به‌جای کیبورد معمولی جواب‌های آماده نشان می‌دهند.
• مینی‌اپ‌ها رابط‌های کاملی‌اند که داخل تلگرام باز می‌شوند.

بیشتر در مرور امکانات ربات.

پرداخت در ربات

کالاها و خدمات دیجیتال در ربات‌ها با Telegram Stars پرداخت می‌شوند: صورت‌حساب با ارز XTR صادر می‌شود و ارائه‌دهندهٔ پرداخت لازم نیست. راه‌اندازی آن در پذیرش Stars در ربات شما آمده است؛ ستاره‌هایی که ربات جمع کرده از طریق Fragment برداشت می‌شود — چطور از ربات ستاره برداشت کنیم.

پرسش‌های رایج