unstale

pypi / python-telegram-bot

python-telegram-bot

What changed in python-telegram-bot 11 to 12, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-28.

4 breaking2 deprecations15 new APIs and options2 behavior and defaults7 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli on npm

python-telegram-bot 1210 changes

Breaking changes 3

  • Callbacks are context based in version 12, changing how developers write callbacks.

    12.0.0release notes

  • from_timestamp() now returns UTC.

    12.0.0release notes

  • Python 3.4 is no longer supported.

    12.0.0release notes

Deprecations 2

  • Arguments including edited_messages and channel_post are deprecated as part of the filter overhaul.

    12.0.0release notes

  • RegexHandler is deprecated as part of the filter overhaul.

    12.0.0release notes

New APIs and options 1

  • PrefixHandler was added as part of the handler overhaul.

    12.0.0release notes

Behavior and default changes 2

  • The Error Handler now handles all types of exceptions.

    12.0.0release notes

  • Persistence is listed as a major change in version 12.

    12.0.0release notes

Fixes and other changes 2

  • Support was added for Bot API 4.1, 4.2, and 4.3.

    12.0.0release notes

  • ConversationHandler has various changes and fixes in this release.

    12.0.0release notes

python-telegram-bot 1120 changes

Breaking changes 1

  • Passport decryption requires the cryptography dependency.

    11.0.0release notes

New APIs and options 14

  • Adds width, height, and duration to Animation.

    11.0.0release notes

  • Adds a thumb field to Audio, Video and Videonote.

    11.0.0release notes

  • Adds Bot.edit_message_media and the InputMediaAnimation, InputMediaAudio, and inputMediaDocument types.

    11.0.0release notes

  • Adds Bot.send_animation, Animation width, height, and duration fields, and Filters.animation.

    11.0.0release notes

  • Adds support for the CASHTAG message entity.

    11.0.0release notes

  • Adds a filter for messages containing Passport data.

    11.0.0release notes

  • Adds forusquare_type to Venue, InlineQueryResultVenue, InputVenueMessageContent, and Bot.send_venue.

    11.0.0release notes

  • Adds the passport_data field to Message.

    11.0.0release notes

  • Adds Telegram Passport support types, including PassportData, PassportFile, EncryptedPassportElement, EncryptedCredentials, and PassportElementError variants. PassportData can be decrypted, and PassportFiles originating from decrypted PassportData are automatically decrypted.

    11.0.0release notes

  • Adds support for the PHONE_NUMBER message entity.

    11.0.0release notes

  • Adds a bot method for setting Telegram Passport data errors.

    11.0.0release notes

  • Adds t.me links for User, Chat and Message when available, and updates User.mention_*.

    11.0.0release notes

  • Adds the thumb= argument to send_ methods to specify thumbnails for photos and videos.

    11.0.0release notes

  • Adds vCard support through a vcard field on Contact, InlineQueryResultContact, InputContactMessageContent, and Bot.send_contact.

    11.0.0release notes

Fixes and other changes 5

  • Can now send more than one media item.

    11.0.0release notes

  • Fixes Filters.regex failing on non-text messages.

    11.0.0release notes

  • Includes a minor integer comparison fix.

    11.0.0release notes

  • Fixes mention_markdown/html on Python 2.

    11.0.0release notes

  • Fixes ProcessLookupError when a process finishes before it is killed.

    11.0.0release notes