NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2053 most downloaded on Packagist
The Unofficial Telegram Bot API PHP SDK
Latest stable
v3.16.0
Last release 8 months ago
07 Mar 2026
Release timing varies
gaps range from 8 days to 1.1 years
Most releases are documented
notes for 24 of 32 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
32 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Refactor sendPhoto method to handle URL validation by @chinacase in https://github.com/irazasyed/telegram-bot-sdk/pull/1176
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.15.0...v3.16.0
Fixed: Class Telegram\Bot\Methods\Arr not found by @andrey-helldar in https://github.com/irazasyed/telegram-bot-sdk/pull/1120
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Telegram\Bot\Methods\Arr not found by @andrey-helldar in https://github.com/irazasyed/telegram-bot-sdk/pull/1120Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.14.0...v3.15.0
Downgrade psr/container by @kksandr7 in https://github.com/irazasyed/telegram-bot-sdk/pull/1093
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.13.0...v3.14.0
Revise Base Bot URL and File URL. Reverts breaking change.
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.12.0...v3.13.0
Add download HTTP method for file downloader.
7.5.1 for security reasons.1.x and 2.x.Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.11.0...v3.12.0
Add argument($name, $default) method in command.
argument($name, $default) method in command.{argument} { regex: \w+ }setChatPhoto method to properly upload photo file.Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.10.0...v3.11.0
3.10 by @irazasyed in https://github.com/irazasyed/telegram-bot-sdk/pull/1047
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.9.1...v3.10.0
Add Supported Versions table by @lptn in #997
EmitterInterface instead of Emitter implementation by @lptn in #990UpdateEvent event similar to SDK v4 by @lptn in #998get method in TelegramResponseException.php by @foremtehan in #1030Full Changelog: v3.9...v3.9.1
EmitterInterface instead of Emitter implementation by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/990UpdateEvent event similar to SDK v4 by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/998get method in TelegramResponseException.php by @foremtehan in https://github.com/irazasyed/telegram-bot-sdk/pull/1030Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.9...v3.9.1
Fix commands receiving argument names instead of values (#821).
PHP 8 Support (#818 & #819). Thanks @roelofr.
Nothing published for this version
Nothing published for this version
- Laravel 7. - Bot API Updates. - Bugfixes.
- Yet to be documented [WIP]. - Major changes. - Multi-Bot Support.
Nothing published for this version
Nothing published for this version
This version supports Laravel 5.3. No major changes.
This version supports Laravel 5.3. No major changes.
Stay tuned for V3 release as it's packed with several new features and cool stuff. 😎
This version brings in some major and breaking changes to the SDK.
This version brings in some major and breaking changes to the SDK.
Head to CHANGELOG page for detailed info on what's changed and follow the UPGRADE Guide for detailed instructions on how to upgrade your version of this library. And take a look at the documentations to explore more details and to check out the examples.
Huge thanks to all our contributors who helped improve the SDK and made it much better :)
P.S Open issues if you face any issues.
This version brings in some major updates and features, Such as the all new Commands System, API Change, Tweaks, Enhancements and Breaking Changes.
This version brings in some major updates and features, Such as the all new Commands System, API Change, Tweaks, Enhancements and Breaking Changes.
Head to CHANGELOG page for detailed info on what's changed and follow the UPGRADE Guide for detailed instructions on how to upgrade your version of this library.
Also, Did you check out the shiny new documentation page?
Huge thanks to all contributors and shout out to @jonnywilliamson for actively contributing and helping me to make this release possible.
Added Video Caption Support to sendVideo() method - Thanks @jonnywilliamson
sendVideo() method - Thanks @jonnywilliamsonsendVideo() and sendAudio() methods.Thanks to @codengine for the PR.
Thanks to @codengine for the PR.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Patch for #1 - Thanks to @orloffv for pointing out.
Patch for #1 - Thanks to @orloffv for pointing out.
Refactored getUpdates() function.
getUpdates() function.getWebhookUpdates() function.Nothing published for this version
Fix Update::getChat() for cases when a User banned and/or unbanned a bot by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/977
Update::getChat() for cases when a User banned and/or unbanned a bot by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/977username config key used by WebhookCommand only by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/979Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.8...v3.9
Fix CI: do not use guzzle versions with know vulnerabilities by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/970
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.7...v3.8
Fix PHPDoc: mark optional properties as nullables by @lptn in https://github.com/irazasyed/telegram-bot-sdk/pull/963
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.6...v3.7
Added PHPDoc templates for Keyboard classes by @Kravets1996 in https://github.com/irazasyed/telegram-bot-sdk/pull/928
video_note by @andrey-helldar in https://github.com/irazasyed/telegram-bot-sdk/pull/930is not valid header value by @andrey-helldar in https://github.com/irazasyed/telegram-bot-sdk/pull/934Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.5...v3.6
Fixed: method ReflectionParameter::getClass() is deprecated, PHP8 by @semsphy in https://github.com/irazasyed/telegram-bot-sdk/pull/854
Full Changelog: https://github.com/irazasyed/telegram-bot-sdk/compare/v3.4.1...v3.5
One column per quarter.