NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #4532 most downloaded on PyPI
Python Telegram bot API.
Latest stable
4.37.1
Last release 1 months ago
17 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Most releases are documented
notes for 45 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
148 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Library is now support the latest Bot API (v.5.3)! (With some limitations, see compatibility list in readme).
Great news!
Library is now support the latest Bot API (v.5.3)! (With some limitations, see compatibility list in readme).
We hope to keep it now up to date with the further Bot API updates.
Library confirmed to support Bot API up to the latest v.5.3! (With some limitations, see compatibility list in readme).
Great news!
Library confirmed to support Bot API up to the latest v.5.3! (With some limitations, see compatibility list in readme).
It also includes set of register_xxx_handler functions, that allows to dynamicaly add handlers in addition to @bot.message_handler
This is a pre-release to version 4.0.0. When the maturity of this version will be confirmed - the release will be bumped.
worker_pool error when stop_bot fixed
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Incremental update
Bugfix in polling and infinity_polling.
Bugfix in polling and infinity_polling.
Type hints for many methods and functions
Large update
Great respect to @SwissCorePy for that!
Fix of inconsistency in v3.7.8, sorry.
Fix of inconsistency in v3.7.8, sorry.
Regular release with minor updates
Regular release with minor updates
copymessage available. Minor fixes.
copymessage available. Minor fixes.
Fix significant issues with polling mode and restrictChatMemeber.
Fix significant issues with polling mode and restrictChatMemeber.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix Issue: #574 #554 #575
Fix Issue: #574 #554 #575
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix stop polling not close thread.
Change log
Remove import same logger from telebot module in util module.
Change log:
https://core.telegram.org/bots/api#february-13-2018
Support v3.6 new feature.
https://core.telegram.org/bots/api#february-13-2018
Nothing published for this version
* Add content_type * Remove debug print
Telegram bot api 3.5 features. https://core.telegram.org/bots/api#november-17-2017
Telegram bot api 3.5 features. https://core.telegram.org/bots/api#november-17-2017
Nothing published for this version
Nothing published for this version
Nothing published for this version
Bot API v3.2 features: https://core.telegram.org/bots/api#july-21-2017
Change log:
Telegram bot api 3.1 features. https://core.telegram.org/bots/api#june-30-2017
Change log:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Modified bot privacy mode for the sake of consistency.
Modified bot privacy mode for the sake of consistency.
Your bot can now get updates about posts in channels . Added new fields channel_post and edited_channel_post to Update .
You can now update high scores to a lower value by using the new force parameter in setGameScore . Handy for punishing cheaters or fixing errors in your game's High Score table.
Starting today, messages with high scores will be updated with new high scores by default. Use disable_edit_message in setGameScore if you don't want this.
The edit_message parameter from setGameScore is no longer in use. For backward compatibility, it will be taken into account for a while, unless disable_edit_message is passed explicitly.
Added the new field forward_from_message_id to Message .
Added the new parameter cache_time to answerCallbackQuery . Will eventually work in Telegram apps - somewhere after version 3.14, maybe 3.15.
Renamed hide_keyboard to remove_keyboard in ReplyKeyboardRemove for clarity. hide_keyboard will still work for a while for backward compatibility.
Bot API 2.2. Introducing a new Gaming Platform! See this introduction for a brief overview. If you're not a developer, you may like this user-friendly blog post better.
New tools for building HTML5 games .
New method sendGame , new object InlineQueryResultGame , new field game in Message .
New parameter url in answerCallbackQuery . Create a game and accept the conditions using Botfather to send custom urls that open your games for the user.
New field callback_game in InlineKeyboardButton , new fields game_short_name and chat_instance in CallbackQuery , new object CallbackGame .
New methods setGameScore and getGameHighScores .
Other changes
Making life easier for webhook users. Added a detailed Guide to All Things Webhook that describes every pothole you can run into on the webhook road.
New method getWebhookInfo to check current webhook status.
Added the option to specify an HTTP URL for a file in all methods where InputFile or file_id can be used (except voice messages). Telegram will get the file from the specified URL and send it to the user. Files must be smaller than 5 MB for photos and smaller than 20 MB for all other types of content.
Use the new url parameter in answerCallbackQuery to create buttons that open your bot with user-specific parameters.
Added new field switch_inline_query_current_chat in InlineKeyboardButton .
Added caption fields to sendAudio , sendVoice , InlineQueryResultAudio , InlineQueryResultVoice , InlineQueryResultCachedAudio , and InlineQueryResultCachedVoice .
New field all_members_are_administrators in the Chat object.
Certain server responses may now contain the new parameters field with expanded info on errors that occurred while processing your requests.
Inline keyboards may now be used in group chats. Channels coming soon.
Check out @vote and @like for examples.
Bot API 2.1. Added more tools for group administrator bots. Your bot can now get a list of administrators and members count in a group, check a user's current status (administrator, creator, left the group, kicked from the group), and leave a group.
Added new methods: getChat , leaveChat , getChatAdministrators , getChatMember , getChatMembersCount .
Added support for edited messages and new mentions from Telegram v.3.9. New fields: edited_message in Update , edit_date in Message , user in MessageEntity . New value text_mention for the type field in MessageEntity .
Added the field emoji to the Sticker object. Your bot can now know the emoji a sticker corresponds to.
Added the field forward_from_chat to the Message object for messages forwarded from channels.
Introducing Bot API 2.0 . Check out this page for a review of this major update.
New inline keyboards with callback and URL buttons . Added new objects InlineKeyboardMarkup , InlineKeyboardButton and CallbackQuery , added reply_markup fields to all InlineQueryResult objects. Added field callback_query to the Update object, new method answerCallbackQuery .
Bots can now edit their messages . Added methods editMessageText , editMessageCaption , editMessageReplyMarkup .
Bots can request location and phone number from the user. The keyboard field in the object ReplyKeyboardMarkup now supports KeyboardButton , a new object that can have the fields request_location and request_contact .
Inline bots
Added support for all content types available on Telegram. 19 types of InlineQueryResult objects are now supported.
Inline bots can now substitute all kinds of content with text. Added 4 types of InputMessageContent objects.
Your inline bot can also ask users for permission to use their location. Added the new Botfather command /setinlinegeo , added field location to the InlineQuery object, added fields location and inline_message_id to the ChosenInlineResult object.
Added an easy way to switch between inline mode and a private chat with the bot - useful for settings, establishing external connections and teaching users how to use your bot in inline mode. Added parameters switch_pm_text and switch_pm_parameter to the method answerInlineQuery .
Miscellaneous
Added group administration tools. New methods kickChatMember and unbanChatMember .
Added fields venue , pinned_message and entities to the Message object. Added new objects MessageEntity and Venue , new methods sendVenue and sendContact .
Renamed the fields new_chat_participant and left_chat_participant of the Message object to new_chat_member and left_chat_member .
Added the disable_notification parameter to all methods that send messages or any kind.
Removed backward compatibility from the method sendAudio . Voice messages now must be sent using the method sendVoice . There is no more need to specify a non-empty title or performer while sending the audio by file_id .
Added support for Inline Mode , a new way for people to contact your bot by typing its username and a query in the text input field in any chat. Enable by sending /setinline to @BotFather .
New optional field inline_query added to the Update object.
Added new method answerInlineQuery and new objects InlineQuery , InlineQueryResultArticle , InlineQueryResultPhoto , InlineQueryResultGif , InlineQueryResultMpeg4Gif and InlineQueryResultVideo .
Added support for supergroups . The Type field in the Chat object can now contain 'supergroup'.
New optional fields added to the Message object: supergroup_chat_created , migrate_to_chat_id , migrate_from_chat_id and channel_chat_created .
Added initial channel support for bots (no Telegram clients support this at the moment, please wait for updates):
The Chat field in the Message is now of the new type Chat .
You can now pass a channel username (in the format @channelusername ) in the place of chat_id in all methods (and instead of from_chat_id in forwardMessage ). For this to work, the bot must be an administrator in the channel (and that's exactly what Telegram clients don't support yet - adding bots as administrators coming soon).
Bots can now download files and media sent by users.
Added getFile and File .
You can now pass parameters using application/json (please note that this doesn't work for file uploads: use multipart/form-data to upload files).
Added very basic markdown support . New field parse_mode added to sendMessage . For the moment messages with markdown will be displayed correctly only in Telegram for Android . Other official apps will catch up soon.
Added support for self-signed certificates: upload your certificate using the certificate parameter in the setWebhook method.
You can now make new requests when responding to webhook updates.
Added new type Voice and new method sendVoice for sending voice messages.
Earlier Audio and sendAudio should now be used for sending music files. Telegram clients will show such files in the in-app music player. If you were using sendAudio for your bot to send voice messages, please use sendVoice instead.
Added optional fields performer , title to the Audio object and sendAudio method.
Added optional field voice to the Message object.
The thumb field is now optional for Video , Sticker and Document objects
The API now supports both video and photo captions. The caption field has been removed from the Video object and added to the Message object instead.
caption and duration optional fields have been added to the sendVideo method.
Fixed typo: user_id in the Contact object is now correctly labeled as Integer, not String
The bot platform is officially launched .
Back to the Bot API Manual »
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
FAQ
Privacy
Press
iPhone/iPad
Android
Mobile Web
PC/Mac/Linux
macOS
Web-browser
API
Translations
Instant View
Other change in October 3, 2016 update.
Change log:
Nothing published for this version
Nothing published for this version
Other change in October 3, 2016 update.
Change log:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added new methods: getChat, leaveChat, getChatAdministrators, getChatMember, getChatMembersCount.
Change log:
Nothing published for this version
Nothing published for this version
Nothing published for this version
ReplyKeyboardMarkup support string in bot2.0
Change log:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support Telegram Bot 2.0 API's new features.
Change log:
Added the ability to reply to messages in other chats or forum topics.
Added the class ExternalReplyInfo and the field external_reply of type ExternalReplyInfo to the class Message , containing information about a message that is replied to by the current message, but can be from another chat or forum topic.
Added the ability to quote a part of the replied message.
Added the class TextQuote and the field quote of type TextQuote to the class Message , which contains the part of the replied message text or caption that is quoted in the current message.
Added the class ReplyParameters and replaced parameters reply_to_message_id and allow_sending_without_reply in the methods copyMessage , sendMessage , sendPhoto , sendVideo , sendAnimation , sendAudio , sendDocument , sendSticker , sendVideoNote , sendVoice , sendLocation , sendVenue , sendContact , sendPoll , sendDice , sendInvoice , sendGame , and sendMediaGroup with the field reply_parameters of type ReplyParameters .
Link Preview Customization
Allowed to explicitly specify the URL that will be used for link preview generation in outgoing text messages.
Allowed to position link previews above the message text.
Allowed to choose media size in link previews.
Added the class LinkPreviewOptions and replaced the parameter disable_web_page_preview with link_preview_options in the methods sendMessage and editMessageText .
Replaced the field disable_web_page_preview with link_preview_options in the class InputTextMessageContent .
Added the field link_preview_options to the class Message with information about the link preview options used to send the message.
Block Quotation
Added support for “blockquote” entities in received messages.
Added support for “blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.
Allowed to explicitly specify “blockquote” entities in formatted texts.
Multiple Message Actions
Added the method deleteMessages to allow the deletion of multiple messages in a single request.
Added the method forwardMessages for forwarding of multiple messages in a single request.
Added the method copyMessages for copying of multiple messages in a single request.
Request for multiple users
Renamed the class KeyboardButtonRequestUser to KeyboardButtonRequestUsers and added the field max_quantity to it.
Renamed the field request_user in the class KeyboardButton to request_users . The old name will still work for backward compatibility.
Added the class UsersShared .
Replaced the field user_shared in the class Message with the field users_shared .
Chat Boost
Added updates about chat boost changes, represented by the classes ChatBoostUpdated and ChatBoostRemoved and the fields chat_boost and removed_chat_boost in the class Update . The bot must be an administrator in the chat to receive these updates.
Added the classes ChatBoostSourcePremium , ChatBoostSourceGiftCode and ChatBoostSourceGiveaway , representing different sources of a chat boost.
Added the method getUserChatBoosts for obtaining the list of all active boosts a user has contributed to a chat.
Giveaway
Added the class Giveaway and the field giveaway to the class Message for messages about scheduled giveaways.
Added the class GiveawayCreated and the field giveaway_created to the class Message for service messages about the creation of a scheduled giveaway.
Added the class GiveawayWinners and the field giveaway_winners to the class Message for messages about the completion of a giveaway with public winners.
Added the class GiveawayCompleted and the field giveaway_completed to the class Message for service messages about the completion of a giveaway without public winners.
Web App Changes
Added the field SettingsButton to the class WebApp .
Added the fields header_bg_color , accent_text_color , section_bg_color , section_header_text_color , subtitle_text_color , destructive_text_color to the class ThemeParams .
Web Apps no longer close when the method WebApp.openTelegramLink is called.
Other Changes
Added support for the fields emoji_status_custom_emoji_id and emoji_status_expiration_date in the class Chat for non-private chats.
Added the fields accent_color_id , background_custom_emoji_id , profile_accent_color_id , and profile_background_custom_emoji_id to the class Chat .
Added the field has_visible_history to the class Chat .
Added the class MessageOrigin and replaced the fields forward_from , forward_from_chat , forward_from_message_id , forward_signature , forward_sender_name , and forward_date with the field forward_origin of type MessageOrigin in the class Message .
Improved documentation for the field message of the class callbackQuery and the field pinned_message of the class Message by adding the classes MaybeInaccessibleMessage and InaccessibleMessage .
Add disable_notification parameter.
Change log:
All Message's attributes default to None. Don't need hasattr to check attribute.
Change log:
Change log: - Code clean up - Bugs fix
Change log:
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.