NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1465 most downloaded on PyPI
We have made you a wrapper you can't refuse
Last release 3 months ago
12 Jun 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
157 releases · first in 2015
We've just released v22.8 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.8.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2026-06-12
Disallow packages newer than last 7 days ( #5247 by @harshil21 closes #5195 )
Deprecated passing the filename parameter positionally to the classes:
InputMediaAnimation
InputMediaAudio
InputMediaPhoto
InputMediaDocument
InputMediaVideo
Please pass filename as a keyword argument instead, as this parameter will become keyword-only in the future.
Deprecated InputPollOption.de_json . The class InputPollOption is input only and its de_json method will be removed in future versions. The Bot API 10.0 media field of InputPollOption will not be included for deserialization.
( #5229 by @aelkheir closes #5228 ; #5230 by @harshil21 ; #5235 by @harshil21 ; #5238 by @harshil21 ; #5232 by @aelkheir ; #5232 by @Poolitzer , @Phil9l , @harshil21 , @aelkheir )
Full Support for Bot API 9.6
Warning
Bot API 9.6 replaces the field correct_option_id of Poll with the new field correct_option_ids . The field correct_option_id is still present in PTB for backward compatibility, but it will be removed in future releases.
Bot API 9.6 replaces the argument correct_option_id of Bot.send_poll with the new argument correct_option_ids . The argument correct_option_id is still present in PTB for backward compatibility, but it will be removed in future releases.
Bot API 9.6 introduces a now required argument persistent_id to PollOption . For backward compatibility, the argument is currently still marked as optional in the signature and its presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Bot API 9.6 introduces a now required argument option_persistent_ids to PollAnswer . For backward compatibility, the argument is currently still marked as optional in the signature and its presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Bot API 9.6 introduces a now required argument allows_revoting to Poll . For backward compatibility, the argument is currently still marked as optional in the signature and its presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Please make sure to update your code accordingly to avoid potential issues in the future. We recommend using keyword arguments to ensure compatibility with future updates.
( #5196 by @harshil21 ; #5202 by @ouyooung ; #5197 by @harshil21 )
Full Support for Bot API 10.0
Warning
Bot API 10.0 introduces a now required argument members_only to Poll . For backward compatibility, the argument is currently still marked as optional in the signature and its presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Please make sure to update your code accordingly to avoid potential issues in the future. We recommend using keyword arguments to ensure compatibility with future updates.
( #5229 by @aelkheir closes #5228 ; #5230 by @harshil21 ; #5235 by @harshil21 ; #5238 by @harshil21 ; #5232 by @aelkheir ; #5232 by @Poolitzer , @Phil9l , @harshil21 , @aelkheir )
Fixed incorrect isinstance check in class telegram.ext.filters._MergedFilter for or_filter. ( #5125 by @gistrec )
Update.effective_user now checks for channel_post and edited_channel_post ( #5237 by @karin0 closes #5236 )
Update dependency cryptography to v46.0.6 [SECURITY] ( #5185 by @renovate[bot] )
Update dependency cryptography to v46.0.7 [SECURITY] ( #5203 by @renovate[bot] )
Update codecov/codecov-action action to v5.5.4 ( #5190 by @renovate[bot] )
Make instantiation of TelegramObject ’s 15% faster ( #5250 by @harshil21 )
Support Python 3.15 Beta
Python 3.15 free threading is not fully supported yet, as the optional dependency cryptography is not yet compatible with it.
( #5259 by @harshil21 closes #5231 )
Bump Version to 22.8 ( #5262 by @Poolitzer )
Documentation Improvements ( #5240 by @harshil21 , @Poolitzer ; #5241 by @harshil21 )
Update Ruff to v0.15.7 ( #5177 by @renovate[bot] )
Migrate from deprecated test-results-action to codecov-action ( #5183 by @Krishnachaitanyakc closes #5158 )
Update Ruff to v0.15.8 ( #5184 by @renovate[bot] )
Update astral-sh/setup-uv action to v7.6.0 ( #5191 by @renovate[bot] )
Update dependency astral-sh/uv to v0.11.2 ( #5192 by @renovate[bot] )
Update dependency mypy to v1.20.0 ( #5193 by @renovate[bot] )
Update github/codeql-action action to v4.35.1 ( #5194 by @renovate[bot] )
Update Ruff to v0.15.9 ( #5198 by @renovate[bot] )
Update Mypy to v1.20.1 ( #5199 by @renovate[bot] )
Update Ruff to v0.15.10 ( #5205 by @renovate[bot] )
Update dependency pytest to v9.0.3 [SECURITY] ( #5206 by @renovate[bot] )
Update Ruff to v0.15.11 ( #5209 by @renovate[bot] )
Update Ruff to v0.15.12 ( #5217 by @renovate[bot] )
Update actions/upload-artifact action to v7.0.1 ( #5220 by @renovate[bot] )
Update dependency astral-sh/uv to v0.11.8 ( #5221 by @renovate[bot] )
Update github/codeql-action action to v4.35.2 ( #5222 by @renovate[bot] )
Update Mypy to v1.20.2 ( #5223 by @renovate[bot] )
Update jannekem/run-python-script-action action to v1.8 ( #5224 by @renovate[bot] )
Update Ruff to v0.15.13 ( #5233 by @renovate[bot] )
Update Ruff to v0.15.14 ( #5245 by @renovate[bot] )
Update Ruff to v0.15.15 ( #5252 by @renovate[bot] )
Update dependency astral-sh/uv to v0.11.16 ( #5253 by @renovate[bot] )
Update dependency sphinxcontrib-mermaid to v2.0.2 ( #5254 by @renovate[bot] )
Update actions/stale action to v10.3.0 ( #5255 by @renovate[bot] )
Update github/codeql-action action to v4.36.0 ( #5256 by @renovate[bot] )
Update pypa/gh-action-pypi-publish action to v1.14.0 ( #5257 by @renovate[bot] )
One column per quarter.
We've just released v22.7 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.7.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2026-03-16
Hand over Maintainer Role from Bibo-Joshi to Poolitzer and Harshil ( #5119 by @Bibo-Joshi )
Remove Functionality Deprecated in Bot API 9.3
Remove deprecated argument and attribute UniqueGiftInfo.last_resale_star_count .
Remove deprecated argument and attribute Bot.get_business_account_gifts.exclude_limited .
telegram.UniqueGift.gift_id is now a positional argument.
( #5143 by @harshil21 closes #5093 )
Full Support for Bot API 9.4 ( #5137 by @harshil21 ; #5133 by @ouyooung ; #5141 by @hethon ; #5129 by @Poolitzer ; #5148 by @harshil21 )
Full support for Bot API 9.5 ( #5155 by @Poolitzer )
Preserve InlineKeyboardButton Arguments During callback_data Replacement ( #5159 by @harshil21 )
Update dependency cryptography to v46.0.5 [SECURITY] ( #5125 by @renovate[bot] )
Update dependency tornado to v6.5.5 [SECURITY] ( #5164 by @renovate[bot] )
Fixing failing sphinx builds ( #5124 by @Poolitzer )
Fix: Moved inline test file to _inline folder ( #5140 by @Poolitzer )
Update astral-sh/setup-uv action to v7.5.0 ( #5170 by @renovate[bot] )
Bump Version to v22.7 ( #5176 by @harshil21 )
Update Ruff to v0.14.14 ( #5110 by @renovate[bot] )
Update codecov/codecov-action action to v5.5.2 ( #5112 by @renovate[bot] )
Update dependency astral-sh/uv to v0.9.28 ( #5113 by @renovate[bot] )
Update dependency pytest to v9.0.2 ( #5114 by @renovate[bot] )
Update actions/setup-python action to v6.2.0 ( #5115 by @renovate[bot] )
Update astral-sh/setup-uv action to v7.2.1 ( #5116 by @renovate[bot] )
Update pre-commit hook cachetools to v7 ( #5117 by @renovate[bot] )
Update Ruff to v0.15.0 ( #5122 by @renovate[bot] )
Update Ruff to v0.15.0 ( #5122 by @renovate[bot] )
Update Ruff to v0.15.1 ( #5135 by @renovate[bot] )
Replace pre-commit with prek ( #5142 by @harshil21 closes #5138 )
Update Pylint to v4.0.5 ( #5145 by @renovate[bot] )
Update Ruff to v0.15.2 ( #5146 by @renovate[bot] )
Update Ruff to v0.15.4 ( #5150 by @renovate[bot] )
Update actions/stale action to v10.2.0 ( #5151 by @renovate[bot] )
Update astral-sh/setup-uv action to v7.3.1 ( #5152 by @renovate[bot] )
Update codecov/test-results-action action to v1.2.1 ( #5153 by @renovate[bot] )
Update dependency astral-sh/uv to v0.10.7 ( #5154 by @renovate[bot] )
Update Ruff to v0.15.5 ( #5156 by @renovate[bot] )
Make CI run after chango commits ( #5157 by @harshil21 closes #5144 )
Refactor TestStickerSetWithRequest tests ( #5161 by @harshil21 closes #4514 )
Update Ruff to v0.15.6 ( #5166 by @renovate[bot] )
Update dependency sphinx to v9 ( #5167 by @renovate[bot] )
Bump Sphinx Related Dependencies, Fix uv and Docs Build ( #5168 by @harshil21 )
Update dependency astral-sh/uv to v0.10.10 ( #5169 by @renovate[bot] )
Update GitHub Artifact Actions (major) ( #5171 by @renovate[bot] )
Update sigstore/gh-action-sigstore-python action to v3.2.0 ( #5172 by @renovate[bot] )
Update stefanzweifel/git-auto-commit-action action to v7.1.0 ( #5173 by @renovate[bot] )
Update actions/checkout action to v6 ( #5174 by @renovate[bot] )
Lock file maintenance ( #5175 by @renovate[bot] )
We've just released v22.6 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.6.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2026-01-24
Full Support for Bot API 9.3
Warning
Bot API 9.3 deprecates the field last_resale_star_count of UniqueGiftInfo in favor of the new fields last_resale_currency and last_resale_amount . The field last_resale_star_count is still present in PTB for backward compatibility, but it will be removed in future releases. Please update your code accordingly.
Bot API 9.3 deprecates the argument exclude_limited of Bot.get_business_account_gifts in favor of the new arguments exclude_limited_upgradable and exclude_limited_non_upgradable . The argument exclude_limited is still present in PTB for backward compatibility, but it will be removed in future releases. Please update your code accordingly.
Bot API 9.3 introduces a now required argument gift_id to UniqueGift . For backward compatibility, the argument is currently still marked as optional in the signature and it’s presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Please make sure to update your code accordingly to avoid potential issues in the future. We recommend using keyword arguments to ensure compatibility with future updates.
( #5086 by @Bibo-Joshi ; #5078 by @aelkheir closes #5077 ; #5079 by @aelkheir ; #5084 by @Bibo-Joshi ; #5085 by @Bibo-Joshi ; #5087 by @Bibo-Joshi ; #5091 by @Bibo-Joshi ; #5090 by @Bibo-Joshi ; #5089 by @Bibo-Joshi ; #5092 by @Bibo-Joshi ; #5095 by @Bibo-Joshi ; #5094 by @Bibo-Joshi ; #5106 by @aelkheir )
Add Fallback Name Support for Job Callbacks without name ( #5088 by @SmartDever02 closes #4992 )
Fix a Bug in Initialization Logic of Bot ( #5030 by @codomposer closes #5021 )
Remove Support for Python 3.9 ( #4827 by @harshil21 )
Bump Version to v22.6 ( #5108 by @Bibo-Joshi )
Documentation Improvements. Among others, fix dead links. ( #4988 by @Bibo-Joshi )
Update Copyright to 2026 ( #5075 by @Bibo-Joshi )
Fix Broken Links in Documentation ( #5080 by @calm329 closes #5074 )
Lock file maintenance ( #4980 by @renovatebot )
Update github/codeql-action action to v3.30.6 ( #4984 by @renovatebot )
Update Ruff to v0.13.3 ( #4985 by @renovatebot )
Update actions/stale action to v10.1.0 ( #4986 by @renovatebot )
Update astral-sh/setup-uv action to v6.8.0 ( #4987 by @renovatebot )
Update dependency astral-sh/uv to v0.8.23 ( #4989 by @renovatebot )
Update configuration of actions/stale to use issue types instead of labels ( #4990 by @Bibo-Joshi )
Update github/codeql-action action to v3.30.8 ( #4994 by @renovatebot )
Update Pylint to v3.3.9 ( #4995 by @renovatebot )
Update dependency astral-sh/uv to v0.9.2 ( #4996 by @renovatebot )
Update Ruff to v0.14.0 ( #4997 by @renovatebot )
Update astral-sh/setup-uv action to v7 ( #4998 by @renovatebot )
Update github/codeql-action action to v4 ( #4999 by @renovatebot )
Update Pylint to v4 (major) ( #5000 by @renovatebot )
Update stefanzweifel/git-auto-commit-action action to v7 ( #5001 by @renovatebot )
Update astral-sh/setup-uv action to v7.1.0 ( #5002 by @renovatebot )
Use Python 3.14 Final in the Test Suite ( #5004 by @harshil21 )
Add Freethreaded Python 3.14 to the Test Suite ( #5006 by @harshil21 )
Make chango Commit Re-Trigger Workflows ( #5007 by @Bibo-Joshi )
Temporarily disable actions/stale due to a bug with only-issue-types . ( #5008 by @Bibo-Joshi )
Re-Enable actions/stale Workflow ( #5009 by @Bibo-Joshi )
Update dependency astral-sh/uv to v0.9.3 ( #5011 by @renovatebot )
Update github/codeql-action action to v4.30.9 ( #5012 by @renovatebot )
Update Ruff to v0.14.1 ( #5013 by @renovatebot )
Update dependency chango to ~=0.6.0 ( #5014 by @renovatebot )
Update dependency astral-sh/uv to v0.9.4 ( #5015 by @renovatebot )
Update astral-sh/setup-uv action to v7.1.1 ( #5016 by @renovatebot )
Update dependency astral-sh/uv to v0.9.5 ( #5022 by @renovatebot )
Update Pylint to v4.0.2 ( #5023 by @renovatebot )
Update Ruff to v0.14.2 ( #5024 by @renovatebot )
Update github/codeql-action action to v4.31.0 ( #5025 by @renovatebot )
Update sigstore/gh-action-sigstore-python action to v3.1.0 ( #5026 by @renovatebot )
Update GitHub Artifact Actions (major) ( #5027 by @renovatebot )
Update astral-sh/setup-uv action to v7.1.2 ( #5029 by @renovatebot )
Update dependency astral-sh/uv to v0.9.7 ( #5032 by @renovatebot )
Update github/codeql-action action to v4.31.2 ( #5033 by @renovatebot )
Update Ruff to v0.14.3 ( #5034 by @renovatebot )
Lock file maintenance ( #5035 by @renovatebot )
Update dependency astral-sh/uv to v0.9.8 ( #5040 by @renovatebot )
Update Ruff to v0.14.4 ( #5041 by @renovatebot )
Update dependency pytest to v9 ( #5042 by @renovatebot )
Reduce Frequence of Renovate Updates for Development Dependencies ( #5044 by @Bibo-Joshi )
Update Pylint to v4.0.3 ( #5048 by @renovatebot )
Update Ruff to v0.14.5 ( #5049 by @renovatebot )
Stabilize some unit tests ( #5050 by @Bibo-Joshi )
Update Ruff to v0.14.6 ( #5055 by @renovatebot )
Update Ruff to v0.14.7 ( #5056 by @renovatebot )
Update Pylint to v4.0.4 ( #5057 by @renovatebot )
Update actions/checkout action to v5.0.1 ( #5058 by @renovatebot )
Update astral-sh/setup-uv action to v7.1.4 ( #5059 by @renovatebot )
Update dependency astral-sh/uv to v0.9.13 ( #5060 by @renovatebot )
Update dependency pytest to v9.0.1 ( #5061 by @renovatebot )
Update github/codeql-action action to v4.31.5 ( #5062 by @renovatebot )
Update Ruff to v0.14.8 ( #5067 by @renovatebot )
Update Ruff to v0.14.9 ( #5068 by @renovatebot )
Update Ruff to v0.14.10 ( #5070 by @renovatebot )
Bump pre-commit Hooks to Latest VErsion ( #5083 by @pre-commit-ci , @Bibo-Joshi )
Update Ruff to v0.14.11 ( #5100 by @renovatebot )
Bump chango to 0.6.1 ( #5101 by @Bibo-Joshi )
Update Ruff to v0.14.13 ( #5107 by @renovatebot )
We've just released v22.5 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.5.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-09-27
Move param ReplyParameters.checklist_task_id to last position.
Hint
This change addresses a breaking change accidentally introduced in version 22.4 where the introduction of the new parameter was not done in a backward compatible way.
Existing code using keyword arguments is unaffected. Only code using positional arguments (and based on version 22.4) may need updates.
( #4972 by @aelkheir )
Add convenience methods for BusinessOpeningHours :
get_opening_hours_for_day : returns the opening hours applicable for a specific date
is_open : indicates whether the business is open at the specified date and time.
( #4861 by @Aweryc closes #4194 )
Fix Handling of Infinite Bootstrap Retries in Application.run_* and Updater.start_* ( #4973 by @Bibo-Joshi closes #4966 )
Bump Version to v22.5 ( #4979 by @Bibo-Joshi )
Documentation Improvemennts ( #4974 by @Bibo-Joshi )
Lock file maintenance ( #4938 by @renovatebot )
Update astral-sh/setup-uv digest to b75a909 ( #4943 by @renovatebot )
Update codecov/codecov-action action to v5.5.1 ( #4944 by @renovatebot )
Update dependency astral-sh/uv to v0.8.17 ( #4945 by @renovatebot )
Update github/codeql-action action to v3.30.3 ( #4946 by @renovatebot )
Update Pylint to v3.3.8 ( #4947 by @renovatebot )
Update Chango to v0.5.0 ( #4948 by @renovatebot )
Update Mypy to v1.18.1 ( #4949 by @renovatebot )
Align pre-commit hook APScheduler to with pyproject.toml ( #4950 by @renovatebot , @Bibo-Joshi )
Align pre-commit hook cachetools to with pyproject.toml ( #4951 by @renovatebot , @Bibo-Joshi )
Update pypa/gh-action-pypi-publish action to v1.13.0 ( #4952 by @renovatebot )
Renovate: No README updates, label behaviour change, automerge lockfiles ( #4953 by @harshil21 )
Lock file maintenance ( #4954 by @renovatebot )
Lock file maintenance ( #4955 by @renovatebot )
Update astral-sh/setup-uv digest to 208b0c0 ( #4958 by @renovatebot )
Update dependency astral-sh/uv to v0.8.19 ( #4959 by @renovatebot )
Update Mypy to v1.18.2 ( #4960 by @renovatebot )
Update astral-sh/setup-uv action to v6.7.0 ( #4961 by @renovatebot )
Update Ruff to v0.13.1 ( #4962 by @renovatebot )
Update actions/stale action to v10 ( #4964 by @renovatebot )
Properly Pin Dependency to astral/setup-uv in Copilot Setup Steps ( #4965 by @Bibo-Joshi )
Lock file maintenance ( #4967 by @renovatebot )
Tune Renovate Configuration ( #4968 by @harshil21 )
Update dependency astral-sh/uv to v0.8.22 ( #4975 by @renovatebot )
Update github/codeql-action action to v3.30.5 ( #4976 by @renovatebot )
Update Ruff to v0.13.2 ( #4977 by @renovatebot )
Update dependency furo to v2025.9.25 ( #4978 by @renovatebot )
We've just released v22.4 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.4.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-09-13
Extend telegram.Message.delete() shortcut to support business message deletion ( #4869 by @jainamoswal closes #4867 )
Add convenience properties for firstname , lastname , and username to SharedUser and ChatShared ( #4881 by @aelkheir ; #4713 by @david-shiko )
Add filters.FORUM to filter messages from forum topic chats ( #4906 by @harshil21 )
Full Support for Bot API 9.2 ( #4911 by @aelkheir closes #4910 ; #4918 by @Poolitzer ; #4917 by @Poolitzer ; #4914 by @harshil21 ; #4916 by @harshil21 ; #4912 by @aelkheir ; #4921 by @aelkheir ; #4936 by @Bibo-Joshi ; #4935 by @Bibo-Joshi ; #4931 by @aelkheir )
Adapt logic on getting the event loop in Application.run_polling/webhook to Python 3.14 ( #4875 by @harshil21 closes #4874 )
Fix ResourceWarning when passing pathlib.Path objects to methods which accept file input ( #4908 by @harshil21 closes #4907 )
Update cachetools requirement from <6.2.0,>=5.3.3 to >=5.3.3,<6.3.0 ( #4923 by @dependabot )
Set the default connection pool size for HTTPXRequest to 256 to allow more concurrent requests by default. Drop the httpx parameter max_keepalive_connections . This way, the httpx default of 20 is used, leading to a smaller number of idle connections in large connection pools.
Hint
If you manually build the HTTPXRequest objects, please be aware that these changes also applies to you. Kindly double check your settings. To specify custom limits, you can set them via the parameter httpx_kwargs of HTTPXRequest . See also the httpx documentation for more details on these settings.”
( #4882 by @Poolitzer )
Bump Version to v22.4 ( #4939 by @Bibo-Joshi )
Documentation Improvements ( #4878 by @Bibo-Joshi ; #4872 by @Ca5parAD )
Bump furo from 2024.8.6 to 2025.7.19 ( #4894 by @dependabot )
Address Failing Unit Test for send_paid_media ( #4879 by @Bibo-Joshi )
Improve Internal Logic for Network Retries ( #4880 by @Bibo-Joshi closes #4871 )
Introduce utility module _utils.usernames refactoring convenience properties around Telegram Objects’ firstname , lastname , and username ( #4881 by @aelkheir ; #4713 by @david-shiko )
Add Copilot Instructions and Setup Steps ( #4884 by @harshil21 )
Remove black , isort , flake8 , and pyupgrade in favor of ruff ( #4886 by @harshil21 )
Use Renovate to Keep Dependencies Up-To-Date ( #4887 by @renovatebot )
Add and use a uv.lock lockfile when setting up the development environment using uv . ( #4890 by @harshil21 closes #4796 )
Bump pytest from 8.4.0 to 8.4.1 ( #4892 by @dependabot )
Bump pytest-xdist from 3.6.1 to 3.8.0 ( #4893 by @dependabot )
Bump astral-sh/setup-uv from 6.3.1 to 6.4.3 ( #4895 by @dependabot )
Bump github/codeql-action from 3.29.2 to 3.29.5 ( #4896 by @dependabot )
Don’t update uv.lock in copilot runtime environment ( #4915 by @harshil21 )
Bump actions/checkout from 4.2.2 to 5.0.0 ( #4925 by @dependabot )
Bump codecov/codecov-action from 5.4.3 to 5.5.0 ( #4926 by @dependabot )
Bump actions/download-artifact from 4.3.0 to 5.0.0 ( #4927 by @dependabot )
Bump astral-sh/setup-uv from 6.4.3 to 6.6.1 ( #4928 by @dependabot )
Bump github/codeql-action from 3.29.7 to 3.30.0 ( #4929 by @dependabot )
Bump pytest from 8.4.1 to 8.4.2 ( #4933 by @dependabot )
Use Tagged Release of pydantic in Development Dependencies ( #4934 by @harshil21 closes #4932 )
We've just released v22.3 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.3.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-07-20
Full Support for Bot API 9.1 ( #4847 by @Bibo-Joshi closes #4845 ; #4848 by @Bibo-Joshi ; #4849 by @harshil21 ; #4851 by @harshil21 ; #4857 by @aelkheir )
Remove Functionality Deprecated in API 9.0
Remove deprecated argument and attribute BusinessConnection.can_reply .
Remove deprecated argument and attribute ChatFullInfo.can_send_gift
Remove deprecated class constants.StarTransactions . Please instead use telegram.constants.Nanostar.VALUE .
Remove deprecated attributes constants.StarTransactionsLimit.NANOSTAR_MIN_AMOUNT and constants.StarTransactionsLimit.NANOSTAR_MAX_AMOUNT . Please instead use telegram.constants.NanostarLimit.MIN_AMOUNT and telegram.constants.NanostarLimit.MAX_AMOUNT .
( #4852 by @aelkheir )
New filters based on Bot API 9.1:
filters.StatusUpdate.DIRECT_MESSAGE_PRICE_CHANGED for Message.direct_message_price_changed
filters.StatusUpdate.CHECKLIST_TASKS_ADDED for Message.checklist_tasks_added
filters.StatusUpdate.CHECKLIST_TASKS_DONE for Message.checklist_tasks_done
filters.CHECKLIST for Message.checklist
( #4847 by @Bibo-Joshi closes #4845 ; #4848 by @Bibo-Joshi ; #4849 by @harshil21 ; #4851 by @harshil21 ; #4857 by @aelkheir )
Make Gender Input Case-Insensitive in conversationbot.py ( #4855 by @fengxiaohu closes #4846 )
Bump Version to v22.3 ( #4870 by @Bibo-Joshi )
Documentation Improvements. Among others, fix links to source code. ( #4839 by @aelkheir closes #4838 )
Update API Token for Local Testing Bot ( #4837 by @Bibo-Joshi )
Bump stefanzweifel/git-auto-commit-action from 5.2.0 to 6.0.1 ( #4840 by @dependabot )
Bump github/codeql-action from 3.28.18 to 3.29.2 ( #4841 by @dependabot )
Bump astral-sh/setup-uv from 5.4.1 to 6.3.1 ( #4842 by @dependabot )
Bump sigstore/gh-action-sigstore-python from 3.0.0 to 3.0.1 ( #4843 by @dependabot )
Bump pre-commit Hooks to Latest Versions ( #4858 by @pre-commit-ci )
We've just released v22.2 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.2.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-06-29
In this release, we’re migrating attributes of Telegram objects that represent durations/time periods from having int type to Python’s native datetime.timedelta . This change is opt-in for now to allow for a smooth transition phase. It will become opt-out in future releases.
Set PTB_TIMEDELTA=true or PTB_TIMEDELTA=1 as an environment variable to make these attributes return datetime.timedelta objects instead of integers. Support for int values is deprecated and will be removed in a future major version.
Affected Attributes:
telegram.ChatFullInfo.slow_mode_delay and telegram.ChatFullInfo.message_auto_delete_time
telegram.Animation.duration
telegram.Audio.duration
telegram.Video.duration and telegram.Video.start_timestamp
telegram.VideoNote.duration
telegram.Voice.duration
telegram.PaidMediaPreview.duration
telegram.VideoChatEnded.duration
telegram.InputMediaVideo.duration
telegram.InputMediaAnimation.duration
telegram.InputMediaAudio.duration
telegram.InputPaidMediaVideo.duration
telegram.InlineQueryResultGif.gif_duration
telegram.InlineQueryResultMpeg4Gif.mpeg4_duration
telegram.InlineQueryResultVideo.video_duration
telegram.InlineQueryResultAudio.audio_duration
telegram.InlineQueryResultVoice.voice_duration
telegram.InlineQueryResultLocation.live_period
telegram.Poll.open_period
telegram.Location.live_period
telegram.MessageAutoDeleteTimerChanged.message_auto_delete_time
telegram.ChatInviteLink.subscription_period
telegram.InputLocationMessageContent.live_period
telegram.error.RetryAfter.retry_after
( #4750 by @aelkheir closes #4575 )
Use timedelta to represent time periods in class arguments and attributes ( #4750 by @aelkheir closes #4575 )
Fixed a bug where calling Application.remove/add_handler during update handling can cause a RuntimeError in Application.process_update .
Hint
Calling Application.add/remove_handler now has no influence on calls to process_update that are
already in progress. The same holds for Application.add/remove_error_handler and Application.process_error , respectively.
Warning
This behavior should currently be considered an implementation detail and not as guaranteed behavior.
( #4802 by @Bibo-Joshi closes #4803 )
Allow for pattern matching empty inline queries ( #4817 by @locobott )
Correctly parse parameter allow_sending_without_reply in Message.reply_* when used in combination with do_quote=True .
Hint
Using dict valued input for do_quote along with passing allow_sending_without_reply is not supported and will raise an error.
( #4818 by @Bibo-Joshi closes #4807 )
Implement PEP 735 Dependency Groups for Development Dependencies ( #4800 by @harshil21 closes #4795 )
Update cachetools requirement from <5.6.0,>=5.3.3 to >=5.3.3,<6.1.0 ( #4801 by @dependabot )
Bump httpx from ~=0.27 to >=0.27,<0.29 ( #4820 by @Bibo-Joshi closes #4819 )
Update cachetools requirement from <6.1.0,>=5.3.3 to >=5.3.3,<6.2.0 ( #4830 by @dependabot )
Improve Informativeness of Network Errors Raised by BaseRequest.post/retrieve ( #4822 by @Bibo-Joshi )
Add Python 3.14 Beta To Test Matrix. Python 3.14 is not officially supported by PTB yet! ( #4825 by @harshil21 )
Bump Version to v22.2 ( #4834 by @Bibo-Joshi )
Documentation Improvements. Among other things
mention alternative package managers in README and contribution guide
remove furo-sphinx-search
( #4810 by @Bibo-Joshi ; #4824 by @Aweryc closes #4823 ; #4826 by @harshil21 )
Modify test_official to handle time periods as timedelta automatically. ( #4750 by @aelkheir closes #4575 )
Fix Bug in Automated Channel Announcement ( #4792 by @Bibo-Joshi )
Fix a Failing Test Case ( #4793 by @Bibo-Joshi )
Rework Repository to src Layout ( #4798 by @Bibo-Joshi closes #4797 )
Bump github/codeql-action from 3.28.16 to 3.28.18 ( #4811 by @dependabot )
Bump actions/setup-python from 5.5.0 to 5.6.0 ( #4812 by @dependabot )
Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 ( #4813 by @dependabot )
Bump codecov/codecov-action from 5.4.2 to 5.4.3 ( #4814 by @dependabot )
Bump codecov/test-results-action from 1.1.0 to 1.1.1 ( #4815 by @dependabot )
Fix Typo in TelegramObject._get_attrs ( #4816 by @harshil21 )
We've just released v22.1 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.1.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-05-15
Drop backward compatibility for user_id in send_gift by updating the order of parameters. Please adapt your code accordingly or use keyword arguments. ( #4692 by @Bibo-Joshi )
This release comes with several deprecations, in line with our stability policy .
This includes the following:
Deprecated telegram.constants.StarTransactionsLimit.NANOSTAR_MIN_AMOUNT and telegram.constants.StarTransactionsLimit.NANOSTAR_MAX_AMOUNT . These members will be replaced by telegram.constants.NanostarLimit.MIN_AMOUNT and telegram.constants.NanostarLimit.MAX_AMOUNT .
Deprecated the class telegram.constants.StarTransactions . Its only member telegram.constants.StarTransactions.NANOSTAR_VALUE will be replaced by telegram.constants.Nanostar.VALUE .
Bot API 9.0 deprecated BusinessConnection.can_reply in favor of BusinessConnection.rights
Bot API 9.0 deprecated ChatFullInfo.can_send_gift in favor of ChatFullInfo.accepted_gift_types .
Bot API 9.0 introduced these new required fields to existing classes:
TransactionPartnerUser.transaction_type
ChatFullInfo.accepted_gift_types
Passing these values as positional arguments is deprecated. We encourage you to use keyword arguments instead, as the the signature will be updated in a future release.
These deprecations are backward compatible, but we strongly recommend to update your code to use the new members.
( #4756 by @Bibo-Joshi closes #4754 ; #4757 by @Bibo-Joshi ; #4759 by @Bibo-Joshi ; #4763 by @aelkheir ; #4766 by @Bibo-Joshi ; #4769 by @aelkheir ; #4773 by @aelkheir ; #4781 by @aelkheir ; #4782 by @Bibo-Joshi )
Full Support for Bot API 9.0 ( #4756 by @Bibo-Joshi closes #4754 ; #4757 by @Bibo-Joshi ; #4759 by @Bibo-Joshi ; #4763 by @aelkheir ; #4766 by @Bibo-Joshi ; #4769 by @aelkheir ; #4773 by @aelkheir ; #4781 by @aelkheir ; #4782 by @Bibo-Joshi )
Ensure execution of Bot.shutdown() even if Bot.get_me() fails in Bot.initialize() ( #4733 by @Poolitzer )
Fix Handling of Defaults for InputPaidMedia ( #4761 by @ngrogolev closes #4753 )
Bump Version to v22.1 ( #4791 by @Bibo-Joshi )
Documentation Improvements. Among others, add missing Returns field in User.get_profile_photos ( #4730 by @Bibo-Joshi ; #4740 by @aelkheir )
Update AUTHORS.rst , Adding @aelkheir to Active Development Team ( #4747 by @Bibo-Joshi )
Clarify Documentation and Type Hints of InputMedia and InputPaidMedia . Note that the media parameter accepts only objects of type str and InputFile . The respective subclasses of Input(Paid)Media each accept a broader range of input type for the media parameter. ( #4762 by @Bibo-Joshi )
Bump codecov/test-results-action from 1.0.2 to 1.1.0 ( #4741 by @dependabot )
Bump actions/setup-python from 5.4.0 to 5.5.0 ( #4742 by @dependabot )
Bump github/codeql-action from 3.28.10 to 3.28.13 ( #4743 by @dependabot )
Bump astral-sh/setup-uv from 5.3.1 to 5.4.1 ( #4744 by @dependabot )
Bump actions/download-artifact from 4.1.8 to 4.2.1 ( #4745 by @dependabot )
Reenable test_official Blocked by Debug Remnant ( #4746 by @aelkheir )
Bump pre-commit Hooks to Latest Versions ( #4748 by @pre-commit-ci )
Fine-tune chango and release workflows ( #4758 by @Bibo-Joshi closes #4720 )
Bump codecov/codecov-action from 5.1.2 to 5.4.2 ( #4775 by @dependabot )
Bump actions/upload-artifact from 4.5.0 to 4.6.2 ( #4776 by @dependabot )
Bump stefanzweifel/git-auto-commit-action from 5.1.0 to 5.2.0 ( #4777 by @dependabot )
Bump github/codeql-action from 3.28.13 to 3.28.16 ( #4778 by @dependabot )
Bump actions/download-artifact from 4.2.1 to 4.3.0 ( #4779 by @dependabot )
We've just released v22.0 . Thank you to everyone who contributed to this release. As usual, upgrade using pip install -U python-telegram-bot .
We've just released v22.0.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.
The release notes can be found here.
2025-03-15
This release removes all functionality that was deprecated in v20.x. This is in line with our stability policy .
This includes the following changes:
Removed filters.CHAT (all messages have an associated chat) and filters.StatusUpdate.USER_SHARED (use filters.StatusUpdate.USERS_SHARED instead).
Removed Defaults.disable_web_page_preview and Defaults.quote . Use Defaults.link_preview_options and Defaults.do_quote instead.
Removed ApplicationBuilder.(get_updates_)proxy_url and HTTPXRequest.proxy_url . Use ApplicationBuilder.(get_updates_)proxy and HTTPXRequest.proxy instead.
Removed the timeout arguments of Application.run_polling and Updater.start_webhook . Instead, specify the values via ApplicationBuilder.get_updates_timeout .
Removed constants.InlineQueryLimit.MIN_SWITCH_PM_TEXT_LENGTH . Use constants.InlineQueryResultsButtonLimit.MAX_START_PARAMETER_LENGTH instead.
Removed the argument quote of Message.reply_* . Use do_quote instead.
Removed the superfluous EncryptedPassportElement.credentials without replacement.
Changed attribute value of PassportFile.file_date from int to datetime.datetime . Make sure to adjust your code accordingly.
Changed the attribute value of PassportElementErrors.file_hashes from list to tuple . Make sure to adjust your code accordingly.
Make BaseRequest.read_timeout an abstract property. If you subclass BaseRequest , you need to implement this property.
The default value for write_timeout now defaults to DEFAULT_NONE also for bot methods that send media. Previously, it was 20 . If you subclass BaseRequest , make sure to use your desired write timeout if RequestData.multipart_data is set.
( #4671 by @Bibo-Joshi closes #4659 )
Add chango As Changelog Management Tool ( #4672 by @Bibo-Joshi closes #4321 )
Bump github/codeql-action from 3.28.8 to 3.28.10 ( #4697 by @dependabot )
Bump srvaroa/labeler from 1.12.0 to 1.13.0 ( #4698 by @dependabot )
Bump astral-sh/setup-uv from 5.2.2 to 5.3.1 ( #4699 by @dependabot )
Bump Bibo-Joshi/chango from 0.3.1 to 0.3.2 ( #4700 by @dependabot )
Bump pypa/gh-action-pypi-publish from 1.12.3 to 1.12.4 ( #4701 by @dependabot )
Bump pytest from 8.3.4 to 8.3.5 ( #4709 by @dependabot )
Bump sphinx from 8.1.3 to 8.2.3 ( #4710 by @dependabot )
Bump Bibo-Joshi/chango from 0.3.2 to 0.4.0 ( #4712 by @Bibo-Joshi )
Bump Version to v22.0 ( #4719 by @Bibo-Joshi )
This is the technical changelog for version 21.11.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel .
Released 2025-03-01
This is the technical changelog for version 21.11.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Remove Deprecated InlineQueryResultArticle.hide_url (#4640 closes #4638)
Released 2025-03-01
This is the technical changelog for version 21.11. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
provider_token Argument Optional (#4689)InlineQueryResultArticle.hide_url (#4640 closes #4638)datetime.timedelta Input in Bot Method Parameters (#4651)Bot.base_(file_)url (#4632 closes #3355)allow_paid_broadcast in AIORateLimiter (#4627 closes #4578)BaseUpdateProcessor.current_concurrent_updates (#4626 closes #3984)Application.run_* (#4673 closes #4657)edit_user_star_subscription (#4681 by @vavasik800)TelegramObject.de_json and Friends (#4617 closes #4614)pre-commit Hooks to Latest Versions (#4643)TelegramObject Classes with Subclasses (#4654 closes #4652)actions/setup-python from 5.3.0 to 5.4.0 (#4665)dependabot/fetch-metadata from 2.2.0 to 2.3.0 (#4666)actions/stale from 9.0.0 to 9.1.0 (#4667)astral-sh/setup-uv from 5.1.0 to 5.2.2 (#4664)codecov/test-results-action from 1.0.1 to 1.0.2 (#4663)Bump apscheduler & Deprecate pytz Support
Released 2025-01-03
This is the technical changelog for version 21.10. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
apscheduler & Deprecate pytz Support (#4582)pattern to JobQueue.jobs() (#4613 closes #4544)Sticker for Several Methods (#4616 closes #4580)Gift and Gifts (#4634 closes #4637)dependabot PRs (#4621)pylint Suppressions (#4628)datetime Imports (#4605 by @cuevasrja closes #4577)astral-sh/setup-uv from 4.2.0 to 5.1.0 (#4625)codecov/codecov-action from 5.1.1 to 5.1.2 (#4622)actions/upload-artifact from 4.4.3 to 4.5.0 (#4623)github/codeql-action from 3.27.9 to 3.28.0 (#4624)This is the technical changelog for version 21.9. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-12-07
This is the technical changelog for version 21.9. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
MessageLimit.DEEP_LINK_LENGTH in helpers.create_deep_linked_url (#4597 by @nemacysts)Sequence Input for allowed_updates in Application and Updater Methods (#4589 by @nemacysts)aiolimiter requirement from ~=1.1.0 to >=1.1,<1.3 (#4595)pytest from 8.3.3 to 8.3.4 (#4596)codecov/codecov-action from 4 to 5 (#4585)pylint to v3.3.2 to Improve Python 3.13 Support (#4590 by @nemacysts)srvaroa/labeler from 1.11.1 to 1.12.0 (#4586)This is the technical changelog for version 21.8. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-12-01
This is the technical changelog for version 21.8. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
This is the technical changelog for version 21.7. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-11-04
This is the technical changelog for version 21.7. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Message.reply_paid_media (#4551)Sequence in Application.add_handlers (#4531 by @roast-lord closes #4530)File.download_* (#4542)sphinx-build-compatibility to Keep Sphinx Compatibility (#4492)Message Fixtures (#4507)pytest-xdist Usage (#4491)Bot Tests (#4489)conftest.py for File Related Tests (#4488)srvaroa/labeler from 1.11.0 to 1.11.1 (#4549)sphinx from 8.0.2 to 8.1.3 (#4532)sphinxcontrib-mermaid from 0.9.2 to 1.0.0 (#4529)srvaroa/labeler from 1.10.1 to 1.11.0 (#4509)Bibo-Joshi/pyright-type-completeness from 1.0.0 to 1.0.1 (#4510)This is the technical changelog for version 21.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-09-19
This is the technical changelog for version 21.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
httpx_kwargs to HTTPXRequest (#4451 closes #4424)offline_bot Fixture in Test*WithoutRequest (#4465)telegram.ext Independent of Networking (#4454)pytest from 8.3.2 to 8.3.3 (#4475)This is the technical changelog for version 21.5. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-09-01
This is the technical changelog for version 21.5. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
MessageEntity.shift_entities and MessageEntity.concatenate (#4376 closes #4372)game_pattern to CallbackQueryHandler (#4353 by @jainamoswal closes #4269)read_file_handle to InputFile (#4388 closes #4339)RequestData Members (#4396)Updater Network Loop (#4432 by @MartinHjelmare)test_message.py (#4431 by @Palaptin)ruff and Add New Rules (#4416)cachetools requirement from <5.5.0,>=5.3.3 to >=5.3.3,<5.6.0 (#4437)sphinx from 7.4.7 to 8.0.2 and furo from 2024.7.18 to 2024.8.6 (#4412)test-summary/action from 2.3 to 2.4 (#4410)pytest from 8.2.2 to 8.3.2 (#4403)dependabot/fetch-metadata from 2.1.0 to 2.2.0 (#4411)cachetools requirement from ~=5.3.3 to >=5.3.3,<5.5.0 (#4390)sphinx from 7.3.7 to 7.4.7 (#4395)furo from 2024.5.6 to 2024.7.18 (#4392)Deprecate Inclusion of successful_payment in Message.effective_attachment (#4365 closes #4350)
Released 2024-07-12
This is the technical changelog for version 21.4. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
python-telegram-bot-raw And Switch to pyproject.toml Based Packaging (#4288 closes #4129 and #4296)successful_payment in Message.effective_attachment (#4365 closes #4350)filters.PAID_MEDIA (#4357)MessageEntity.adjust_message_entities_to_utf_16 Utility Function (#4323 by Antares0982 closes #4319)bot of TelegramObject.de_json Optional (#4320)mise-en-place to .gitignore (#4300)MenuButton (#4363)SuccessfulPayment Test (#4349)test_stars.py (#4347)ruff and Add New Rules (#4329)pre-commit Hooks to Latest Versions (#4337)flaky Dependency (#4322 by Palaptin)pytest from 8.2.1 to 8.2.2 (#4294)Deprecate python-telegram-bot-raw
Released 2024-06-07
This is the technical changelog for version 21.3. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
python-telegram-bot-raw (#4270)chat_id to ChatMemberHandler (#4290 by uniquetrij closes #4287)setuptools to requirements-dev.txt (#4282)pytest from 8.2.0 to 8.2.1 (#4272)Remove Functionality Deprecated by Bot API 7.2
Released 2024-05-20
This is the technical changelog for version 21.2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
PTBDeprecationWarning (#4262 closes #4261)CallbackContext (#4222)Application.post_stop Only if Application.stop was called (#4211 closes #4210)SystemExit raised in Handlers (#4157 closes #4155 and #4156)Birthdate.to_date Return a datetime.date Object (#4251)ruff Config (#4250)furo from 2024.4.27 to 2024.5.6 (#4252)pre-commit autoupdate (#4239)pytest from 8.1.1 to 8.2.0 (#4231)dependabot/fetch-metadata from 2.0.0 to 2.1.0 (#4228)pytest-asyncio from 0.21.1 to 0.21.2 (#4232)pytest-xdist from 3.6.0 to 3.6.1 (#4233)furo from 2024.1.29 to 2024.4.27 (#4230)srvaroa/labeler from 1.10.0 to 1.10.1 (#4227)pytest from 7.4.4 to 8.1.1 (#4218)sphinx from 7.2.6 to 7.3.7 (#4215)pytest-xdist from 3.5.0 to 3.6.0 (#4215)Remove Deprecation Warning in JobQueue.run_daily (#4206 by @Konano)
Released 2024-04-15
This is the technical changelog for version 21.1.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
message_thread_id of Message.reply_* (#4207 closes #4205)JobQueue.run_daily (#4206 by @Konano)EncryptedCredentials.decrypted_secret (#4199 by @marinelay closes #4198)This is the technical changelog for version 21.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-04-12
This is the technical changelog for version 21.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
ChatAdministratorRights/ChatMemberAdministrator.can_*_stories Required (API 7.1) (#4192)Bot to Improve Type Hinting (#4151 closes #4010)Message.reply_* Reply in the Same Topic by Default (#4170 by @aelkheir closes #4139)Update.effective_sender (#4168 by @aelkheir closes #4085)get_sticker_set as XFAIL due to API 7.2 Update (#4190)pre-commit autoupdate (#4184)dependabot/fetch-metadata from 1.6.0 to 2.0.0 (#4185)This is the technical changelog for version 21.0.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2024-03-06
This is the technical changelog for version 21.0.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
docs from Package (#4150)Remove Functionality Deprecated in API 7.0 (#4114 closes #4099)
Released 2024-03-06
This is the technical changelog for version 21.0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
media_write_timeout to HTTPXRequest and Method ApplicationBuilder.media_write_timeout (#4120 closes #3864)TelegramObject.__setstate__ (#4134 closes #4111)Updater (#4130 closes #4127)pre-commit Checks More Widely (#4135)test_official (#4087 closes #3874)Updater.stop Independent of CancelledError (#4126)httpx Dependency (#4148)test-summary/action from 2.2 to 2.3 (#4142)cachetools requirement from ~=5.3.2 to ~=5.3.3 (#4141)httpx requirement from ~=0.26.0 to ~=0.27.0 (#4131)Deprecate filters.CHAT (#4083 closes #4062)
Released 2024-02-08
This is the technical changelog for version 20.8. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
filters Parameter of MessageHandler (#4039 by @Palaptin)filters.CHAT (#4083 closes #4062)pattern to PreCheckoutQueryHandler and filters.SuccessfulPayment (#4005 by @aelkheir closes #3752)type to Corresponding Enum from telegram.constants (#4067)Updater.start_webhook (#3986 closes #3978)Bot.do_api_request (#4084 closes #4053)AsyncContextManager as Parent Class to BaseUpdateProcessor (#4001)ruff and Remove sort-all (#4075)_handlers Subdirectory (#4064 by @lucasmolinari closes #4060)sort-all Hook for pre-commit (#4052)pre-commit Mirror for black (#4051)DEFAULT_20 (#3997)setup.cfg to pyproject.toml Where Possible (#4088)black and ruff (#4089)srvaroa/labeler from 1.8.0 to 1.10.0 (#4048)tornado requirement from ~=6.3.3 to ~=6.4 (#3992)actions/stale from 8 to 9 (#4046)actions/setup-python from 4 to 5 (#4047)pre-commit autoupdate (#4101)actions/upload-artifact from 3 to 4 (#4045)pre-commit autoupdate (#3996)furo from 2023.9.10 to 2024.1.29 (#4094)pre-commit autoupdate (#4043)codecov/codecov-action from 3 to 4 (#4091)EndBug/add-and-commit from 9.1.3 to 9.1.4 (#4090)httpx requirement from ~=0.25.2 to ~=0.26.0 (#4024)pytest from 7.4.3 to 7.4.4 (#4056)srvaroa/labeler from 1.7.0 to 1.8.0 (#3993)test-summary/action from 2.1 to 2.2 (#4044)dessant/lock-threads from 4.0.1 to 5.0.1 (#3994)This is the technical changelog for version 20.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2023-11-27
This is the technical changelog for version 20.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
JobQueue.scheduler_configuration and Corresponding Warnings (#3913 closes #3837)socket_options to HTTPXRequest (#3935 closes #2965)ApplicationBuilder.(get_updates_)socket_options (#3943)write_timeout Handling for Media Methods (#3952)filters.Mention (#3941 closes #3799)proxy_url to proxy and Allow httpx.{Proxy, URL} as Input (#3939 closes #3844)read_timeout Behavior for Bot.get_updates (#3963 closes #3893)BaseHandler.__repr__ for Callbacks without __qualname__ (#3934)Bot (#3942)__aenter__ and __aexit__ Methods (#3907 closes #3886)Bot Methods (#3965)pytest-xdist from 3.3.1 to 3.4.0 (#3975)pre-commit autoupdate (#3967)httpx requirement from ~=0.25.1 to ~=0.25.2 (#3983)pytest-xdist from 3.4.0 to 3.5.0 (#3982)httpx requirement from ~=0.25.0 to ~=0.25.1 (#3961)srvaroa/labeler from 1.6.1 to 1.7.0 (#3958)cachetools requirement from ~=5.3.1 to ~=5.3.2 (#3954)pytest from 7.4.2 to 7.4.3 (#3953)This is the technical changelog for version 20.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2023-10-03
This is the technical changelog for version 20.6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
WriteAccessAllowed (#3911 closes #3909)__repr__ Methods Added in #3826 closes #3770 to Sphinx Documentation (#3901 closes #3889)file_size Tests (#3906)--preview Flag of black (#3882)Defaults.__ne__ (#3884)pre-commit autoupdate (#3876)pre-commit Dependencies (#3916)actions/checkout from 3 to 4 (#3914)httpx requirement from ~=0.24.1 to ~=0.25.0 (#3891)furo from 2023.8.19 to 2023.9.10 (#3890)sphinx from 7.2.5 to 7.2.6 (#3892)tornado requirement from ~=6.2 to ~=6.3.3 (#3675)pytest from 7.4.0 to 7.4.2 (#3881)Remove Functionality Deprecated Since Bot API 6.5, 6.6 or 6.7
Released 2023-09-03
This is the technical changelog for version 20.5. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
has_args Parameter to CommandHandler (#3854 by @thatguylah closes #3798)Application.stop_running() and Improve Marking Updates as Read on Updater.stop() (#3804)WebhookInfo (#3871)Exception.__cause__ on NetworkError (#3792 closes #3778)customwebhookbot.py with Different Frameworks (#3820 closes #3717)pre-commit autoupdate (#3824)srvaroa/labeler from 1.6.0 to 1.6.1 (#3870)sphinx from 7.0.1 to 7.1.1 (#3818)sphinx from 7.2.3 to 7.2.5 (#3869)furo from 2023.5.20 to 2023.7.26 (#3817)apscheduler requirement from ~=3.10.3 to ~=3.10.4 (#3862)sphinx from 7.2.2 to 7.2.3 (#3861)pytest-asyncio from 0.21.0 to 0.21.1 (#3801)sphinx-paramlinks from 0.5.4 to 0.6.0 (#3840)apscheduler requirement from ~=3.10.1 to ~=3.10.3 (#3851)furo from 2023.7.26 to 2023.8.19 (#3850)sphinx from 7.1.2 to 7.2.2 (#3852)sphinx from 7.1.1 to 7.1.2 (#3827)This is the technical changelog for version 20.4. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2023-07-09
This is the technical changelog for version 20.4. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
APScheduler into JobQueue More Explicit (#3695)BaseUpdateProcessor for Customized Concurrent Handling of Updates (#3654 closes #3509)timeout Parameter of Bot.get_updates (#3709 by @revolter)KeyboardButton.__eq__ (#3768)allowed_updates in Examples (#3741 by @Trifase closes #3726)furo and sphinx (#3719)httpx Logging Level to Warning in Examples (#3746 closes #3743)pre-commit.ci Configuration (#3697)ruff Rules (#3763)_handler.py to _basehandler.py (#3761)pre-commit-ci PRs (#3713)pytest Integration into GitHub Actions (#3776)cachetools requirement from ~=5.3.0 to ~=5.3.1 (#3738)aiolimiter requirement from ~=1.0.0 to ~=1.1.0 (#3707)pre-commit autoupdate (#3791)sphinxcontrib-mermaid from 0.8.1 to 0.9.2 (#3737)pytest-xdist from 3.2.1 to 3.3.0 (#3705)srvaroa/labeler from 1.5.0 to 1.6.0 (#3786)dependabot/fetch-metadata from 1.5.1 to 1.6.0 (#3787)dessant/lock-threads from 4.0.0 to 4.0.1 (#3785)pytest from 7.3.2 to 7.4.0 (#3774)httpx requirement from ~=0.24.0 to ~=0.24.1 (#3715)pytest-xdist from 3.3.0 to 3.3.1 (#3714)pytest from 7.3.1 to 7.3.2 (#3758)pre-commit autoupdate (#3747)Remove Deprecated codecov Package from CI
Released 2023-05-07
This is the technical changelog for version 20.3. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Application.mark_data_for_update_persistence (#3607)Message.link Point to Thread View Where Possible (#3640)datetime Objects According to Defaults.tzinfo (#3632)ruff (#3594)sys.maxunicode (#3630)RequestParameter (#3634)BasePersistence.parse_json_payload (#3668)test_delete_sticker_set (#3685)Application.start (#3657)actions/stale from 7 to 8 (#3644)furo from 2023.3.23 to 2023.3.27 (#3643)pre-commit autoupdate (#3646, #3688)codecov Package from CI (#3664)sphinx-copybutton from 0.5.1 to 0.5.2 (#3662)httpx requirement from ~=0.23.3 to ~=0.24.0 (#3660)pytest from 7.2.2 to 7.3.1 (#3661)This is the technical changelog for version 20.2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2023-03-25
This is the technical changelog for version 20.2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
was_called_by (#3552)Application.create_task (#3543)pytest-asyncio from 0.20.3 to 0.21.0 (#3624)furo from 2022.12.7 to 2023.3.23 (#3625)pytest-xdist from 3.2.0 to 3.2.1 (#3606)pre-commit autoupdate (#3577)apscheduler requirement from ~=3.10.0 to ~=3.10.1 (#3572)pytest from 7.2.1 to 7.2.2 (#3573)pytest-xdist from 3.1.0 to 3.2.0 (#3550)sphinxcontrib-mermaid from 0.7.1 to 0.8 (#3549)Update cryptography requirement to >=39.0.1 to address Vulnerability
Released 2023-02-09
This is the technical changelog for version 20.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Application(Builder).post_stop (#3466)Chat.effective_name Convenience Property (#3485)chatmemberbot Example (#3500)GitHub Actions (#3469)GitHub Actions Artifacts (#3468)ruff to pre-commit Hooks (#3488)days Parameter of JobQueue.run_daily (#3503)NetworkError (#3505)pytest from 7.2.0 to 7.2.1 (#3513)check_keyboard_type (#3514)actions/stale from 6 to 7 (#3461)dessant/lock-threads from 3.0.0 to 4.0.0 (#3462)pre-commit autoupdate (#3470)httpx requirement from ~=0.23.1 to ~=0.23.3 (#3489)cachetools requirement from ~=5.2.0 to ~=5.2.1 (#3502)ruff and Bump to v0.0.222 (#3507)cachetools requirement from ~=5.2.1 to ~=5.3.0 (#3520)isort to 5.12.0 (#3525)apscheduler requirement from ~=3.9.1 to ~=3.10.0 (#3532)pre-commit autoupdate (#3537)cryptography requirement to >=39.0.1 to address Vulnerability (#3539)This is the technical changelog for version 20.0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2023-01-01
This is the technical changelog for version 20.0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Sequence Input for Bot Methods (#3412)Bot.__deepcopy__ to Raise TypeError (#3446)Bot.get_webhook_info (#3442)Job.__lt__ (#3432)sphinx to 5.3.0 to Fix Search (#3457)sphinx from 5.3.0 to 6.0.0 (#3450)This is the technical changelog for version 20.0b0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-12-15
This is the technical changelog for version 20.0b0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
TelegramObject Immutable (#3249)Defaults (#3419)Bot Methods (#3396)Bot Methods (#3385)pytest-xdist from 3.0.2 to 3.1.0 (#3415)pytest-asyncio from 0.20.2 to 0.20.3 (#3417)pre-commit autoupdate (#3409)This is the technical changelog for version 20.0a6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-11-24
This is the technical changelog for version 20.0a6. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
callback_data if ExtBot.callback_data_cache is Present (#3384)TelegramObjects Pickle Behavior (#3382)File.download_* Methods (#3380)Chat.create_forum_topic (#3381)This is the technical changelog for version 20.0a5. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-11-22
This is the technical changelog for version 20.0a5. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
local_mode Setting (#3154)File.download Into File.download_to_drive And File.download_to_memory (#3223)Bot (#3247)chat_id and username Parameters to ChatJoinRequestHandler (#3261)TelegramObject.api_kwargs (#3233)recursive Parameter to TelegramObject.to_dict() (#3276)TelegramObject (#3234)Chat.mention_{html, markdown, markdown_v2} (#3308)constants.MessageLimit.DEEP_LINK_LENGTH (#3315)caption, parse_mode and caption_entities to Bot.send_media_group (#3295)CallbackQueryHandler Not Handling Non-String Data Correctly With Regex Patterns (#3252)Bot.answer_web_app_query (#3362)TelegramObject (#3319)ConversationHandler States (#3242)GitHub Actions (#3243)Job.job a Property and Make Jobs Hashable (#3250)JobQueue Tests on Windows Again (#3280)CallbackDataCache (#3266)Message.effective_attachment (#3294)ext.Defaults (#3311)MessageAttachmentType (#3335)ChatMemberUpdated.difference (#3352)pytest Marker (#3354)DeepSource Issues (#3357)TelegramObject.to_dict (#3353)ChatDescriptionLimit Enum Into ChatLimit (#3377)pytest from 7.1.2 to 7.1.3 (#3228)pre-commit Updates (#3221)sphinx from 5.1.1 to 5.2.3 (#3269)furo from 2022.6.21 to 2022.9.29 (#3268)actions/stale from 5 to 6 (#3277)pre-commit autoupdate (#3282)sphinx from 5.2.3 to 5.3.0 (#3300)pytest-asyncio from 0.19.0 to 0.20.1 (#3299)pytest from 7.1.3 to 7.2.0 (#3318)pytest-xdist from 2.5.0 to 3.0.2 (#3317)pre-commit autoupdate (#3325)pytest-asyncio from 0.20.1 to 0.20.2 (#3359)httpx requirement from ~=0.23.0 to ~=0.23.1 (#3373)This is the technical changelog for version 20.0a4. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-08-27
This is the technical changelog for version 20.0a4. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
setup.py Regarding Optional Dependencies (#3209)This is the technical changelog for version 20.0a3. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-08-27
This is the technical changelog for version 20.0a3. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
chat/user_data Available in Error Handler for Errors in Jobs (#3152)Application.post_shutdown (#3126)helpers.mention_markdown for Markdown V1 and Improve Related Unit Tests (#3155)api_kwargs Parameter to Bot.log_out and Improve Related Unit Tests (#3147)Bot.delete_my_commands a Coroutine Function (#3136)ConversationHandler.check_update not respecting per_user (#3128)Bot.send_chat_action (#3151)pre-commit Dependencies from requirements-dev.txt` (#3120)concurrent_updates and connection_pool_size (#3127)sphinx from 5.0.2 to 5.1.1 (#3177)pre-commit Dependencies (#3085)pytest-asyncio from 0.18.3 to 0.19.0 (#3158)tornado requirement from ~=6.1 to ~=6.2 (#3149)black from 22.3.0 to 22.6.0 (#3132)actions/setup-python from 3 to 4 (#3131)This is the technical changelog for version 20.0a2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-06-27
This is the technical changelog for version 20.0a2. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Chat (#3115)pyupgrade from 2.32.1 to 2.34.0 (#3096)furo from 2022.6.4 to 2022.6.4.1 (#3095)mypy from 0.960 to 0.961 (#3093)This is the technical changelog for version 20.0a1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-06-09
This is the technical changelog for version 20.0a1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
ujson and instead BaseRequest.parse_json_payload (#3037, #3072)InputFile.is_image (#3053)__init__ s (#3056){Command, Prefix}Handler And Make Attributes Immutable (#3045)JobQueue.run_daily With cron (#3046)CallbackContext and Move Default Type Alias to ContextTypes.DEFAULT_TYPE (#3017, #3023)Job.context to Job.data (#3028)Handler to BaseHandler (#3019)Application.post_init (#3078)chat/user_idtoCallbackContext` And Example On Custom Webhook Setups (#3059)Message.id (#3077)WebApp (#3052)telegram.bot_api_version to telegram.__bot_api_version__ (#3030)ConversationHandler (#3068)escape_markdown (#3055)httpx requirement from ~=0.22.0 to ~=0.23.0 (#3069)cachetools requirement from ~=5.0.0 to ~=5.2.0 (#3058, #3080){Command, Prefix}Handler And Make Attributes Immutable (#3045)isort and Update pre-commit.ci Configuration (#3049)pre-commit Settings for isort (#3043)Collection Instead of List and Tuple (#3025)Application.run_* on Python 3.7 (#3009)git blame (#3003)Remove Deprecated Functionality (#2644, #2740, #2745)
Released 2022-05-06
This is the technical changelog for version 20.0a0. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
CallbackContext API (#2617)__dict__ from __slots__ and drop Python 3.6 (#2619, #2636)TelegramDecryptionError to telegram.error.PassportDecryptionError (#2621)BasePersistence Methods Abstract (#2624)day_is_strict argument of JobQueue.run_monthly (#2634 by @iota-008)Defaults to telegram.ext (#2648)asyncio and Refactor PTBs Architecture (#2731)Job.__getattr__ (#2832)telegram.ReplyMarkup (#2870)Bots: Refactor Automatic Replacement and Integration with TelegramObject (#2893)Filters.update.edited (#2705 by @PhilippFr)Enums for telegram.constants (#2708)private_key (#2724)Jobs with chat/user_id (#2731)ChatInviteLinks (#2782)Dispatcher.add_handlers (#2823)CommandHandler.__init__ (#2837)Defaults.protect_content (#2840)Dispatcher.migrate_chat_data (#2848 by @DonalDuck004)drop_chat/user_data to Dispatcher and Persistence (#2852)ChatPermissions.{all, no}_permissions (#2948)CallbackContext (#2587 by @revolter)test_official (#2643)Dispatcher.dispatch_error (#2660)InlineQuery.answer Raise ValueError (#2675)TelegramObject.set/get_bot (#2712 by @zpavloudis)TelegramObject (#2719 by @SimonDamberg)ChatMember (#2817)BasePersistence.get_*_data (#2873)ChatMemberUpdated.difference (#2947){Inline, Reply}KeyboardMarkup (#2657)pathlib Module (#2688 by @eldbud)InputMedia* and Some File-Like Classes (#2717 by @eldbud)ConversationHandler (#2755, #2784)__all__ Consistently (#2805)pytest Marker to Ease Development (#2628)pylint Instead of Codes (#2700 by @Piraty)pre-commit Settings & Improve a Test (#2796)Bot.get_file Behavior (#2995)git.io Links (#2872 by @murugu-21)This is the technical changelog for version 13.15. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-12-06
This is the technical changelog for version 13.15. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Bug Fixes:
Bot.answer_web_app_query (#3364)This is the technical changelog for version 13.14. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-09-04
This is the technical changelog for version 13.14. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Minor Changes:
tornado to Version 6.1 (#3145)This is the technical changelog for version 13.13. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-06-28
This is the technical changelog for version 13.13. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
This is the technical changelog for version 13.12. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-05-26
This is the technical changelog for version 13.12. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Minor Changes:
This is the technical changelog for version 13.11. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-02-02
This is the technical changelog for version 13.11. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
This is the technical changelog for version 13.10. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2022-01-03
This is the technical changelog for version 13.10. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Minor Changes & Doc fixes:
BotCommand (#2820)This is the technical changelog for version 13.9. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2021-12-11
This is the technical changelog for version 13.9. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Minor Changes
This is the technical changelog for version 13.8.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2021-11-08
This is the technical changelog for version 13.8.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Doc fixes:
ChatJoinRequest(Handler) to Docs (#2771)This is the technical changelog for version 13.8. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Released 2021-11-08
This is the technical changelog for version 13.8. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Minor changes, CI improvements, Doc fixes and Type hinting:
camelCase Functions in ExtBot (#2659)Bot.copy_message (#2651)BasePersistence.insert/replace_bot for Objects with __dict__ not in __slots__ (#2603)Improve Deprecation Warning for __slots__
Released 2021-07-01
This is the technical changelog for version 13.7. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.
Major Changes:
Bug Fixes:
BasePersistence.insert/replace_bot for Objects with __dict__ in their slots (#2561)Defaults and ExtBot (#2553)Minor changes, CI improvements, Doc fixes and Type hinting:
__slots__ (#2574)BasePersistence.replace/insert_bot (#2564)pass_args from Deeplinking Example (#2550)Add ContextTypes & BasePersistence.refresh_user/chat/bot_data
Released 2021-06-06
New Features:
callback_data (#1844)ContextTypes & BasePersistence.refresh_user/chat/bot_data (#2262)Filters.attachment (#2528)pattern Argument to ChosenInlineResultHandler (#2517)Major Changes:
__slots__ (#2345)Minor changes, CI improvements, Doc fixes and Type hinting:
max_connections Parameter to Updater.start_webhook (#2547)Promise.done_callback (#2544)CallbackQueryHandler (#2520)send_phone_number_to_provider argument for Bot.send_invoice (#2527)BasePersistence.replace/insert_bot (#2523)Update ChatActions, Deprecating ChatAction.RECORD_AUDIO and ChatAction.UPLOAD_AUDIO
Released 2021-04-30
Major Changes:
Full support of Bot API 5.2 (#2489).
Note:
The start_parameter argument of Bot.send_invoice and the corresponding shortcuts is now optional, so the order of
parameters had to be changed. Make sure to update your method calls accordingly.
Update ChatActions, Deprecating ChatAction.RECORD_AUDIO and ChatAction.UPLOAD_AUDIO (#2460)
New Features:
ChatMemberUpdated (#2490)Filters.forwarded_from (#2446)Minor changes, CI improvements, Doc fixes and Type hinting:
ConversationHandler (#2417)UserWarnings (#2464)Version 13.4.1 ============== *Released 2021-03-14* Hot fix release: - Fixed a bug in setup.py
Released 2021-03-14
Hot fix release:
setup.py (#2431)Minor changes, CI improvements, doc fixes and type hinting:
Released 2021-03-14
Major Changes:
Minor changes, CI improvements, doc fixes and type hinting:
Updater.set_webhook (#2419)pre-commit Settings (#2415)urllib3 (#2427)Make cryptography Dependency Optional & Refactor Some Tests (#2386, #2370)
Released 2021-02-19
Major Changes:
cryptography Dependency Optional & Refactor Some Tests (#2386, #2370)MessageQueue (#2393)Bug Fixes:
Defaults Integration (#2363)telegram.SecureValue to init and Docs (#2398)Minor changes:
Introduce python-telegram-bot-raw
Released 2021-02-02
Major Changes:
python-telegram-bot-raw (#2324)New Features:
Message (#2330)Bot (#2320)run_async Parameter to ConversationHandler (#2292)Chat (#2291)MAX_ANSWER_CALLBACK_QUERY_TEXT_LENGTH (#2282)Bug Fixes:
Message Properties (#2312)Dispatcher.update_persistence (#2285)quote kwarg to Message.reply_copy (#2232)ConversationHandler: Docs & edited_channel_post behavior (#2339)Minor changes, CI improvements, doc fixes and type hinting:
typing.Any (#2321)Full support of Bot API 5.0 (#2181, #2186, #2190, #2189, #2183, #2184, #2188, #2185, #2192, #2196, #2193, #2223, #2199, #2187, #2147, #2205)
Released 2020-11-29
Major Changes:
New Features:
Defaults.run_async (#2210)CallbackQuery Shortcuts (#2172)Filters.name a Property (#2179)Filters.document.file_extension (#2169)Filters.caption_regex (#2163)Filters.chat_type (#2128)Bug Fixes:
BasePersistence.insert/replace_bot (#2151)replace/insert_bot (#2218)Minor changes, CI improvements, doc fixes and type hinting:
kwargs to _kwargs where possible (#2182)timerbot.py to v13.0 (#2149)Deprecate old-style callbacks, i.e. set use_context=True by default
Released 2020-10-07
For a detailed guide on how to migrate from v12 to v13, see this wiki page.
Major Changes:
use_context=True by default (#2050)Message.default_quote (#1965)JobQueue (#1981)Dispatcher.run_async, deprecating the @run_async decorator (#2051)New Features:
answer_inline_query (#2072)Defaults.tzinfo (#2042)Filters.via_bot (#2009)DispatcherHandlerStop in ConversationHandler (#2059)Minor changes, CI improvements, doc fixes or bug fixes:
send_media_group (#2093)MessageHandler filter for Filters.update first (#2085)PicklePersistence.flush() with only bot_data (#2017)Updater.start_polling/webhook (#2002)pollbot.py example (#2047)echobot examples (#2025)IDs/Usernames of Filters.user and Filters.chat can now be updated
Released 2020-06-22
Major Changes:
Filters.user and Filters.chat can now be updated (#1757)Minor changes, CI improvements, doc fixes or bug fixes:
NullHandlers (#1913)User.send_poll() shortcut (#1968)TelegramObject.to_dict() (#1989)Your coding agent can read these notes before it upgrades. Set up the MCP server →