۰۱در ۲۰۲۶ چه نسخههایی از Bot API منتشر شد؟
| تاریخ | نسخه | مهمترین تغییر |
|---|---|---|
| ۹ فوریه ۲۰۲۶ (۲۰ بهمن ۱۴۰۴) | ۹.۴ | رنگ و آیکون برای دکمهها، ایموجی سفارشی برای رباتهایی که صاحبشان پریمیوم دارد، ساخت تاپیک در چت خصوصی |
| ۱ مارس ۲۰۲۶ (۱۰ اسفند ۱۴۰۴) | ۹.۵ | sendMessageDraft برای همهی رباتها، موجودیت تاریخ و ساعت (date_time)، برچسب اعضا |
| ۳ آوریل ۲۰۲۶ (۱۴ فروردین ۱۴۰۵) | ۹.۶ | Managed Bots، کوییز با چند جواب درست و گزینههای تازهی نظرسنجی |
| ۸ مه ۲۰۲۶ (۱۸ اردیبهشت ۱۴۰۵) | ۱۰.۰ | Guest Mode، گفتوگوی ربات با ربات، عکس زنده (Live Photo)، ربات بیزینس بدون نیاز به پریمیوم |
| ۱۱ ژوئن ۲۰۲۶ (۲۱ خرداد ۱۴۰۵) | ۱۰.۱ | پیام غنی (sendRichMessage) و پاسخ ربات به درخواست عضویت (Join Request Queries) |
| ۱۴ ژوئیه ۲۰۲۶ (۲۳ تیر ۱۴۰۵) | ۱۰.۲ | بلوکهای پیام غنی، پیام Ephemeral، کامیونیتیها، بهروزرسانی اشتراک پرداخت |
| ۲۴ اوت ۲۰۲۶ (۲ شهریور ۱۴۰۵) | ۱۰.۳ | دکمه داخل پیام غنی، جدول فشرده، EphemeralMessageParameters، دکمهی غیرفعال (DisabledButton) |
۰۲Managed Bots چیست و چه کسی به آن نیاز دارد؟
از Bot API ۹.۶ (۳ آوریل ۲۰۲۶) یک ربات میتواند از طرف کاربر ربات تازه بسازد و مدیریتش کند. فیلد can_manage_bots، دکمهی KeyboardButtonRequestManagedBot و متدهای getManagedBotToken و replaceManagedBotToken برای همین اضافه شدند.
تلگرام در وبلاگ ۳۱ مارس گفت با این قابلیت هر کسی میتواند «با چند لمس» و بدون کدنویسی ربات شخصی خودش را بسازد. برای کاربر عادی یعنی ساخت ربات سادهتر میشود؛ برای پلتفرمهایی که به مشتریهایشان ربات آماده میدهند، یعنی ساخت و تحویل ربات میتواند داخل خود ربات پلتفرم انجام شود.
۰۳Guest Mode چیست و ربات در آن چه چیزی را میبیند؟
Guest Mode در Bot API ۱۰.۰ (۸ مه ۲۰۲۶) آمد. کاربر در هر چت خصوصی یا گروهی یوزرنیم ربات را منشن میکند و ربات در همان چت جواب میدهد، حتی اگر عضوش نباشد. طبق وبلاگ تلگرام، ربات فقط پیامی را که در آن تگ شده و پاسخهای همان پیام را میبیند و فهرست اعضای چت را نمیبیند.
از نظر فنی، پیام مهمان با آپدیت guest_message میرسد و ربات با متد answerGuestQuery و شناسهی guest_query_id جواب میدهد. برای کاربر یعنی بدون اضافه کردن ربات به گروه میشود از آن کمک گرفت؛ برای فروشگاه یعنی ربات میتواند در گفتوگوهای بیشتری حاضر باشد، بیآنکه به همهی پیامهای گروه دسترسی بگیرد.
۰۴پیام غنی و دکمهی داخل پیام چه چیزی را عوض کردند؟
از ۱۰.۱ رباتها پیامی با تیتر، لیست، جدول، نقلقول و فرمول میفرستند و از ۱۰.۳ تا ۸ دکمه را در یک ردیف وسط همان پیام میگذارند. یعنی جدول قیمت، فاکتور یا راهنمای چندمرحلهای در یک پیام مرتب جا میشود. جزئیات فنی و نمونهی JSON را در راهنمای پیامهای غنی در رباتهای تلگرام نوشتهایم.
یک تجربهی واقعی: کتابخانهها همیشه همزمان با تلگرام بهروز نمیشوند. ربات استارد وقتی جدول قیمت را اضافه کرد، کتابخانهاش هنوز متد sendRichMessage را نداشت و درخواست را مستقیم و خام به Bot API فرستاد. پیش از برنامهریزی برای یک قابلیت تازه، پشتیبانی کتابخانهات را چک کن.
۰۵Ephemeral Messages چیست و چه کاربردی دارد؟
پیام Ephemeral در Bot API ۱۰.۲ (۱۴ ژوئیه ۲۰۲۶) معرفی شد: پیامی در گروه که فقط یک کاربر مشخص و خود ربات آن را میبینند. دستورهایی که جوابشان اینطور است، در منوی ربات با فیلد is_ephemeral علامت میخورند و برای ویرایش و حذف این پیامها متدهای جدا (مثل editEphemeralMessageText و deleteEphemeralMessage) آمده است.
در ۱۰.۳ پارامترها در شیء EphemeralMessageParameters جمع شدند و با replace_callback_query_message ربات میتواند پیام Ephemeral را جای پیام اصلی نشان دهد. مستندات تأکید میکند تحویل این پیامها تضمینی نیست، بهخصوص وقتی کاربر آفلاین است. تلگرام برای کاربردش خوشامدگویی، خلاصهی خصوصی، پیام خطا، تأیید و منوی دکمهای را مثال زده است؛ یعنی گروه از پیامهایی که به کار بقیه نمیآید خلوت میماند.
۰۶این تغییرات برای کاربران و فروشگاههای تلگرامی چه معنایی دارد؟
- گروههای خلوتتر: جوابهای شخصی (مثل «سفارشت ثبت شد») میتوانند Ephemeral باشند و به چشم همه نرسند.
- پیام خواناتر: قیمت و فاکتور به شکل جدول و با دکمه در یک پیام میآید.
- امنیت مینیاپ: از ۱۰.۲، متدهای مینیاپ به دامنهی اصلی همان مینیاپ محدود شدند و این محافظت از ۲۰ ژوئیهی ۲۰۲۶ خودکار فعال شد (غیرفعال کردنش از BotFather ممکن است). اگر مینیاپ تو از چند دامنه کار میکند، آن را بررسی کن.
- هشدار امنیتی ثابت: هیچکدام از این قابلیتها دلیل نمیشود رباتی در گروه کد ورود، رمز یا اطلاعات کارت تو را بخواهد. پیام Ephemeral هم پیام خصوصی امن جای پرداخت نیست.
اگر میخواهی بدون مدیریت سرور ربات بسازی، Telegram Serverless را ببین؛ اگر ربات فروش آماده میخواهی، ربات فروشگاهی استارد متنباز است.
منابع رسمی: Bot API changelog · Telegram Bot API · Telegram Blog، ۷ مه ۲۰۲۶ · Telegram Blog، ۱۴ ژوئیه ۲۰۲۶ · Telegram Blog، ۳۱ مارس ۲۰۲۶
۰۷سوالات متداول
آخرین نسخهی Bot API کدام است؟
تا زمان نوشتن این مطلب (آبان ۱۴۰۵)، Bot API ۱۰.۳ که ۲۴ اوت ۲۰۲۶ منتشر شد. برای نسخههای بعدی صفحهی رسمی changelog را ببین.
در Guest Mode ربات پیامهای گروه را میخواند؟
نه. ربات فقط پیامی را که در آن منشن شده و پاسخهای همان پیام را میبیند و فهرست اعضا را هم نمیبیند.
پیام Ephemeral را بقیهی اعضای گروه میبینند؟
نه؛ فقط کاربر گیرنده و خود ربات آن را میبینند، و تحویلش هم تضمینی نیست.
برای استفاده از قابلیتهای تازه باید کتابخانهی ربات را بهروز کنم؟
معمولاً بله؛ اگر کتابخانه هنوز متد تازه را ندارد، میتوانی درخواست را مستقیم به Bot API بفرستی.
Managed Bots یعنی هر کسی بدون BotFather ربات میسازد؟
یعنی یک ربات میتواند از طرف کاربر ربات تازه بسازد و توکنش را مدیریت کند. طبق وبلاگ تلگرام، کاربر با چند لمس و بدون کدنویسی به ربات شخصی میرسد.