تغییرات Telegram Bot API
همه تغییرات Telegram Bot API از نسخه 9.0 (آوریل 2025) تا نسخه فعلی Bot API 10.5 (۱ آذر ۱۴۰۵)، از جدیدترین به قدیمیترین. نام متدها به مرجع ما با پارامترها و مثالها لینک شدهاند و نام کلاسها به مستندات رسمی.
Bot API 10.5 آخرین
متدهای جدید: setMySettings
تنظیمات ربات
- متد setMySettings اضافه شد که به رباتها امکان میدهد تنظیمات خود را تغییر دهند؛ از جمله تنظیمات حالت اینلاین، حالت حریم خصوصی، امکان افزوده شدن به گروهها، حالت تاپیک انجمن در چتهای خصوصی و حالت دریافت کوئریهای callback.
- امکان دریافت کوئریهای callback از دکمههای پیامهای ارسالی ربات با فیلد inline_message_id بهجای فیلد message در کلاس CallbackQuery اضافه شد؛ این رفتار به پارامتر callback_query_mode متد setMySettings بستگی دارد.
- رباتها اکنون میتوانند با پارامتر has_topic_sidebar متد setMySettings فهرست تاپیکها را در نوار کناری چتهای خصوصی با ربات نمایش دهند.
- کلاس BotFullInfo از کلاس User جدا شد و نوع خروجی متد getMe به BotFullInfo تغییر کرد. فیلدهایی که فقط در getMe برگردانده میشدند از کلاس User حذف شدند.
- فیلد active_usernames به کلاس BotFullInfo اضافه شد تا ربات بتواند فهرست همه نامهای کاربری فعال خود را دریافت کند.
- فیلد inline_query_placeholder به کلاس BotFullInfo اضافه شد تا ربات بتواند متن placeholder خود برای کوئریهای اینلاین را دریافت کند.
- فیلد needs_inline_query_location به کلاس BotFullInfo اضافه شد تا ربات بتواند بررسی کند که آیا با هر کوئری اینلاین، موقعیت مکانی کاربر را درخواست میکند یا نه.
- فیلد has_topic_sidebar به کلاس BotFullInfo اضافه شد تا ربات بتواند بررسی کند که آیا تاپیکهای چتهای خصوصی با ربات در نوار کناری نمایش داده میشوند یا نه.
عمومی
- مالکان ربات اکنون میتوانند با زدن لینک
https://t.me/botinvite/<bot_username>تا 10 کاربر را بهطور همزمان به چت خصوصی با ربات دعوت کنند. ربات میتواند به کاربران دعوتشده پیام ارسال کند. - فیلد inviter به کلاس WriteAccessAllowed اضافه شد؛ برای پیامهای سرویسی درباره کاربرانی که مالک ربات آنها را به چت خصوصی با ربات دعوت کرده است.
- در کلاسهای RichBlockExpandableBlockQuotation و InputRichBlockExpandableBlockQuotation فیلد text با فیلد blocks جایگزین شد تا نقلقولهای بلوکی بازشونده بتوانند هر نوع بلوکی را در خود داشته باشند.
Bot API 10.4
متدهای جدید: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
ویجتها
- کلاس Widget و فیلد widget به کلاسهای Message و ExternalReplyInfo اضافه شد؛ برای پیامهای حاوی ویجتهای HTML.
- متد sendWidget اضافه شد که به رباتها امکان ارسال پیامهای حاوی ویجت HTML را میدهد. فعلاً در محیط production ویجتها فقط به چتهای خصوصی ارسال میشوند و ویجتهای ارسالشده خودکار محتوای محافظتشده دارند و در نتیجه قابل فوروارد نیستند.
- متد sendSharedWidget اضافه شد که به رباتها امکان میدهد ویجتهای اشتراکی ساختهشده توسط خود را دوباره ارسال کنند.
- کلاس WidgetQuery و فیلد widget_query به کلاس Update اضافه شد؛ برای کوئریهایی که ویجتها در پیامهای ارسالشده توسط ربات یا از طریق ربات به آن میفرستند.
- کلاس SharedWidgetQuery و فیلد shared_widget_query به کلاس Update اضافه شد؛ برای کوئریهایی که از پیامهای فورواردشده حاوی ویجت اشتراکی به ربات ارسال میشوند.
- کلاسهای WidgetQueryType، WidgetQueryTypeData، WidgetQueryTypeSignData، WidgetQueryTypeSentTransaction و WidgetQueryWallet اضافه شدند که نوع کوئری ارسالی از ویجت را توصیف میکنند. یک کوئری میتواند شامل داده برای ربات همراه با کارت کیف پول TON کاربر، دادهای امضاشده با کیف پول TON کاربر یا اعلانی درباره تراکنش ارسالشده از کیف پول TON کاربر باشد.
- متد answerWidgetQuery اضافه شد که به رباتها امکان پاسخ به کوئریهای ویجت را میدهد.
- متد editMessageWidgetData اضافه شد که به رباتها امکان تغییر دادههای ویجت در یک پیام را میدهد.
- متد editSharedWidgetData اضافه شد که به رباتها امکان تغییر دادههای عمومی یک ویجت اشتراکی را میدهد.
- کلاسهای InputWidgetMessageContent و InputSharedWidgetMessageContent اضافه شدند که به رباتها امکان ارسال ویجت در پاسخ به کوئریهای اینلاین را میدهند. فعلاً در محیط production نمیتوان ویجت را در پاسخ به کوئریهای اینلاین ارسال کرد.
- پیامهای ویجت را نمیتوان با متدهای copyMessage و copyMessages کپی کرد.
- مجوز can_send_other_messages در کلاسهای ChatPermissions و ChatMemberRestricted اکنون ارسال ویجت را هم مجاز میکند.
پیامهای موقت
- رباتها اکنون میتوانند در هر چتی بهجز چتهای پیام مستقیم کانال، به کوئریهای callback پاسخ موقت بدهند؛ کافی است در پارامتر ephemeral_message_parameters مقدار callback_query_id را بدون receiver_user_id مشخص کنند. این امکان در متدهای sendMessage، sendRichMessage، sendAnimation، sendAudio، sendContact، sendDocument، sendLivePhoto، sendLocation، sendPhoto، sendSticker، sendVenue، sendVideo، sendVideoNote و sendVoice وجود دارد.
- فیلد receiver_user_id در کلاس EphemeralMessageParameters و پارامتر chat_id در متدهای یادشده اکنون اختیاری هستند.
نقلقول از پیامهای غنی
- فیلد rich_texts به کلاس TextQuote اضافه شد؛ برای نقلقولهایی که از یک RichMessage انتخاب شدهاند.
- فیلد quote_rich_texts به کلاس ReplyParameters اضافه شد تا رباتها بتوانند از پیامهای غنی نقلقول کنند.
کیف پول TON
- کلاسهای TonWalletCard، TonWalletCardSticker، TonNft و TonNftAttribute و همچنین فیلد ton_wallet_card به کلاس ChatFullInfo اضافه شدند.
- کلاس TonWalletTransfer و فیلد ton_wallet_transfer به کلاس Message اضافه شد؛ برای پیامهای سرویسی درباره انتقال با کیف پول TON.
- کلاس StoryAreaPosition به AreaPosition تغییر نام داد، چون اکنون برای توصیف موقعیت استیکرها روی کارتهای کیف پول TON هم استفاده میشود.
تمهای اشتراکگذاری چت
- کلاسهای ChatShareTheme، ChatShareThemeEmoji و ChatShareThemeUniqueGift و همچنین فیلد share_theme به کلاس ChatFullInfo اضافه شدند که تم صفحه اشتراکگذاری لینک یک کاربر یا چت را توصیف میکنند.
- کلاسهای EmojiType، EmojiTypeEmoji و EmojiTypeCustomEmoji اضافه شدند.
- کلاسهای ChatShareThemeBackdrop و ChatShareThemeBackdrops و متد getChatShareThemeBackdrops اضافه شدند.
هدیهها
- متد getUniqueGift اضافه شد که به رباتها امکان میدهد اطلاعات یک هدیه منحصربهفرد را با نام آن دریافت کنند.
- متد deleteBusinessAccountGift اضافه شد که به رباتها امکان میدهد هدیههای معمولی متعلق به حساب تجاری مدیریتشده را بدون دریافت Telegram Stars حذف کنند.
عمومی
- کاربران دارای اشتراک Telegram Premium اکنون میتوانند برای حداکثر 2 ربات متعلق به خود، نامهای کاربری ثانویهای با پایان “agent”، “ai”، “app”، “game” یا “gay” تعیین کنند. چنین نامهای کاربری را میتوان در فیلد suggested_username کلاس KeyboardButtonRequestManagedBot پیشنهاد داد.
- کلاس RichTextTonAddress اضافه شد که یک آدرس بلاکچین TON را در RichMessage نشان میدهد.
- نوع “ton_address” برای آدرسهای بلاکچین TON به کلاس MessageEntity اضافه شد.
- نوع “bank_card_number” برای شماره کارتهای بانکی به کلاس MessageEntity اضافه شد.
- پارامترهای custom_description_parse_mode و custom_description_entities به متدهای verifyUser و verifyChat اضافه شدند.
- کلاس PaidMessagesWaived و فیلد paid_messages_waived به کلاس Message اضافه شد؛ برای پیامهای سرویسی درباره استفاده فرستنده از لینکی که ارسال پیام بدون پرداخت Telegram Stars را ممکن میکند.
- امکان ساخت لینک به تاپیکهای چت خصوصی با ربات در قالب
https://t.me/<bot_username>/<message_thread_id>اضافه شد. چنین لینکی تاپیک را فقط برای کاربری باز میکند که تاپیک در چت خصوصی با او وجود دارد.
Bot API 10.3
پیامهای غنی
- کلاس RichMessageButton اضافه شد که یک دکمه را در RichMessage نشان میدهد.
- کلاس RichTextButton اضافه شد.
- کلاسهای RichBlockButtons و InputRichBlockButtons اضافه شدند.
- فیلد is_compact به کلاسهای RichBlockTable و InputRichBlockTable اضافه شد.
- کلاسهای RichBlockExpandableBlockQuotation و InputRichBlockExpandableBlockQuotation اضافه شدند که یک نقلقول بلوکی قابل باز و بسته شدن را نشان میدهند.
- کلاسهای RichBlockDocument و InputRichBlockDocument اضافه شدند که حاوی یک فایل هستند.
- پشتیبانی از لینکهایی به شکل
tg://document?id=برای آپلود فایلهای عمومی در پیامهای غنی اضافه شد.
پیامهای موقت
- کلاس EphemeralMessageParameters اضافه شد و پارامترهای receiver_user_id و callback_query_id در متدهای sendMessage، sendAnimation، sendAudio، sendDocument، sendLivePhoto، sendPhoto، sendSticker، sendVideo، sendVideoNote، sendVoice، sendContact، sendLocation و sendVenue با پارامتر ephemeral_message_parameters جایگزین شدند.
- پارامتر ephemeral_message_parameters به متد sendRichMessage اضافه شد.
- فیلد replace_callback_query_message به کلاس EphemeralMessageParameters اضافه شد که به رباتها امکان میدهد پیام موقت را بهجای پیام اصلی نمایش دهند.
- آپلود فایلهای جدید در editEphemeralMessageMedia پشتیبانی میشود.
- پارامتر show_caption_above_media به متد editEphemeralMessageCaption اضافه شد.
- پارامتر rich_message به متد editEphemeralMessageText اضافه شد.
- فیلد can_send_welcome_messages به کلاسهای ChatAdministratorRights و ChatMemberAdministrator اضافه شد.
- پارامتر can_send_welcome_messages به متد promoteChatMember اضافه شد.
کیبورد پاسخ
- کلاس DisabledButton و فیلد disabled به کلاس InlineKeyboardButton اضافه شد.
- فیلد force_reply به کلاسهای InlineKeyboardMarkup و ReplyKeyboardMarkup اضافه شد.
عمومی
- پارامترهای can_stop و keep_on_stop به متدهای sendMessageDraft و sendRichMessageDraft اضافه شدند.
- آپدیتهایی درباره توقف تولید پیام توسط کاربر اضافه شد که با کلاس MessageGenerationStopped و فیلد stopped_message_generation در کلاس Update نمایش داده میشوند.
- کلاس CommunityChatJoined و فیلد community_chat_joined به کلاس Message اضافه شد؛ برای پیامهای سرویسی درباره پیوستن یک چت از کامیونیتی.
- فیلدهای text، entities و is_private به کلاس UniqueGiftInfo اضافه شدند.
Bot API 10.2
متدهای جدید: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
پیامهای غنی
- کلاس InputRichMessageMedia و فیلد media به کلاس InputRichMessage اضافه شد تا رباتها هنگام ارسال پیام غنی بتوانند مدیای استفادهشده در قالببندی markdown یا html را صریحاً مشخص کنند.
- کلاس InputMediaVoiceNote اضافه شد که یک پیام صوتی برای ارسال را نشان میدهد.
- کلاس InputRichBlockListItem اضافه شد که یک آیتم از فهرست برای ارسال را نشان میدهد.
- کلاسهای InputRichBlockParagraph، InputRichBlockSectionHeading، InputRichBlockPreformatted، InputRichBlockFooter، InputRichBlockDivider، InputRichBlockMathematicalExpression، InputRichBlockAnchor، InputRichBlockList، InputRichBlockBlockQuotation، InputRichBlockPullQuotation، InputRichBlockCollage، InputRichBlockSlideshow، InputRichBlockTable، InputRichBlockDetails، InputRichBlockMap، InputRichBlockAnimation، InputRichBlockAudio، InputRichBlockPhoto، InputRichBlockVideo، InputRichBlockVoiceNote و InputRichBlockThinking اضافه شدند که انواع مختلف بلوکهای موجود برای قالببندی یک پیام غنی خروجی را نشان میدهند.
- فیلد blocks به کلاس InputRichMessage اضافه شد تا رباتها بتوانند قالببندی پیام غنی را با موجودیتهای بلوکی مشخص کنند.
پیامهای موقت
- پشتیبانی از پیامهای موقت اضافه شد که به رباتها امکان میدهد در گروه پیامهایی ارسال کنند و دستورهایی دریافت کنند که فقط برای یک کاربر مشخص و ربات قابل مشاهدهاند.
- فیلد is_ephemeral به کلاس BotCommand اضافه شد.
- فیلد receiver_user به کلاس Message اضافه شد.
- فیلد ephemeral_message_id به کلاس Message اضافه شد.
- پارامترهای receiver_user_id و callback_query_id به متدهای sendMessage، sendAnimation، sendAudio، sendDocument، sendLivePhoto، sendPhoto، sendSticker، sendVideo، sendVideoNote، sendVoice، sendContact، sendLocation و sendVenue اضافه شدند.
- فیلد ephemeral_message_id به کلاس ReplyParameters اضافه شد تا رباتها بتوانند به پیامهای موقت پاسخ دهند.
- فیلد message_id در کلاس ReplyParameters در صورت وجود فیلد ephemeral_message_id اختیاری شد.
- متدهای editEphemeralMessageText، editEphemeralMessageMedia، editEphemeralMessageCaption و editEphemeralMessageReplyMarkup اضافه شدند که به رباتها امکان ویرایش پیامهای موقت را میدهند.
- متد deleteEphemeralMessage اضافه شد که به رباتها امکان حذف پیامهای موقت را میدهد.
کامیونیتیها
- پشتیبانی اولیه از کامیونیتیها اضافه شد: چند سوپرگروه، کانال و ربات که حول یک موضوع یا مخاطب مشترک به هم پیوند خوردهاند.
- کلاس Community اضافه شد که یک کامیونیتی را نشان میدهد.
- کلاس CommunityChatAdded و فیلد community_chat_added به کلاس Message اضافه شد.
- کلاس CommunityChatRemoved و فیلد community_chat_removed به کلاس Message اضافه شد.
- فیلد community به کلاس ChatFullInfo اضافه شد.
عمومی
- آپدیتهایی درباره تغییرات اشتراک پرداختی کاربر اضافه شد که با کلاس BotSubscriptionUpdated و فیلد subscription در کلاس Update نمایش داده میشوند.
- امنیت Mini Appها تقویت شد: استفاده از متدهای Mini App از originهایی غیر از دامنه اصلی Mini App مجاز نیست. این محافظت در 20 جولای 2026 بهطور خودکار برای همه Mini Appها فعال میشود. میتوانید از طریق Mini App ربات @BotFather آن را غیرفعال کنید. در این صورت میپذیرید که مسئولیت اطمینان از نبودِ لینک به سایتهای غیرقابلاعتماد در Mini App بر عهده ربات است.
Bot API 10.1
متدهای جدید: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
پیامهای غنی
- پشتیبانی از پیامهای غنی اضافه شد که به رباتها امکان میدهد متن بسیار ساختاریافته ارسال کنند و پاسخهای تولیدشده با AI را با قالببندی غنی و یکپارچه بهصورت استریم بفرستند.
- کلاسهای RichTextBold، RichTextItalic، RichTextUnderline، RichTextStrikethrough، RichTextSpoiler، RichTextDateTime، RichTextTextMention، RichTextSubscript، RichTextSuperscript، RichTextMarked، RichTextCode، RichTextCustomEmoji، RichTextMathematicalExpression، RichTextUrl، RichTextEmailAddress، RichTextPhoneNumber، RichTextBankCardNumber، RichTextMention، RichTextHashtag، RichTextCashtag، RichTextBotCommand، RichTextAnchor، RichTextAnchorLink، RichTextReference و RichTextReferenceLink اضافه شدند که انواع مختلف متن با قالببندی غنی را نشان میدهند.
- کلاس RichText اضافه شد که متن با قالببندی غنی را نشان میدهد.
- کلاس RichBlockCaption اضافه شد که کپشن یک متن با قالببندی غنی را نشان میدهد.
- کلاس RichBlockTableCell اضافه شد که یک خانه از جدول را نشان میدهد.
- کلاس RichBlockListItem اضافه شد که یک آیتم از فهرست را نشان میدهد.
- کلاسهای RichBlockParagraph، RichBlockSectionHeading، RichBlockPreformatted، RichBlockFooter، RichBlockDivider، RichBlockMathematicalExpression، RichBlockAnchor، RichBlockList، RichBlockBlockQuotation، RichBlockPullQuotation، RichBlockCollage، RichBlockSlideshow، RichBlockTable، RichBlockDetails، RichBlockMap، RichBlockAnimation، RichBlockAudio، RichBlockPhoto، RichBlockVideo، RichBlockVoiceNote و RichBlockThinking اضافه شدند که انواع مختلف بلوکها در یک پیام با قالببندی غنی را نشان میدهند.
- کلاس RichBlock اضافه شد که یک بلوک در پیام با قالببندی غنی را نشان میدهد.
- کلاس RichMessage اضافه شد که یک پیام با قالببندی غنی را نشان میدهد.
- فیلد rich_message به کلاس Message اضافه شد.
- کلاس InputRichMessage اضافه شد که یک پیام غنی برای ارسال را توصیف میکند.
- کلاس InputRichMessageContent اضافه شد و استفاده از آن بهعنوان InputMessageContent در نتایج کوئریهای اینلاین، مهمان و Web App مجاز شد.
- متد sendRichMessage اضافه شد که به رباتها امکان ارسال پیامهای غنی را میدهد.
- متد sendRichMessageDraft اضافه شد که به رباتها امکان استریم بخشبهبخش پیامهای غنی را میدهد.
- پارامتر rich_message به متد editMessageText اضافه شد تا رباتها بتوانند پیامهای غنی را ویرایش کنند.
کوئریهای درخواست عضویت
- فیلد supports_join_request_queries به کلاس User اضافه شد.
- فیلد guard_bot به کلاس ChatFullInfo اضافه شد.
- فیلد query_id به کلاس ChatJoinRequest اضافه شد.
- متد answerChatJoinRequestQuery اضافه شد.
- متد sendChatJoinRequestWebApp اضافه شد.
نظرسنجیها
- کلاس Link و فیلد link به کلاس PollMedia اضافه شد.
- کلاس InputMediaLink اضافه شد و استفاده از آن بهعنوان InputPollOptionMedia مجاز شد.
Bot API 10.0
متدهای جدید: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
حالت مهمان
- پشتیبانی از حالت مهمان اضافه شد که به رباتها امکان میدهد در چتهایی که عضوشان نیستند برخی پیامها را دریافت کنند و پاسخ بدهند.
- فیلد supports_guest_queries به کلاس User اضافه شد.
- فیلدهای guest_bot_caller_user و guest_bot_caller_chat به کلاس Message اضافه شدند.
- فیلد guest_query_id به کلاس Message اضافه شد.
- فیلد guest_message به کلاس Update اضافه شد.
- کلاس SentGuestMessage و متد answerGuestQuery اضافه شدند.
مدیریت چت
- فیلد can_react_to_messages به کلاسهای ChatMemberRestricted و ChatPermissions اضافه شد.
- پارامتر return_bots به متد getChatAdministrators اضافه شد.
- متد deleteAllMessageReactions اضافه شد.
- متد deleteMessageReaction اضافه شد.
- امکان دیدن برخی پیامهای ارسالشده توسط رباتهای دیگر در گروهها اضافه شد.
نظرسنجیها
- کلاسهای InputMediaSticker، InputMediaLocation و InputMediaVenue اضافه شدند.
- کلاس PollMedia اضافه شد که مدیای یک نظرسنجی را نشان میدهد.
- فیلد media به کلاس Poll اضافه شد تا رباتها بتوانند مدیای نظرسنجیها را ببینند.
- فیلد explanation_media به کلاس Poll اضافه شد تا رباتها بتوانند مدیای توضیحات کوییز را ببینند.
- فیلد media به کلاس PollOption اضافه شد تا رباتها بتوانند مدیای گزینههای نظرسنجی را ببینند.
- کلاس InputPollMedia و پارامترهای media و explanation_media به متد sendPoll اضافه شدند تا رباتها بتوانند به نظرسنجیها مدیا اضافه کنند.
- کلاس InputPollOptionMedia و فیلد media به کلاس InputPollOption اضافه شد تا رباتها بتوانند به گزینههای نظرسنجی مدیا اضافه کنند.
- فیلد members_only به کلاس Poll اضافه شد.
- پارامتر members_only به متد sendPoll اضافه شد.
- فیلد country_codes به کلاس Poll اضافه شد.
- پارامتر country_codes به متد sendPoll اضافه شد.
- حداقل تعداد گزینههای نظرسنجی از 2 به 1 کاهش یافت.
عکسهای زنده
- کلاس LivePhoto اضافه شد که عکسی همراه با یک ویدیوی کوتاه را نشان میدهد.
- کلاس InputMediaLivePhoto اضافه شد.
- فیلد live_photo به کلاسهای Message و ExternalReplyInfo اضافه شد.
- متد sendLivePhoto اضافه شد که به رباتها امکان ارسال عکس زنده را میدهد.
- کلاس PaidMediaLivePhoto اضافه شد که یک مدیای پولی حاوی عکس زنده را توصیف میکند.
- کلاس InputPaidMediaLivePhoto اضافه شد که به رباتها امکان ارسال عکس زنده بهعنوان مدیای پولی را میدهد.
- استفاده از عکس زنده در sendMediaGroup و editMessageMedia مجاز شد.
عمومی
- رباتهای تجاری اکنون میتوانند حسابهای کاربری را بدون اشتراک Telegram Premium مدیریت کنند.
- امکان ارسال پیام به رباتهای دیگر از طریق نام کاربری اضافه شد، به شرطی که هر دو ربات ارتباط رباتبهربات را فعال کرده باشند.
- امکان پاسخ دادن به رباتهای دیگر از طرف ربات تجاری اضافه شد، به شرطی که ربات تجاری ارتباط رباتبهربات را فعال کرده باشد.
- رباتها اکنون میتوانند در متد sendMessageDraft متن خالی ارسال کنند.
- کلاس BotAccessSettings و متد getManagedBotAccessSettings اضافه شدند.
- متد setManagedBotAccessSettings اضافه شد.
- متد getUserPersonalChatMessages اضافه شد.
Bot API 9.6
متدهای جدید: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
رباتهای مدیریتشده
- فیلد can_manage_bots به کلاس User اضافه شد.
- کلاس KeyboardButtonRequestManagedBot و فیلد request_managed_bot به کلاس KeyboardButton اضافه شد.
- کلاس ManagedBotCreated و فیلد managed_bot_created به کلاس Message اضافه شد.
- آپدیتهایی درباره ساخت رباتهای مدیریتشده و تغییر توکن آنها اضافه شد که با کلاس ManagedBotUpdated و فیلد managed_bot در کلاس Update نمایش داده میشوند.
- متدهای getManagedBotToken و replaceManagedBotToken اضافه شدند.
- کلاس PreparedKeyboardButton و متد savePreparedKeyboardButton اضافه شدند که به رباتها امکان میدهند از داخل Mini Appها کاربر، چت و ربات مدیریتشده درخواست کنند.
- متد requestChat به کلاس WebApp اضافه شد.
- پشتیبانی از لینکهای
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]اضافه شد که به رباتها امکان میدهد ساخت یک ربات مدیریتشده را از طریق لینک درخواست کنند.
نظرسنجیها
- پشتیبانی از کوییزهایی با چند پاسخ صحیح اضافه شد.
- در کلاس Poll فیلد correct_option_id با فیلد correct_option_ids جایگزین شد.
- در متد sendPoll پارامتر correct_option_id با پارامتر correct_option_ids جایگزین شد.
- ارسال allows_multiple_answers برای کوییزها در متد sendPoll مجاز شد.
- حداکثر زمان بسته شدن خودکار نظرسنجی به 2628000 ثانیه افزایش یافت.
- فیلد allows_revoting به کلاس Poll اضافه شد.
- پارامتر allows_revoting به متد sendPoll اضافه شد.
- پارامتر shuffle_options به متد sendPoll اضافه شد.
- پارامتر allow_adding_options به متد sendPoll اضافه شد.
- پارامتر hide_results_until_closes به متد sendPoll اضافه شد.
- فیلدهای description و description_entities به کلاس Poll اضافه شدند.
- پارامترهای description، description_parse_mode و description_entities به متد sendPoll اضافه شدند.
- فیلد persistent_id به کلاس PollOption اضافه شد که شناسه پایدار گزینه را نشان میدهد.
- فیلد option_persistent_ids به کلاس PollAnswer اضافه شد.
- فیلدهای added_by_user و added_by_chat به کلاس PollOption اضافه شدند که کاربر و چتی را که گزینه را اضافه کردهاند مشخص میکنند.
- فیلد addition_date به کلاس PollOption اضافه شد که تاریخ اضافه شدن گزینه را نشان میدهد.
- کلاس PollOptionAdded و فیلد poll_option_added به کلاس Message اضافه شد.
- کلاس PollOptionDeleted و فیلد poll_option_deleted به کلاس Message اضافه شد.
- فیلد poll_option_id به کلاس ReplyParameters اضافه شد تا رباتها بتوانند به یک گزینه مشخص از نظرسنجی پاسخ دهند.
- فیلد reply_to_poll_option_id به کلاس Message اضافه شد.
- موجودیتهای “date_time” در عنوان چکلیست، متن وظیفه چکلیست، TextQuote، نقلقول ReplyParameters، sendGift و giftPremiumSubscription مجاز شدند.
Bot API 9.5
متدهای جدید: setChatMemberTag
- نوع “date_time” به MessageEntity اضافه شد که به رباتها امکان میدهد تاریخ و زمان قالببندیشده را به کاربر نمایش دهند.
- همه رباتها اکنون میتوانند از متد sendMessageDraft استفاده کنند.
- فیلد tag به کلاسهای ChatMemberMember و ChatMemberRestricted اضافه شد.
- متد setChatMemberTag اضافه شد.
- فیلد can_edit_tag به کلاسهای ChatMemberRestricted و ChatPermissions اضافه شد.
- فیلد can_manage_tags به کلاسهای ChatMemberAdministrator و ChatAdministratorRights اضافه شد.
- پارامتر can_manage_tags به متد promoteChatMember اضافه شد.
- فیلد sender_tag به کلاس Message اضافه شد.
- فیلد iconCustomEmojiId به کلاس BottomButton اضافه شد.
Bot API 9.4
متدهای جدید: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- رباتها اکنون میتوانند در پیامهایی که مستقیماً به چتهای خصوصی، گروه و سوپرگروه ارسال میکنند از ایموجی سفارشی استفاده کنند، به شرطی که مالک ربات اشتراک Telegram Premium داشته باشد.
- رباتها اکنون میتوانند با متد createForumTopic در چتهای خصوصی تاپیک بسازند.
- رباتها اکنون میتوانند با یک تنظیم جدید در Mini App ربات @BotFather جلوی ساخت و حذف تاپیک توسط کاربران در چتهای خصوصی را بگیرند.
- فیلد allows_users_to_create_topics به کلاس User اضافه شد.
- فیلد icon_custom_emoji_id به کلاسهای KeyboardButton و InlineKeyboardButton اضافه شد تا رباتها بتوانند روی دکمهها ایموجی سفارشی نمایش دهند، به شرطی که بتوانند در پیام از ایموجی سفارشی استفاده کنند.
- فیلد style به کلاسهای KeyboardButton و InlineKeyboardButton اضافه شد تا رباتها بتوانند رنگ دکمهها را تغییر دهند.
- کلاس ChatOwnerLeft و فیلد chat_owner_left به کلاس Message اضافه شد.
- کلاس ChatOwnerChanged و فیلد chat_owner_changed به کلاس Message اضافه شد.
- متدهای setMyProfilePhoto و removeMyProfilePhoto اضافه شدند که به رباتها امکان مدیریت عکس پروفایل خود را میدهند.
- کلاس VideoQuality و فیلد qualities به کلاس Video اضافه شد تا رباتها بتوانند اطلاعات کیفیتهای دیگر موجود برای یک ویدیو را دریافت کنند.
- فیلد first_profile_audio به کلاس ChatFullInfo اضافه شد.
- کلاس UserProfileAudios و متد getUserProfileAudios اضافه شدند که به رباتها امکان دریافت فهرست فایلهای صوتی افزودهشده به پروفایل کاربر را میدهند.
- فیلد rarity به کلاس UniqueGiftModel اضافه شد.
- فیلد is_burned به کلاس UniqueGift اضافه شد.
Bot API 9.3
متدهای جدید: sendMessageDraft, getUserGifts, getChatGifts, repostStory
تاپیکها در چتهای خصوصی
- فیلد has_topics_enabled به کلاس User اضافه شد که با آن میتوان فهمید حالت تاپیک انجمن برای ربات در چتهای خصوصی فعال است یا نه.
- متد sendMessageDraft اضافه شد که امکان استریم پیامهای ناقص به کاربر در حین تولید را فراهم میکند.
- فیلدهای message_thread_id و is_topic_message در کلاس Message برای پیامهای چتهای خصوصی با حالت تاپیک انجمن فعال پشتیبانی میشوند.
- پارامتر message_thread_id در چتهای خصوصی دارای تاپیک در متدهای sendMessage، sendPhoto، sendVideo، sendAnimation، sendAudio، sendDocument، sendPaidMedia، sendSticker، sendVideoNote، sendVoice، sendLocation، sendVenue، sendContact، sendPoll، sendDice، sendInvoice، sendGame، sendMediaGroup، copyMessage، copyMessages، forwardMessage و forwardMessages پشتیبانی میشود تا رباتها بتوانند پیام را به یک تاپیک مشخص ارسال کنند.
- پارامتر message_thread_id در چتهای خصوصی در متد sendChatAction پشتیبانی میشود تا رباتها بتوانند وضعیت فعالیت چت را به یک تاپیک مشخص در چت خصوصی ارسال کنند.
- پارامتر message_thread_id در چتهای خصوصی دارای تاپیک در متدهای editForumTopic، deleteForumTopic و unpinAllForumTopicMessages پشتیبانی میشود تا رباتها بتوانند تاپیکهای چتهای خصوصی را مدیریت کنند.
- فیلد is_name_implicit به کلاسهای ForumTopic و ForumTopicCreated اضافه شد.
هدیهها
- متدهای getUserGifts و getChatGifts اضافه شدند.
- در کلاس UniqueGiftInfo فیلد last_resale_star_count با فیلدهای last_resale_currency و last_resale_amount جایگزین شد.
- در متد getBusinessAccountGifts پارامتر exclude_limited با پارامترهای exclude_limited_upgradable و exclude_limited_non_upgradable جایگزین شد.
- مقدار “gifted_upgrade” بهعنوان مقدار ممکن برای UniqueGiftInfo.origin اضافه شد؛ برای پیامهای مربوط به ارتقای هدیهای که ارتقای آن پس از ارسال خریداری شده است.
- مقدار “offer” بهعنوان مقدار ممکن برای UniqueGiftInfo.origin اضافه شد؛ برای پیامهای مربوط به خرید هدیه از طریق پیشنهاد خرید.
- فیلد gift_upgrade_sent به کلاس Message اضافه شد.
- فیلد gift_id به کلاس UniqueGift اضافه شد.
- فیلد is_from_blockchain به کلاس UniqueGift اضافه شد.
- پارامتر exclude_from_blockchain به متد getBusinessAccountGifts اضافه شد تا هدیههایی که از بلاکچین TON منتقل شدهاند فیلتر شوند.
- فیلدهای personal_total_count و personal_remaining_count به کلاس Gift اضافه شدند.
- فیلد is_premium به کلاسهای Gift و UniqueGift اضافه شد.
- فیلد is_upgrade_separate به کلاسهای GiftInfo و OwnedGiftRegular اضافه شد.
- کلاس UniqueGiftColors اضافه شد که طرح رنگی نام کاربر، پاسخ به پیامها و پیشنمایش لینکها را بر اساس یک هدیه منحصربهفرد توصیف میکند.
- فیلد has_colors به کلاس Gift اضافه شد.
- فیلد colors به کلاس UniqueGift اضافه شد.
- کلاس GiftBackground و فیلد background به کلاس Gift اضافه شد.
- فیلد unique_gift_variant_count به کلاس Gift اضافه شد.
- فیلد unique_gift_number به کلاسهای GiftInfo و OwnedGiftRegular اضافه شد.
- فیلد gifts_from_channels به کلاس AcceptedGiftTypes اضافه شد.
موارد دیگر
- رباتها اکنون میتوانند نام کاربری اصلی خود را غیرفعال کنند، به شرطی که نامهای کاربری فعال دیگری خریداریشده از Fragment داشته باشند.
- رباتها اکنون میتوانند مجوز can_restrict_members را در چتهای کانال غیرفعال کنند.
- متد repostStory اضافه شد که به رباتها امکان میدهد استوریها را بین حسابهای تجاری مختلفی که مدیریت میکنند بازنشر کنند.
- کلاس UserRating و فیلد rating به کلاس ChatFullInfo اضافه شد.
- حداکثر قیمت مدیای پولی به 25000 Telegram Stars افزایش یافت.
- فیلد paid_message_star_count به کلاس ChatFullInfo اضافه شد.
- پارامتر message_effect_id به متدهای forwardMessage و copyMessage اضافه شد.
- فیلد unique_gift_colors به کلاس ChatFullInfo اضافه شد.
- فیلد completed_by_chat به کلاس ChecklistTask اضافه شد.
Bot API 9.2
متدهای جدید: approveSuggestedPost, declineSuggestedPost
چکلیستها
- فیلد checklist_task_id به کلاس ReplyParameters اضافه شد تا رباتها بتوانند به یک وظیفه مشخص از چکلیست پاسخ دهند.
- فیلد reply_to_checklist_task_id به کلاس Message اضافه شد.
هدیهها
- فیلد publisher_chat به کلاسهای Gift و UniqueGift اضافه شد که با آن میتوان اطلاعات چتِ منتشرکننده هدیه را دریافت کرد.
پیامهای مستقیم در کانالها
- فیلد is_direct_messages به کلاسهای Chat و ChatFullInfo اضافه شد که با آن میتوان سوپرگروههایی را که بهعنوان چت پیام مستقیم کانال استفاده میشوند شناسایی کرد.
- فیلد parent_chat به کلاس ChatFullInfo اضافه شد که چت کانال والد را برای یک چت پیام مستقیم کانال مشخص میکند.
- کلاس DirectMessagesTopic و فیلد direct_messages_topic به کلاس Message اضافه شد که تاپیک یک چت پیام مستقیم را توصیف میکنند.
- پارامتر direct_messages_topic_id به متدهای sendMessage، sendPhoto، sendVideo، sendAnimation، sendAudio، sendDocument، sendPaidMedia، sendSticker، sendVideoNote، sendVoice، sendLocation، sendVenue، sendContact، sendDice، sendInvoice، sendMediaGroup، copyMessage، copyMessages، forwardMessage و forwardMessages اضافه شد. با این پارامتر میتوان پیام را به یک تاپیک از چت پیام مستقیم ارسال کرد.
پستهای پیشنهادی
- کلاس SuggestedPostParameters و پارامتر suggested_post_parameters به متدهای sendMessage، sendPhoto، sendVideo، sendAnimation، sendAudio، sendDocument، sendPaidMedia، sendSticker، sendVideoNote، sendVoice، sendLocation، sendVenue، sendContact، sendDice، sendInvoice، copyMessage و forwardMessage اضافه شد. با این پارامتر میتوان یک پست پیشنهادی را به تاپیک چت پیام مستقیم ارسال کرد.
- متد approveSuggestedPost اضافه شد که به رباتها امکان تأیید پستهای پیشنهادی دریافتی را میدهد.
- متد declineSuggestedPost اضافه شد که به رباتها امکان رد پستهای پیشنهادی دریافتی را میدهد.
- فیلد can_manage_direct_messages به کلاسهای ChatMemberAdministrator و ChatAdministratorRights اضافه شد.
- پارامتر can_manage_direct_messages به متد promoteChatMember اضافه شد.
- فیلد is_paid_post به کلاس Message اضافه شد که با آن میتوان پستهای پولی را شناسایی کرد. برای دریافت پرداخت، چنین پستهایی نباید تا 24 ساعت حذف شوند.
- کلاس SuggestedPostPrice اضافه شد که قیمت یک پست پیشنهادی را توصیف میکند.
- کلاس SuggestedPostInfo و فیلد suggested_post_info به کلاس Message اضافه شد که یک پست پیشنهادی را توصیف میکنند.
- کلاس SuggestedPostApproved و فیلد suggested_post_approved به کلاس Message اضافه شد که پیام سرویسی درباره تأیید یک پست پیشنهادی را توصیف میکنند.
- کلاس SuggestedPostApprovalFailed و فیلد suggested_post_approval_failed به کلاس Message اضافه شد که پیام سرویسی درباره ناموفق بودن تأیید یک پست پیشنهادی را توصیف میکنند.
- کلاس SuggestedPostDeclined و فیلد suggested_post_declined به کلاس Message اضافه شد که پیام سرویسی درباره رد شدن یک پست پیشنهادی را توصیف میکنند.
- کلاس SuggestedPostPaid و فیلد suggested_post_paid به کلاس Message اضافه شد که پیام سرویسی درباره پرداخت موفق برای یک پست پیشنهادی را توصیف میکنند.
- کلاس SuggestedPostRefunded و فیلد suggested_post_refunded به کلاس Message اضافه شد که پیام سرویسی درباره بازپرداخت وجه یک پست پیشنهادی را توصیف میکنند.
Bot API 9.1
متدهای جدید: sendChecklist, editMessageChecklist, getMyStarBalance
چکلیستها
- کلاس ChecklistTask اضافه شد که یک وظیفه در چکلیست را نشان میدهد.
- کلاس Checklist اضافه شد که یک چکلیست را نشان میدهد.
- کلاس InputChecklistTask اضافه شد که وظیفهای برای افزودن به چکلیست را نشان میدهد.
- کلاس InputChecklist اضافه شد که چکلیستی برای ساخت را نشان میدهد.
- فیلد checklist به کلاسهای Message و ExternalReplyInfo اضافه شد که چکلیست موجود در پیام را توصیف میکند.
- کلاس ChecklistTasksDone و فیلد checklist_tasks_done به کلاس Message اضافه شد که پیام سرویسی درباره تغییر وضعیت وظایف چکلیست (یعنی علامتگذاری بهعنوان انجامشده/انجامنشده) را توصیف میکنند.
- کلاس ChecklistTasksAdded و فیلد checklist_tasks_added به کلاس Message اضافه شد که پیام سرویسی درباره افزودن وظایف جدید به چکلیست را توصیف میکنند.
- متد sendChecklist اضافه شد که به رباتها امکان ارسال چکلیست از طرف حساب تجاری را میدهد.
- متد editMessageChecklist اضافه شد که به رباتها امکان ویرایش چکلیست از طرف حساب تجاری را میدهد.
هدیهها
- فیلد next_transfer_date به کلاسهای OwnedGiftUnique و UniqueGiftInfo اضافه شد.
- فیلد last_resale_star_count به کلاس UniqueGiftInfo اضافه شد.
- “resale” بهعنوان مقدار ممکن فیلد origin در کلاس UniqueGiftInfo اضافه شد.
عمومی
- حداکثر تعداد گزینههای نظرسنجی به 12 افزایش یافت.
- متد getMyStarBalance اضافه شد که به رباتها امکان دریافت موجودی فعلی Telegram Stars خود را میدهد.
- کلاس DirectMessagePriceChanged و فیلد direct_message_price_changed به کلاس Message اضافه شد که پیام سرویسی درباره تغییر قیمت پیامهای مستقیم ارسالی به چت کانال را توصیف میکنند.
- متد hideKeyboard به کلاس WebApp اضافه شد.
Bot API 9.0
متدهای جدید: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
حسابهای تجاری
- کلاس BusinessBotRights اضافه شد و در کلاس BusinessConnection فیلد can_reply با فیلد rights از نوع BusinessBotRights جایگزین شد.
- متد readBusinessMessage اضافه شد که به رباتها امکان میدهد پیامهای دریافتی را از طرف حساب تجاری خواندهشده علامت بزنند.
- متد deleteBusinessMessages اضافه شد که به رباتها امکان حذف پیامها از طرف حساب تجاری را میدهد.
- متد setBusinessAccountName اضافه شد که به رباتها امکان تغییر نام و نام خانوادگی حساب تجاری مدیریتشده را میدهد.
- متد setBusinessAccountUsername اضافه شد که به رباتها امکان تغییر نام کاربری حساب تجاری مدیریتشده را میدهد.
- متد setBusinessAccountBio اضافه شد که به رباتها امکان تغییر بیوی حساب تجاری مدیریتشده را میدهد.
- کلاس InputProfilePhoto اضافه شد که عکس پروفایلی برای تنظیم را توصیف میکند.
- متدهای setBusinessAccountProfilePhoto و removeBusinessAccountProfilePhoto اضافه شدند که به رباتها امکان تغییر عکس پروفایل حساب تجاری مدیریتشده را میدهند.
- متد setBusinessAccountGiftSettings اضافه شد که به رباتها امکان تغییر تنظیمات حریم خصوصی مربوط به هدیههای دریافتی در حساب تجاری مدیریتشده را میدهد.
- کلاس StarAmount و متد getBusinessAccountStarBalance اضافه شدند که به رباتها امکان بررسی موجودی فعلی Telegram Stars حساب تجاری مدیریتشده را میدهند.
- متد transferBusinessAccountStars اضافه شد که به رباتها امکان میدهد Telegram Stars را از موجودی حساب تجاری مدیریتشده برای برداشت به موجودی خود منتقل کنند.
- کلاسهای OwnedGiftRegular، OwnedGiftUnique، OwnedGifts و متد getBusinessAccountGifts اضافه شدند که به رباتها امکان دریافت فهرست هدیههای متعلق به حساب تجاری مدیریتشده را میدهند.
- متد convertGiftToStars اضافه شد که به رباتها امکان میدهد هدیههای دریافتی حساب تجاری مدیریتشده را به Telegram Stars تبدیل کنند.
- متد upgradeGift اضافه شد که به رباتها امکان میدهد هدیههای معمولی دریافتی حساب تجاری مدیریتشده را به هدیه منحصربهفرد ارتقا دهند.
- متد transferGift اضافه شد که به رباتها امکان انتقال هدیههای منحصربهفرد متعلق به حساب تجاری مدیریتشده را میدهد.
- کلاسهای InputStoryContentPhoto و InputStoryContentVideo اضافه شدند که محتوای استوری برای انتشار را نشان میدهند.
- کلاسهای StoryArea، StoryAreaPosition، LocationAddress، StoryAreaTypeLocation، StoryAreaTypeSuggestedReaction، StoryAreaTypeLink، StoryAreaTypeWeather و StoryAreaTypeUniqueGift اضافه شدند که نواحی فعال قابل کلیک روی استوریها را توصیف میکنند.
- متد postStory اضافه شد که به رباتها امکان انتشار استوری از طرف حساب تجاری مدیریتشده را میدهد.
- متد editStory اضافه شد که به رباتها امکان ویرایش استوریهایی را میدهد که قبلاً از طرف حساب تجاری مدیریتشده منتشر کردهاند.
- متد deleteStory اضافه شد که به رباتها امکان حذف استوریهایی را میدهد که قبلاً از طرف حساب تجاری مدیریتشده منتشر کردهاند.
Mini Appها
- فیلد DeviceStorage اضافه شد که به Mini Appها امکان استفاده از فضای ذخیرهسازی محلی ماندگار روی دستگاه کاربر را میدهد.
- فیلد SecureStorage اضافه شد که به Mini Appها امکان استفاده از فضای ذخیرهسازی محلی امن روی دستگاه کاربر برای دادههای حساس را میدهد.
هدیهها
- کلاسهای UniqueGiftModel، UniqueGiftSymbol، UniqueGiftBackdropColors و UniqueGiftBackdrop برای توصیف ویژگیهای هدیه منحصربهفرد اضافه شدند.
- کلاس UniqueGift اضافه شد که هدیهای را توصیف میکند که به هدیه منحصربهفرد ارتقا یافته است.
- کلاس AcceptedGiftTypes اضافه شد که انواع هدیههایی را که یک کاربر یا چت میپذیرد توصیف میکند.
- در کلاس ChatFullInfo فیلد can_send_gift با فیلد accepted_gift_types از نوع AcceptedGiftTypes جایگزین شد.
- کلاس GiftInfo و فیلد gift به کلاس Message اضافه شد که پیام سرویسی درباره ارسال یا دریافت هدیه معمولی را توصیف میکنند.
- کلاس UniqueGiftInfo و فیلد unique_gift به کلاس Message اضافه شد که پیام سرویسی درباره ارسال یا دریافت هدیه منحصربهفرد را توصیف میکنند.
Telegram Premium
- متد giftPremiumSubscription اضافه شد که به رباتها امکان میدهد اشتراک Telegram Premium را با پرداخت Telegram Stars به کاربر هدیه دهند.
- فیلد premium_subscription_duration به کلاس TransactionPartnerUser اضافه شد؛ برای تراکنشهای مربوط به اشتراک Telegram Premium خریداریشده توسط ربات.
- فیلد transaction_type به کلاس TransactionPartnerUser اضافه شد که تشخیص و پردازش انواع تراکنشها را سادهتر میکند.
عمومی
- حداکثر قیمت مدیای پولی به 10000 Telegram Stars افزایش یافت.
- حداکثر قیمت هر دوره اشتراک به 10000 Telegram Stars افزایش یافت.
- کلاس PaidMessagePriceChanged و فیلد paid_message_price_changed به کلاس Message اضافه شد که پیام سرویسی درباره تغییر قیمت پیامهای پولی ارسالی به چت را توصیف میکنند.
- فیلد paid_star_count به کلاس Message اضافه شد که تعداد Telegram Stars پرداختشده برای ارسال پیام را نشان میدهد.
نسخههای قدیمیتر
نسخههای پیش از Bot API 9.0 همراه با تاریخ انتشار فهرست شدهاند. توضیحات کامل آنها در تغییرات رسمی آمده است.
- Bot API 8.3 — ۲۴ بهمن ۱۴۰۳
- Bot API 8.2 — ۱۲ دی ۱۴۰۳
- Bot API 8.1 — ۱۴ آذر ۱۴۰۳
- Bot API 8.0 — ۲۷ آبان ۱۴۰۳
- Bot API 7.11 — ۱۰ آبان ۱۴۰۳
- Bot API 7.10 — ۱۶ شهریور ۱۴۰۳
- Bot API 7.9 — ۲۴ مرداد ۱۴۰۳
- Bot API 7.8 — ۱۰ مرداد ۱۴۰۳
- Bot API 7.7 — ۱۷ تیر ۱۴۰۳
- Bot API 7.6 — ۱۱ تیر ۱۴۰۳
- Bot API 7.5 — ۲۹ خرداد ۱۴۰۳
- Bot API 7.4 — ۸ خرداد ۱۴۰۳
- Bot API 7.3 — ۱۷ اردیبهشت ۱۴۰۳
- Bot API 7.2 — ۱۲ فروردین ۱۴۰۳
- Bot API 7.1 — ۲۷ بهمن ۱۴۰۲
- Bot API 7.0 — ۸ دی ۱۴۰۲
- Bot API 6.9 — ۳۱ شهریور ۱۴۰۲
- Bot API 6.8 — ۲۷ مرداد ۱۴۰۲
- Bot API 6.7 — ۱ اردیبهشت ۱۴۰۲
- Bot API 6.6 — ۱۸ اسفند ۱۴۰۱
- Bot API 6.5 — ۱۴ بهمن ۱۴۰۱
- Bot API 6.4 — ۹ دی ۱۴۰۱
- Bot API 6.3 — ۱۴ آبان ۱۴۰۱
- Bot API 6.2 — ۲۱ مرداد ۱۴۰۱
- Bot API 6.1 — ۳۰ خرداد ۱۴۰۱
- Bot API 6.0 — ۲۷ فروردین ۱۴۰۱
- Bot API 5.7 — ۱۱ بهمن ۱۴۰۰
- Bot API 5.6 — ۹ دی ۱۴۰۰
- Bot API 5.5 — ۱۶ آذر ۱۴۰۰
- Bot API 5.4 — ۱۴ آبان ۱۴۰۰
- Bot API 5.3 — ۴ تیر ۱۴۰۰
- Bot API 5.2 — ۶ اردیبهشت ۱۴۰۰
- Bot API 5.1 — ۱۹ اسفند ۱۳۹۹
- Bot API 5.0 — ۱۴ آبان ۱۳۹۹
- Bot API 4.9 — ۱۵ خرداد ۱۳۹۹
- Bot API 4.8 — ۵ اردیبهشت ۱۳۹۹
- Bot API 4.7 — ۱۱ فروردین ۱۳۹۹
- Bot API 4.6 — ۳ بهمن ۱۳۹۸
- Bot API 4.5 — ۱۰ دی ۱۳۹۸
- Bot API 4.4 — ۷ مرداد ۱۳۹۸
- Bot API 4.3 — ۱۰ خرداد ۱۳۹۸
- Bot API 4.2 — ۲۵ فروردین ۱۳۹۸
- Bot API 4.1 — ۵ شهریور ۱۳۹۷
- Bot API 4.0 — ۴ مرداد ۱۳۹۷
- Bot API 3.6 — ۲۴ بهمن ۱۳۹۶
- Bot API 3.5 — ۲۶ آبان ۱۳۹۶
- Bot API 3.4 — ۱۹ مهر ۱۳۹۶
- Bot API 3.3 — ۱ شهریور ۱۳۹۶
- Bot API 3.2 — ۳۰ تیر ۱۳۹۶
- Bot API 3.1 — ۹ تیر ۱۳۹۶
- Bot API 3.0 — ۲۸ اردیبهشت ۱۳۹۶
- Bot API 2.3.1 — ۱۴ آذر ۱۳۹۵
- Bot API 2.3 — ۱ آذر ۱۳۹۵
- Bot API 2.2. — ۱۲ مهر ۱۳۹۵
- Bot API 2.1. — ۲ خرداد ۱۳۹۵
- Bot API 2.0 — ۲۱ فروردین ۱۳۹۵
پرسشهای متداول
آخرین نسخه Telegram Bot API کدام است؟
Bot API 10.5 که در ۱ آذر ۱۴۰۵ منتشر شد. این نسخه 194 متد دارد.
Telegram Bot API هر چند وقت یک بار تغییر میکند؟
Telegram معمولاً هر یک تا دو ماه یک نسخه جدید از Bot API منتشر میکند. هر نسخه متدها و فیلدهایی اضافه میکند؛ برخی نسخهها تغییرات ناسازگار هم دارند که در توضیحات مشخص شدهاند.
چطور بفهمم یک متد در چه نسخهای اضافه شده است؟
متد را در مرجع متدهای ما باز کنید: بخش «تاریخچه نسخهها» نسخهای را که متد در آن اضافه شده و نسخههایی را که آن را تغییر دادهاند، با لینک به همین صفحه نشان میدهد.