استارد / وبلاگ
وبلاگ

تغییرات Bot API تلگرام در ۲۰۲۶: از Guest Mode تا Ephemeral Messages

سال ۲۰۲۶ پرتغییرترین سال ربات‌های تلگرام بوده است: هفت نسخه‌ی Bot API فقط بین فوریه و اوت. اگر ربات یا فروشگاه تلگرامی داری، یا با مستندات Stard API ربات خودت را ساخته‌ای، این تایم‌لاین می‌گوید هر نسخه چه آورد و کدام تغییرها واقعاً روی کاربر و فروش اثر دارند.

پاسخ کوتاه

از فوریه تا اوت ۲۰۲۶، Bot API از نسخه‌ی ۹.۴ به ۱۰.۳ رسید. مهم‌ترین‌ها: ربات‌هایی که ربات می‌سازند (Managed Bots، نسخه‌ی ۹.۶)، Guest Mode برای جواب دادن در چتی که ربات عضوش نیست (۱۰.۰)، پیام غنی با جدول و لیست (۱۰.۱)، پیام‌های Ephemeral که در گروه فقط یک نفر می‌بیند (۱۰.۲) و دکمه‌ی داخل پیام (۱۰.۳). در کنار این‌ها، Telegram Serverless هم از تابستان اجرای ربات بدون سرور را ممکن کرد.

آخرین به‌روزرسانی:

۰۱در ۲۰۲۶ چه نسخه‌هایی از 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 را جای پیام اصلی نشان دهد. مستندات تأکید می‌کند تحویل این پیام‌ها تضمینی نیست، به‌خصوص وقتی کاربر آفلاین است. تلگرام برای کاربردش خوشامدگویی، خلاصه‌ی خصوصی، پیام خطا، تأیید و منوی دکمه‌ای را مثال زده است؛ یعنی گروه از پیام‌هایی که به کار بقیه نمی‌آید خلوت می‌ماند.

۰۶این تغییرات برای کاربران و فروشگاه‌های تلگرامی چه معنایی دارد؟

اگر می‌خواهی بدون مدیریت سرور ربات بسازی، 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 ربات می‌سازد؟

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

رباتت را به استارد وصل کن

با Stard API استارز، پریمیوم و گیفت را خودکار در ربات خودت بفروش.

ورود به ربات استارد