telegram-bot-api-versions/README.md
2021-06-16 17:31:24 +02:00

13 KiB

Telegram Bot API versions

This repository aims to store a schema for every version of the Telegram Bot API.

The goal is achieved by using TGScraper. Old bot API schemas have been extracted by using The Wayback Machine.

NOTE: some versions may be broken, I haven't tested nor checked everything.

Versions list

Version Description Release date Schema
1.0 First release. June 24, 2015 v1.0.json
1.1 Minor changes. July 2015 v1.1.json
1.2 Voice messages. August 15, 2015 Not available.
1.3 Support for self-signed certificates and webhook payload requests. August 29, 2015 Not available.
1.4 JSON requests, basic Markdown support. September 7, 2015 v1.4.json
1.5 Download files and media sent by users. September 18, 2015 v1.5.json
1.6 Introduced channel support for bots. October 8, 2015 v1.6.json
1.7 Introduced supergroup support for bots. November 2015 Not available.
1.8 Inline mode support. January 4, 2016 v1.8.json
1.8.1 Added ChosenInlineResult. January 14, 2016 Not available.
1.8.2 Added support for HTML-style formatting. January 20, 2016 v1.8.2.json
1.8.3 Support for sending silent messages. February 20, 2016 v1.8.3.json
2.0 Message editing, inline keyboards introduced, improved inline mode, basic administration tools. April 9, 2016 v2.0.json
2.0.1 Minor changes. May 6, 2016 Not available.
2.0.2 Message consistency for bot in groups and supergroups. May 12, 2016 Not available.
2.1 More administration tools, support for edited messages and mentions. May 22, 2016 v2.1.json
2.1.1 Added support for inline keyboards in groups. May 25, 2016 v2.1.json*
2.2 Gaming Platform, various changes. October 3, 2016 v2.2.json
2.3 Channel post updates, callback query cache, other changes. November 21, 2016 v2.3.json
2.3.1 Webhook improvements. December 4, 2016 v2.3.1.json
3.0 Payment Platform, video messages, language code. May 18, 2017 v3.0.json
3.1 ChatMember permissions, temporary bans, support for pinning and unpinning messages. June 30, 2017 v3.1.json
3.2 Support for sticker sets management. July 21, 2017 v3.2.json
3.3 Support for creating mentions, other minor changes. August 23, 2017 v3.3.json
3.4 Support for Live Location and group sticker sets management. October 11, 2017 Not available.
3.5 Media albums, message pinning in channel. November 17, 2017 v3.5.json
3.6 Text formatting in captions, Login Widget support. February 13, 2018 v3.6.json
4.0 Telegram Passport, edit media content in messages, other major changes. July 26, 2018 v4.0.json
4.1 Minor changes for Telegram Passport. August 27, 2018 v4.1.json
4.2 Added Poll support, pin messages in basic groups, other major changes. April 14, 2019 v4.2.json
4.3 Seamless Telegram Login, ReplyMarkup included in Message object. May 31, 2019 v4.3.json
4.4 Support for animated stickers and default chat permissions. July 29, 2019 v4.4.json
4.5 MarkdownV2 support, nested Message entities, file unique ID, custom administrator title. December 31, 2019 v4.5.json
4.6 Polls 2.0, improved getMe. January 23, 2020 v4.6.json
4.7 Dice support, setMyCommands and getMyCommands, support for creating animated sticker packs. March 30, 2020 v4.7.json
4.8 Dart support for dice, explanations for quizzes, automatically close poll. April 24, 2020 v4.8.json
4.9 via_bot field in Message object, basketball support for dice. June 4, 2020 v4.9.json
5.0 Self-host Bot API, transfer bot ownership, other major changes. November 4, 2020 v5.0.json
5.1 New Update type: ChatMemberUpdated. Improved chat invite links, voice chats support, other major changes. March 9, 2021 v5.1.json
5.2 (current) Payments 2.0, other minor changes. April 26, 2021 v5.2.json

*Unchanged from previous version.