NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
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.
Nothing published for this version
Bot API support bumped up to v.10.3. Bugfixes and internal redesign.
Bot API support bumped up to v.10.3.
Bugfixes and internal redesign.
Minor fixes in RichText processing
Bot API support bumped up to v.10.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Bot API support bumped up to v.10.2
Bot API support bumped up to v.10.1
Bot API support bumped up to v.10.1
Bot API support bumped up to v.10.0
Bot API support bumped up to v.10.0
Bot API support bumped up to v.9.6
Bot API support bumped up to v.9.6
Bot API support bumped up to v.9.5
Bot API support bumped up to v.9.5
Bot API support bumped up to v.9.4
Bot API support bumped up to v.9.4
Bot API support bumped up to v.9.3
Bot API support bumped up to v.9.3
Nothing changed, just bumped version to push sone fixes not released to PyPi.
Nothing changed, just bumped version to push sone fixes not released to PyPi.
Bot API support bumped up to v.9.2
Bot API support bumped up to v.9.2
Bot API support bumped up to v.9.1
Bot API support bumped up to v.9.1
Bot API support bumped up to v.9.0 (together with v.8.3)
Bot API support bumped up to v.9.0 (together with v.8.3)
Bot API support bumped up to v.8.2
Bot API support bumped up to v.8.2
Bot API support bumped up to v.8.1 (together with v.8.0)
Bot API support bumped up to v.8.1 (together with v.8.0)
Bot API support bumped up to v.7.11.
Bot API support bumped up to v.7.11.
Python 3.8 removed from support due to EOL. Python 3.13 added to support due to release.
Bot API support bumped up to v.7.10 (together with v.7.9)
Bot API support bumped up to v.7.10 (together with v.7.9)
Nothing published for this version
Bot API support bumped up to v.7.8.
Bot API support bumped up to v.7.7 (together with v.7.6)
Bot API support bumped up to v.7.7 (together with v.7.6)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Bot API support bumped up to v.7.4
Bot API support bumped up to v.7.4
Nothing published for this version
Bot API support bumped up to v.7.3
Bot API support bumped up to v.7.3
Bot API support bumped up to v.7.2
Bot API support bumped up to v.7.2
Nothing published for this version
Bot API support bumped up to v.7.1
Bot API support bumped up to v.7.1
Nothing published for this version
Nothing published for this version
Nothing published for this version
Added deprecation stubs for Message fields in InaccessibleMessage
Nothing published for this version
Set of actively used properties had changed their format! Please, pay attention on new format of passing:
Set of actively used properties had changed their format! Please, pay attention on new format of passing:
Fix ExceptionHandler handle() method as async for async telebot
Bot API support bumped up to v.6.9
Bot API support bumped up to v.6.9
Bot API support bumped up to v.6.8
Bot API support bumped up to v.6.8
## Bot API support bumped up to v.6.7
We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.
Deprecation warnings
We recommend switching to proper functions, classes, parameters if you are using deprecated ones. Deprecated functions will be deleted soon.
Deprecation warnings
Bot API support bumped up to v.6.4
Added the new field via_bot to the Message object. You can now know which bot was used to send a message.
Supported video thumbnails for inline GIF and MPEG4 animations.
Supported the new basketball animation for the random dice . Choose between different animations (dice, darts, basketball) by specifying the emoji parameter in the method sendDice .
Bot API support bumped up to v.6.3
Supported explanations for Quizzes 2.0 . Add explanations by specifying the parameters explanation and explanation_parse_mode in the method sendPoll .
Added the fields explanation and explanation_entities to the Poll object.
Supported timed polls that automatically close at a certain date and time. Set up by specifying the parameter open_period or close_date in the method sendPoll .
Added the fields open_period and close_date to the Poll object.
Supported the new darts animation for the dice mini-game. Choose between the default dice animation and darts animation by specifying the parameter emoji in the method sendDice .
Added the field emoji to the Dice object.
Support ContinueHandling to continue with other handlers after handler is found
Bot API support bumped up to v.6.2
Added the method sendDice for sending a dice message, which will have a random value from 1 to 6. (Yes, we're aware of the “proper” singular of die . But it's awkward, and we decided to help it change. One dice at a time!)
Added the field dice to the Message object.
Added the method getMyCommands for getting the current list of the bot's commands.
Added the method setMyCommands for changing the list of the bot's commands through the Bot API instead of @BotFather .
Added the ability to create animated sticker sets by specifying the parameter tgs_sticker instead of png_sticker in the method createNewStickerSet .
Added the ability to add animated stickers to sets created by the bot by specifying the parameter tgs_sticker instead of png_sticker in the method addStickerToSet .
Added the field thumb to the StickerSet object.
Added the ability to change thumbnails of sticker sets created by the bot using the method setStickerSetThumb .
run_webhooks() function for both versions
Bot API support bumped up to v.6.1
Supported Polls 2.0 .
Added the ability to send non-anonymous, multiple answer, and quiz-style polls: added the parameters is_anonymous , type , allows_multiple_answers , correct_option_id , is_closed options to the method sendPoll .
Added the object KeyboardButtonPollType and the field request_poll to the object KeyboardButton .
Added updates about changes of user answers in non-anonymous polls, represented by the object PollAnswer and the field poll_answer in the Update object.
Added the fields total_voter_count , is_anonymous , type , allows_multiple_answers , correct_option_id to the Poll object.
Bots can now send polls to private chats.
Added more information about the bot in response to the getMe request: added the fields can_join_groups , can_read_all_group_messages and supports_inline_queries to the User object.
Added the optional field language to the MessageEntity object.
Added sync i18n class based middleware
Bot API support bumped up to v.6.0
Bot API support bumped up to v.6.0
Added support for two new MessageEntity types, underline and strikethrough .
Added support for nested MessageEntity objects. Entities can now contain other entities. If two entities have common characters then one of them is fully contained inside the other.
Added support for nested entities and the new tags <u>/<ins> (for underlined text) and <s>/<strike>/<del> (for strikethrough text) in parse mode HTML.
Added a new parse mode, MarkdownV2 , which supports nested entities and two new entities __ (for underlined text) and ~ (for strikethrough text). Parse mode Markdown remains unchanged for backward compatibility.
Added the field file_unique_id to the objects Animation , Audio , Document , PassportFile , PhotoSize , Sticker , Video , VideoNote , Voice , File and the fields small_file_unique_id and big_file_unique_id to the object ChatPhoto . The new fields contain a unique file identifier, which is supposed to be the same over time and for different bots, but can't be used to download or reuse the file.
Added the field custom_title to the ChatMember object.
Added the new method setChatAdministratorCustomTitle to manage the custom titles of administrators promoted by the bot.
Added the field slow_mode_delay to the Chat object.
Extended custom exception_handler behaviour.
Changelog(short version):
Bot API support bumped up to v.5.7. Thanks to @coder2020official
Bot API support bumped up to v.5.7. Thanks to @coder2020official
Added support for animated stickers . New field is_animated in Sticker and StickerSet objects, animated stickers can now be used in sendSticker and InlineQueryResultCachedSticker .
Added support for default permissions in groups. New object ChatPermissions , containing actions which a member can take in a chat. New field permissions in the Chat object; new method setChatPermissions .
The field all_members_are_administrators has been removed from the documentation for the Chat object. The field is still returned in the object for backward compatibility, but new bots should use the permissions field instead.
Added support for more permissions for group and supergroup members: added the new field can_send_polls to ChatMember object, added can_change_info , can_invite_users , can_pin_messages in ChatMember object for restricted users (previously available only for administrators).
The method restrictChatMember now takes the new user permissions in a single argument of the type ChatPermissions . The old way of passing parameters will keep working for a while for backward compatibility.
Added description support for basic groups (previously available in supergroups and channel chats). You can pass a group's chat_id to setChatDescription and receive the group's description in the Chat object in the response to getChat method.
Added invite_link support for basic groups (previously available in supergroups and channel chats). You can pass a group's chat_id to exportChatInviteLink and receive the group's invite link in the Chat object in the response to getChat method.
File identifiers from the ChatPhoto object are now invalidated and can no longer be used whenever the photo is changed.
All webhook requests from the Bot API are now coming from the subnets 149.154.160.0/20 and 91.108.4.0/22 . Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: https://core.telegram.org/bots/webhooks .
As of the next Bot API update ( version 4.5 ), nested MessageEntity objects will be allowed in message texts and captions. Please make sure that your code can correctly handle such entities.
Nothing published for this version
Bot API support bumped up to v.5.6. You know, whom to send thanks: @coder2020official
Bot API support bumped up to v.5.6. You know, whom to send thanks: @coder2020official
Added support for Seamless Telegram Login on external websites.
Added the new object LoginUrl and the new field login_url to the InlineKeyboardButton object which allows to automatically authorize users before they go to a URL specified by the bot. Users will be asked to confirm authorization in their Telegram app (needs version 5.7 or higher) when they press the button:
Also in this update:
Added the field reply_markup to the Message object, containing the inline keyboard attached to the message.
If a message with an inline keyboard is forwarded, the forwarded message will now have an inline keyboard if the keyboard contained only url and login_url buttons or if the message was sent via a bot and the keyboard contained only url , login_url , switch_inline_query or switch_inline_query_current_chat buttons. In the latter case, switch_inline_query_current_chat buttons are replaced with switch_inline_query buttons.
Bots now receive the edited_message Update even if only Message.reply_markup has changed.
Bots that have the can_edit_messages right in a channel can now use the method editMessageReplyMarkup for messages written by other administrators forever without the 48 hours limit.
Don't forget that starting in July 2019 , webhook requests from Bot API will be coming from the subnets 149.154.160.0/20 and 91.108.4.0/22 . Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: https://core.telegram.org/bots/webhooks .
Bot API support bumped up to v.5.5. Thanks again to @coder2020official
Bot API support bumped up to v.5.5. Thanks again to @coder2020official
Absolutely new AsyncTeleBot. By @coder2020official
Absolutely new AsyncTeleBot. By @coder2020official
See: https://github.com/eternnoir/pyTelegramBotAPI#asynctelebot for details.
Bot API support bumped up to v.5.4. Thanks to @coder2020official
Bot API support bumped up to v.5.4. Thanks to @coder2020official
Added possibility to override request sending for testing purposes or making some requests post-processing. See: https://github.com/eternnoir/pyTelegramBotAPI#testing
Added support for native polls: added the object Poll , the methods sendPoll and stopPoll and the field poll in the Message and Update objects.
The method deleteMessage can now be used to delete messages sent by a user to the bot in private chats within 48 hours.
Added support for pinned messages in basic groups in addition to supergroups and channel chats: you can pass group's chat_id to pinChatMessage and unpinChatMessage , and receive the pinned group message in Chat object.
Added the field is_member to the ChatMember object, which can be used to find whether a restricted user is a member of the chat.
Added the field forward_sender_name to the Message object, containing name of the sender who has opted to hide their account.
Starting in July 2019, webhook requests from Bot API will be coming from the subnets 149.154.160.0/20 and 91.108.4.0/22 . Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: https://core.telegram.org/bots/webhooks .
Document thumbnails now should be inscribed in a 320x320 square instead of 90x90.
States: new feature, based on custom filters: states.
States: new feature, based on custom filters: states.
See the example: https://github.com/eternnoir/pyTelegramBotAPI/blob/master/examples/custom_states.py
New feature: custom message filters!
New feature: custom message filters!
Now you can filter message handlers with whatever you want.
See for description: https://github.com/eternnoir/pyTelegramBotAPI#custom-filters and for examples: https://github.com/eternnoir/pyTelegramBotAPI/tree/master/examples/custom_filters
Added support for translated versions of documents in Telegram Passport .
New field translation in EncryptedPassportElement .
New errors: PassportElementErrorTranslationFile and PassportElementErrorTranslationFiles and PassportElementErrorUnspecified .
Bot API 4.0 .
Added support for Telegram Passport . See the official announcement on the blog and the manual for details.
Added support for editing the media content of messages : added the method editMessageMedia and new types InputMediaAnimation , InputMediaAudio , and InputMediaDocument .
Added the field thumb to the Audio object to contain the thumbnail of the album cover to which the music file belongs.
Added support for attaching custom thumbnails to uploaded files. For animations, audios, videos and video notes, which are less than 10 MB in size, thumbnails are generated automatically.
tg:// URLs now can be used in inline keyboard url buttons and text_link message entities.
Added the method sendAnimation , which can be used instead of sendDocument to send animations, specifying their duration, width and height.
Added the field animation to the Message object. For backward compatibility, when this field is set, the document field will be also set.
Added two new MessageEntity types: cashtag and phone_number .
Added support for Foursquare venues: added the new field foursquare_type to the objects Venue , InlineQueryResultVenue and InputVenueMessageContent , and the parameter foursquare_type to the sendVenue method.
You can now create inline mentions of users, who have pressed your bot's callback buttons.
You can now use the Retry-After response header to configure the delay after which the Bot API will retry the request after an unsuccessful response from a webhook.
If a webhook returns the HTTP error 410 Gone for all requests for more than 23 hours successively, it can be automatically removed.
Added vCard support when sharing contacts: added the field vcard to the objects Contact , InlineQueryResultContact , InputContactMessageContent and the method sendContact .
Bot API 3.6 .
Supported text formatting in media captions. Specify the desired parse_mode ( Markdown or HTML ) when you provide a caption.
In supergroups, if the bot receives a message that is a reply, it will also receive the message to which that message is replying - even if the original message is inaccessible due to the bot's privacy settings. (In other words, replying to any message in a supergroup with a message that mentions the bot or features a command for it acts as forwarding the original message to the bot).
Added the new field connected_website to Message . The bot will receive a message with this field in a private chat when a user logs in on the bot's connected website using the Login Widget and allows sending messages from your bot.
Added the new parameter supports_streaming to the sendVideo method and a field with the same name to the InputMediaVideo object.
Bot API 3.5 .
Added the new method sendMediaGroup and two kinds of InputMedia objects to support the new albums feature .
Added support for pinning messages in channels. pinChatMessage and unpinChatMessage accept channels.
Added the new fields provider_data , send_phone_number_to_provider , send_email_to_provider to sendInvoice for sharing information about the invoice with the payment provider.
Bot API 3.4 .
Bots can now send and receive Live Locations . Added new field live_period to the sendLocation method and the editMessageLiveLocation and stopMessageLiveLocation methods as well as the necessary objects for inline bots.
Bots can use the new setChatStickerSet and deleteChatStickerSet methods to manage group sticker sets .
The getChat request now returns the group's sticker set for supergroups if available.
Bots now receive entities from media captions in the new field caption_entities in Message .
Bot API 3.3 .
Bots can now mention users via inline mentions , without using usernames.
getChat now also returns pinned messages in supergroups, if present. Added the new field pinned_message to the Chat object.
Added the new fields author_signature and forward_signature to the Message object.
Added the new field is_bot to the User object.
Bot API 3.2 . Teach your bot to handle stickers and sticker sets .
Added new methods for working with stickers: getStickerSet , uploadStickerFile , createNewStickerSet , addStickerToSet , setStickerPositionInSet , and deleteStickerFromSet .
Added the fields set_name and mask_position to the Sticker object, plus two new objects, StickerSet , and MaskPosition .
Bot API 3.1 . Build your own robotic police force for supergoups with these new methods for admin bots:
Added new methods restrictChatMember and promoteChatMember to manage users and admins, added new parameter until_date to kickChatMember for temporary bans.
Added new methods exportChatInviteLink , setChatPhoto , deleteChatPhoto , setChatTitle , setChatDescription , pinChatMessage and unpinChatMessage to manage groups and channels.
Added the new fields photo , description and invite_link to the Chat object.
Added the new fields until_date , can_be_edited , can_change_info , can_post_messages , can_edit_messages , can_delete_messages , can_invite_users , can_restrict_members , can_pin_messages , can_promote_members , can_send_messages , can_send_media_messages , can_send_other_messages and can_add_web_page_previews to the ChatMember object.
Introducing Bot API 3.0 .
NEW Payment Platform
See Introduction to Bot Payments for a brief overview. If you're not a developer, you may like this user-friendly blog post better.
Your bot can now accept payments for goods and services via Telegram.
Added new kinds of updates , shipping_query and pre_checkout_query , and new types of message content, invoice and successful_payment .
Added new methods for payments: sendInvoice , answerShippingQuery , and answerPreCheckoutQuery .
Added a new type of button, the pay button to InlineKeyboardButton .
NEW Video Messages
As of Telegram v.4.0, users can send short rounded video messages , using an interface similar to that of voice notes.
Added the sendVideoNote method, the new field video_note to Message , the fields record_video_note or upload_video_note to sendChatAction .
NEW Multilingual Bots
The User object now may have a language_code field that contains the IETF language tag of the user's language.
Thanks to this, your bot can now offer localized responses to users that speak different languages.
More power to admin bots
unbanChatMemeber now also works in channels!
New method deleteMessage that allows the bot to delete its own messages, as well as messages posted by other in groups and channels where the bot is an administrator.
Minor Changes
Replaced the field new_chat_member in Message with new_chat_members (the old field will still be available for a while for compatibility purposes).
Inline keyboards with switch_inline_query and switch_inline_query_current_chat can no longer be sent to channels because they are useless there.
New fields gif_duration in InlineQueryResultGif and mpeg4_duration in InlineQueryResultMpeg4Gif .
Introducing Bot API 2.3.1 , a nifty little update that will give you more control over how your bot gets its updates.
Use the new field max_connections in setWebhook to optimize your bot's server load
Use allowed_updates in setWebhook and getUpdates to selectively subscribe to updates of a certain type. Among other things, this allows you to stop getting updates about new posts in channels where your bot is an admin.
deleteWebhook moved out of setWebhook to get a whole separate method for itself.
New feature: custom message filters!
New feature: custom message filters!
See https://github.com/eternnoir/pyTelegramBotAPI#custom-filters and https://github.com/eternnoir/pyTelegramBotAPI/tree/master/examples/custom_filters
One column per quarter.