NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4168 most downloaded on Packagist
PHP Telegram bot
Latest stable
0.83.1
Last release 2 years ago
no release in 18 months
Release timing varies
gaps range from 1 weeks to 7 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
79 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
FastFix to Critical Error. by @r3bers in https://github.com/php-telegram-bot/core/pull/1467
Full Changelog: https://github.com/php-telegram-bot/core/compare/0.83.0...0.83.1
forward_origin field of Bot API 7.0. (@r3bers) (#1467)Request::setCustomBotApiUri() throws an exception when called after the Telegram object was instantiated, where it had no effect. (@TiiFuchs) (#1296)chat_boost_updated_id and chat_boost_removed_id columns of telegram_update in the DB structure and migration script. (@r3bers, @noplanman) (#1468)Your coding agent can read these notes before it upgrades. Set up the MCP server →
📒 View file changes ∙ 📃 DB migration script
:ledger: View file changes ∙ :page_with_curl: DB migration script
thumbnail_url renaming.thumbnail_url renaming.:ledger: View file changes ∙ :page_with_curl: DB migration script
:ledger: View file changes ∙ :page_with_curl: DB migration script
FooBarCommand is handled by /foo_bar). (@mlocati) (#1365)FooBarCommand is handled by /foo_bar). (@mlocati) (#1365)VoiceChatX entities, use VideoChatX entities instead.
VoiceChatX entities, use VideoChatX entities instead.all_members_are_administrators property from Message entity. Database column still exists, but may be removed in the future.Request::getChatMembersCount(), use Request::getChatMemberCount() instead.Request::kickChatMember(), use Request::banChatMember() instead.VoiceChatX entities, use VideoChatX entities instead.all_members_are_administrators property from Message entity. Database column still exists, but may be removed in the future.Request::getChatMembersCount(), use Request::getChatMemberCount() instead.Request::kickChatMember(), use Request::banChatMember() instead.:ledger: View file changes ∙ :page_with_curl: DB migration script
### Notes - :ledger: View file changes ### Fixed - PHP8+ mixed type hint removed
mixed type hint removedTelegram changed voice_chat_X to video_chat_X. VoiceChatX event classes are deprecated, use new VideoChatX event classes instead.
voice_chat_X to video_chat_X. VoiceChatX event classes are deprecated, use new VideoChatX event classes instead.Entity::jsonSerialize (@TiiFuchs)Fix Entity serialising for Keyboards (@TiiFuchs)
PSR3 (psr/log) version 2 and 3 compatible (@noplanman)
:exclamation: Removed deprecated ChatAction:: RECORD_AUDIO and UPLOAD_AUDIO. Use RECORD_VOICE and UPLOAD_VOICE instead. (@TiiFuchs)
message_auto_delete_time was added to the Chat Entity (@TiiFuchs) (#1265)ChatAction:: RECORD_AUDIO and UPLOAD_AUDIO. Use RECORD_VOICE and UPLOAD_VOICE instead. (@TiiFuchs) (#1267)message_auto_delete_time was added to the Chat Entity (@TiiFuchs) (#1265)ChatAction:: RECORD_AUDIO and UPLOAD_AUDIO. Use RECORD_VOICE and UPLOAD_VOICE instead. (@TiiFuchs) (#1267)Bot API 5.3 (Personalized Commands, Keyboard Placeholders). (@TiiFuchs, @noplanman) (#1229, #1231)
Allow new optional parameters when setting and deleting webhook. (@TiiFuchs)
📒 View file changes ∙ 📃 DB migration script
Telegram::runCommands returns array of ServerResponse objects of executed commands. (#1223)Telegram::runCommands. (#1223)Telegram::runCommands returns array of ServerResponse objects of executed commands. (#1223)Telegram::runCommands. (#1223)📒 View file changes ∙ 📃 DB migration script
Telegram::handleGetUpdates method should be passed a $data array for parameters. (#1202)message.edit_date is now of type timestamp. (#1191)getUpdates method. (#1202)Telegram::handleGetUpdates method should be passed a $data array for parameters. (#1202)message.edit_date is now of type timestamp. (#1191)getUpdates method. (#1202)Define a custom Bot API server and file download URI.
getUpdates method wrongly sends only 1 Update when a limit of 0 is passed. (#1169)Telegram::runCommands() now passes the correct message text to the commands. (#1181)Extra parameter for Request::sendMessage() to pass options and return all response objects for split messages.
Request::sendMessage() to pass options and return all response objects for split messages. (#1163)Request::sendMessage() to pass options and return all response objects for split messages. (#1163)📒 View file changes ∙ 📃 DB migration script
/clean query. (@dva-re) (#1139)/clean query. (@dva-re) (#1139)Support for Guzzle 7. (@KristobalJunta)
This fixed version is necessary for Windows users.
getFileNamespace() that introduced a breaking bug in #1114. (@jacklul) (#1115)runCommands() not working due to custom namespace feature. (@jacklul) (#1115, #1118)📒 View file changes ∙ 📃 DB migration script
setUpdateFilter($callback) used to filter processUpdate(Update $update) calls. If $callback returns false the update isn't processed and an empty falsey ServerResponse is returned. (@VRciF) (#1045)Entity::escapeMarkdownV2 for MarkdownV2. (#1094)TelegramLog::$remove_bot_token parameter to false. (@jacklul) (#1095)TelegramLog::$always_log_request_and_response parameter to force output of the request and response data to the debug log, also for successful requests. (#1089)via_bot field). (#1112)Entity::escapeMarkdown static, to not require an Entity object. (#1094)poll_answer also requires the user_id. (#1087)setUpdateFilter($callback) used to filter processUpdate(Update $update) calls. If $callback returns false the update isn't processed and an empty falsey ServerResponse is returned. (@VRciF) (#1045)Entity::escapeMarkdownV2 for MarkdownV2. (#1094)TelegramLog::$remove_bot_token parameter to false. (@jacklul) (#1095)TelegramLog::$always_log_request_and_response parameter to force output of the request and response data to the debug log, also for successful requests. (#1089)via_bot field). (#1112)Entity::escapeMarkdown static, to not require an Entity object. (#1094)poll_answer also requires the user_id. (#1087)📒 View file changes ∙ 📃 DB migration script
language_code in DB::selectChats() for filtering the chats selection. (#1058)Request::setClient() now accepts more flexible ClientInterface. (#1068)instanceof checks for entities. (#1068)Request::$input variable. (#1068)/start command without any custom implementation.animation type for GIF Message (which returns both animation and document). (#1044)mb_strtolower from strtolower because of latin-extented characters. (#1051)Request::mediaInputHelper() to include thumb parameter. (#1059)language_code in DB::selectChats() for filtering the chats selection. (#1058)Request::setClient() now accepts more flexible ClientInterface. (#1068)instanceof checks for entities. (#1068)Request::$input variable. (#1068)/start command without any custom implementation.animation type for GIF Message (which returns both animation and document). (#1044)mb_strtolower from strtolower because of latin-extented characters. (#1051)Request::mediaInputHelper() to include thumb parameter. (#1059)Tests for schema update scripts, to ensure that updates work as expected.
inline_query_id in InlineQuery::answerInlineQuery. (#1021)Static boolean property SystemCommand::$execute_deprecated (must be assigned before handling the request) to try and execute any deprecated system com…
GenericmessageCommand to keep obsolete service message system commands working. (#999)SystemCommand::$execute_deprecated (must be assigned before handling the request) to try and execute any deprecated system command. (#999)message table, making the cleanup much faster on bigger databases. (Thanks to @damianperez) (#1015)/cleanup command now supports dry run which simply outputs all queries that would be run. (#1015)GenericmessageCommand. (#999)GenericmessageCommand to keep obsolete service message system commands working. (#999)SystemCommand::$execute_deprecated (must be assigned before handling the request) to try and execute any deprecated system command. (#999)message table, making the cleanup much faster on bigger databases. (Thanks to @damianperez) (#1015)/cleanup command now supports dry run which simply outputs all queries that would be run. (#1015)GenericmessageCommand. (#999)Request::answerInlineQuery in InlineQuery::answer. (#1001)/cleanup command. (#1015)Bot API 4.4 (Animated stickers, ChatPermissions).
ChatPermissions). (#990)GenericCommand again. (#993)❗ Deprecated logging method will be removed in the next version, update to PSR-3 now! (see #964 for more info)
Touched up readme including header and badges.
InputMedia interface, as method annotations didn't work for propagation. (#978)📒 View file changes ∙ 📃 DB migration script
LoggerInterface. Learn more about how to use it here: #964LoginUrl) (#957)reply_markup field to Message entity. (#957)null. (#969)TelegramLog now adheres to PSR-3 LoggerInterface and allows custom logger implementations. (#964)TelegramLog::initialize($logger, $update_logger); from now on. (#964)StartCommand is now a UserCommand (not SystemCommand any more). (#970)forward_date is now correctly saved to the DB. (#967)StickerSet::getStickers() method. (#969)LoggerInterface. Learn more about how to use it here: #964LoginUrl) (#957)reply_markup field to Message entity. (#957)null. (#969)TelegramLog now adheres to [PSR-3] LoggerInterface and allows custom logger implementations. (#964)TelegramLog::initialize($logger, $update_logger); from now on. (#964)StartCommand is now a UserCommand (not SystemCommand any more). (#970)forward_date is now correctly saved to the DB. (#967)StickerSet::getStickers() method. (#969)📒 View file changes ∙ 📃 DB migration script
getIsMember() method to ChatMember entity. (#948)getForwardSenderName() method to Message entity. (#948)forward_sender_name (and forgotten forward_signature) DB fields. (#948)shipping_query and pre_checkout_query. (#885)/cleanup command. (#947)getIsMember() method to ChatMember entity. (#948)getForwardSenderName() method to Message entity. (#948)forward_sender_name (and forgotten forward_signature) DB fields. (#948)shipping_query and pre_checkout_query. (#885)/cleanup command. (#947)📒 View file changes ∙ \[📃 DB migration script\]\[0.56.0-sql-migration\]
InputMedia objects using Request::sendMediaGroup() and Request::editMediaMessage() methods.Request::encodeFile($path). (#934)InputMedia objects using Request::sendMediaGroup() and Request::editMediaMessage() methods.Request::encodeFile($path). (#934)/cleanup command. (#930)Add missing Request::editMessageMedia() and CallbackQuery::getChatInstance() methods.
Request::editMessageMedia() and CallbackQuery::getChatInstance() methods. (#916)📒 View file changes ∙ 📃 DB migration script
video_note to Message types.video_note to Message types.sendToActiveChats now works correctly for any valid Request action.
sendToActiveChats now works correctly for any valid Request action. (#898)📒 View file changes ∙ 📃 DB migration script
ChatAction class to simplify chat action selection. (#859)InvalidBotTokenException exception. (#855)BASE_PATH -> TB_BASE_PATH, BASE_COMMANDS_PATH -> TB_BASE_COMMANDS_PATH. (#813)getStickerSet. (#838)ChatAction class to simplify chat action selection. (#859)InvalidBotTokenException exception. (#855)BASE_PATH -> TB_BASE_PATH, BASE_COMMANDS_PATH -> TB_BASE_COMMANDS_PATH. (#813)getStickerSet. (#838)📒 View file changes ∙ 📃 DB migration script
Telegram::getLastUpdateId() method, returns ID of the last update that was processed. (#767)Telegram::useGetUpdatesWithoutDatabase() method, enables Telegram::handleGetUpdates() to run without a database. (#767)Telegram::handleGetUpdates() can now work without a database connection (not enabled by default). (#767)/sendtochannel and /sendtoall commands, using new message helpers. (#810)Telegram::getLastUpdateId() method, returns ID of the last update that was processed. (#767)Telegram::useGetUpdatesWithoutDatabase() method, enables Telegram::handleGetUpdates() to run without a database. (#767)Telegram::handleGetUpdates() can now work without a database connection (not enabled by default). (#767)/sendtochannel and /sendtoall commands, using new message helpers. (#810)/sendtochannel. (#803)Entity relations and wrong types for payments.
switch_inline_query and switch_inline_query_current_chat (InlineKeyboardButton). (#736)📒 View file changes ∙ 📃 DB migration script
Finish implementing payments, adding all missing type checks and docblock methods.
Message::getCommand() returns null if not a command, instead of false. (#654)Donation section and links in readme.
Request class.DB::selectChats().Request class.DB::selectChats().📒 View file changes ∙ 📃 DB migration script
is_bot added to user DB table.ServerResponse->printError method to print by default and return by setting $return parameter.reply_to_message to DB.is_bot added to user DB table.ServerResponse->printError method to print by default and return by setting $return parameter.reply_to_message to DB.Linked version numbers in changelog for easy verification of code changes.
Updated readme to latest state of 0.47.0.
Telegram::enableAdmin() now handles duplicate additions properly.Request::getMe() failure doesn't break cron execution any more.$private_only to enforce usage in private chats only (set by default for Admin commands).Telegram::enableAdmin() now handles duplicate additions properly.Request::getMe() failure doesn't break cron execution any more.$private_only to enforce usage in private chats only (set by default for Admin commands).Callbacks can be added to be executed when callback queries are called.
/cleanup command for admins, that cleans out old entries from the DB.Request class, removing most custom method implementations.Deprecated Message::getNewChatMember() (Use Message::getNewChatMembers() instead to get an array of all newly added members).
Request::sendToActiveChats and DB::selectChats now accept parameters as an options array and allow selecting of channels.Message::getNewChatMember() (Use Message::getNewChatMembers() instead to get an array of all newly added members).Telegram::getBotName() and Entity::getBotName() (Use ::getBotUsername() instead).Telegram::unsetWebhook() (Use Telegram::deleteWebhook() instead).PARAM_STR PDO data type, to allow huge numbers.custom_input into account when using getUpdates method (mainly for testing).Request::sendToActiveChats and DB::selectChats now accept parameters as an options array and allow selecting of channels.Message::getNewChatMember() (Use Message::getNewChatMembers() instead to get an array of all newly added members).Telegram::getBotName() and Entity::getBotName() (Use ::getBotUsername() instead).Telegram::unsetWebhook() (Use Telegram::deleteWebhook() instead).PARAM_STR PDO data type, to allow huge numbers.custom_input into account when using getUpdates method (mainly for testing).Erroneous exception when using webhook without a database connection.
Proper standalone scrutinizer.yml config.
scrutinizer.yml config.last_error_date_string for debug command.$update->getUpdateContent().scrutinizer.yml config.last_error_date_string for debug command.$update->getUpdateContent().Travis CI webhook for Support Bot.
isRunCommands() method to check if called via runCommands().tests folder with phpcs.examples folder.isRunCommands() method to check if called via runCommands().tests folder with phpcs.examples folder.Deprecated Telegram::getBotName() (Use Telegram::getBotUsername() instead).
getBotId() to directly access bot ID.bot_name to bot_username everywhere.Telegram::getBotName() (Use Telegram::getBotUsername() instead).getBotId() to directly access bot ID.bot_name to bot_username everywhere.Telegram::getBotName() (Use Telegram::getBotUsername() instead).$show_in_help attribute for commands, to set if it should be displayed in the /help command.
$show_in_help attribute for commands, to set if it should be displayed in the /help command.https://telegram.me/PHP_Telegram_Bot_Support$show_in_help attribute for commands, to set if it should be displayed in the /help command.https://telegram.me/PHP_Telegram_Bot_SupportInfinite message loop, caused by incorrect Entity variable.
Request limiter for incoming requests.
Allow direct access to PDO object (DB::getPdo()).
DB::getPdo())./debug command that displays various system information to help debugging.DB::getPdo())./debug command that displays various system information to help debugging.Usage of self-signed certificates in conjunction with the new allowed_updates webhook parameter.
allowed_updates webhook parameter.allowed_updates webhook parameter.New switch_inline_query_current_chat option for inline keyboard.
switch_inline_query_current_chat option for inline keyboard.channel_post and edited_channel_post.deleteWebhook (for unsetWebhook).setWebhook to allow passing of new arguments.switch_inline_query_current_chat option for inline keyboard.channel_post and edited_channel_post.deleteWebhook (for unsetWebhook).setWebhook to allow passing of new arguments.Keyboards that are built without using the KeyboardButton objects.
/command@botname by correctly passing them the bot name./command@botname by correctly passing them the bot name.Nothing published for this version
Bot name is shown in help command (thanks to @RafaelDelboni )
Nothing published for this version
Starting support for inline bot
One column per quarter.