58461
The official source for news about the Telegram Bot API. https://core.telegram.org/bots
Bot API 7.2
Telegram Business
• Bots can now manage private chats of Telegram Business subscribers who connect them to their account – check out BusinessConnection.
• Connected bots will receive updates about new messages, message edits and deletions in business chats they manage.
• Added the parameter business_connection_id to most send methods – to send messages on behalf of business users.
• Bots can now see business account details, such as their intro, opening hours and location.
Request Names, Usernames and Photos
• Bots can now request names, usernames and photos via new fields in the KeyboardButtonRequestUsers class.
• Likewise, bots can now use KeyboardButtonRequestChat to request chats' titles, usernames and photos.
Stickers
• Introduced support for mixed-format sticker packs.
• Regular sticker sets now support up to 120 stickers.
• Bots can now upload WEBM stickers using sendSticker.
• Simplified sticker replacement via the new replaceStickerInSet method.
General
• Mini Apps now support biometric authentication.
• The Chat class may now contain the user's birthday and personal channel.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#march-31-2024
Note: We have updated our Terms of Service for Telegram Bot Developers, kindly check out the latest version here.
Bot API 7.0
Announcing our biggest Bot API update yet!
Reactions
• Introducing full reaction support for bots.
• Bots can now react to messages with setMessageReaction.
• Message reactions now generate updates for bots.
• Added the available_reactions field to the class Chat.
Replies 2.0
• Bots can now reply to messages in other chats or topics.
• Added the ExternalReplyInfo class, to track replies across chats.
• The new class ReplyParameters replaces individual reply options in all relevant methods and lets bots quote parts of any message.
• The new field quote of the class Message lets bots detect incoming quoted text.
Link Preview Customization
• Bots can now set a custom URL to generate link previews in outgoing messages.
• Added support for custom size and position of link previews.
• Added the class LinkPreviewOptions to support these new options.
Batch Actions
• Bots can now delete multiple messages in a single request via deleteMessages.
• Bots can now forward or copy multiple messages in a single request via the respective forwardMessages and copyMessages methods.
Boosts & Giveaways
• Added support for Giveaway messages, allowing bots to detect their creation and completion.
• Added updates about chat boost changes via the new classes ChatBoostUpdated and ChatBoostRemoved.
• Bots can now see if a boost came from a premium sub, a gift code, or a giveaway, as well as check all active user boosts via getUserChatBoosts.
General
• Blockquotes are now supported in MarkdownV2 and HTML parse modes.
• Web Apps won't close when calling openTelegramLink.
• Web Apps can now toggle the visibility and on-click behavior of the Settings Button.
• Bots can now request multiple users, see KeyboardButtonRequestUsers.
• The class Chat has new fields holding profile and background colors, custom emoji, and more.
• And a great deal more. See the full changelog for details:
https://core.telegram.org/bots/api-changelog#december-29-2023
Happy Holidays from the Telegram Team 🎆
Bot API 6.8
• Bots can now detect forwarded stories via an empty Story object in the new story field of the Message class.
• Added support for chat voters in non-anonymous Polls via the new field voter_chat in PollAnswer.
• Added the field emoji_status_expiration_date to the Chat class.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#august-18-2023
Bot API 6.7
Unlimited Web Apps
• Web Apps can now be launched from any chat – to play multiplayer games, work together in groups or create content on the fly.
• Launch Web Apps with inline query results or direct links.
Collectible Usernames & Custom Emoji
• Collectible usernames can be upgraded and assigned to bots – including usernames that don't end in -bot.
• Bots that are using collectible usernames can now send Custom Emoji via HTML and MarkdownV2.
Bot Profile
• Users can now edit bots directly from their Telegram profile, including setting a new name, description or animated profile photos.
• Introduced support for localized bot names that are shown based on the user's language.
General
• InlineKeyboardButton can now be used to switch to inline mode in any chosen chat for a given type.
• The ChatMemberUpdated class now distinguishes joins coming from Shared Folder invite links.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#april-21-2023
New payment providers added:
• bill_line
• Freedom Pay
• PayBox.money
More about bot payments:
https://core.telegram.org/bots/payments
Bot API 6.4
Forums
• Bots can now open, close, edit and toggle the visibility of the General Topic.
• Added support for new service messages, like ForumTopicEdited, GeneralForumTopicHidden and more.
• The method sendChatAction can now send actions to any thread or topic via the message_thread_id parameter.
Spoilers
• Added spoiler detection via the new has_media_spoiler field in the Message class.
• Bots can send media covered by a spoiler animation via the has_spoiler field in sendPhoto, sendVideo and sendAnimation.
Web Apps
• Added a native QR scanner popup, controllable via showScanQrPopup and closeScanQrPopup.
• Web Apps launched from the attachment menu can request clipboard text via readTextFromClipboard.
• Added a platform field, showing which platform the web app is being used on.
General
• Added the is_persistent field, to keep ReplyKeyboards open by default.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#december-30-2022
Many thanks to everyone who submitted bots for our Bot Contest! We have collected a lot of requests.
New applications are no longer accepted – this stage of the contest is over. We will continue awarding creators of great bots this year. Have fun using and building bots in 2018!
The Bot API v.3.4 is here!
- Added support for the new Live Locations feature (see the Telegram blog).
- Bots can now get special entities like usernames, URLs, etc. from media captions.
- Bots can now get and manage the official sticker set of groups.
See the full changelog here:
https://core.telegram.org/bots/api-changelog#october-11-2017
African bot developers, rejoice! Rave by Flutterwave is now available as a payment option in the Bot API.
To connect it to your bot, pay a visit to @BotFather > Edit Bot > Payments and select Rave by Flutterwave there.
Read more about the platform here: https://core.telegram.org/bots/payments
A new provider has been added to the Bot Payment Platform: CLICK.
To connect it to your bot, pay a visit to @BotFather > Edit Bot > Payments and select CLICK Uzbekistan there. Read more about the platform here: https://core.telegram.org/bots/payments
The Bot Payment Platform currently supports payments from more than 200 countries via 5 payment providers.
Bot API v.3.1 is here! Build your own robotic police force for supergoups with these new methods for admin bots:
- Ban and restrict group members
- Promote new admins
- Manage group info and invite links
See full changelog:
https://core.telegram.org/bots/api-changelog#june-30-2017
Finally, our DNS provider fixed it (took them a while, sorry).
You may still see some residual issues due to caching, but things will get back to normal very soon.
Bot API v.3.0 is here!
- Brand new payment platform. Stripe supported out of the box, a dozen more payment providers on the way. See the Telegram blog for details:
https://telegram.org/blog/payments
- Tools for sending and receiving the new video messages.
- The User object now has a field for the user's language.
- Bot admins can unban people in channels.
- Bots can delete messages.
- And more...
See the full changelog:
https://core.telegram.org/bots/api-changelog#may-18-2017
Introducing The Telegraph API
You can now create bots and standalone tools to log in and manage Telegraph posts, and get page view statistics for any post on Telegraph.
See the @Telegraph bot for an example.
API Documentation:
http://telegra.ph/api
Bot API v.2.3 is now live!
- Bot privacy mode updated for the sake of consistency.
- Bots can now get messages from channels as updates.
- And more.
Full changelog:
https://core.telegram.org/bots/api#recent-changes
Bot API 7.1
Custom Emoji
• Bots can now get the custom emoji sticker set chosen by a group and use any custom emoji from it.
Boosts
• Added support for boost_added service messages, about new boosts added to the chat.
• Added the field sender_boost_count to the class Message, counting boosts added by the sender that are active on the message send date.
Stories
• Bots can now check if admins have the rights to post, edit and delete stories in supergroups.
• Added the field reply_to_story to the class Message.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#february-16-2024
Bot API 6.9
Mini Apps
• Added support for free Cloud Storage, hosted by Telegram.
• Mini Apps can now set any header color with setHeaderColor.
• Added the requestContact method, to ask the user's phone number.
• Added the requestWriteAccess method, to obtain permission to text the user.
Stories
• Bots can now assign the can_post_stories, can_edit_stories and can_delete_stories privileges to other admins.
• Added the respective fields to ChatMemberAdministrator, ChatAdministratorRights and parameters promoteChatMember.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#september-22-2023
New payment provider added:
• Chapa 🇪🇹
More about bot payments:
https://core.telegram.org/bots/payments
Bot API 6.6
Localized Descriptions
• Bots now support localized descriptions that are shown based on the user's language.
• Added the methods setMyDescription and setMyShortDescription to set the bot's localized description and short description.
• Added the methods getMyDescription and getMyShortDescription to obtain the bot's description or short description for a given language.
Stickers and Emoji
• Bots can now create custom emoji sticker sets with createNewStickerSet.
• Added support for adaptive custom emoji colors via the needs_repainting parameter in the createNewStickerSet method.
• Added the ability to specify search keywords for stickers added to sticker sets.
• Improved editing options for sticker sets, including changing the title, deleting a pack, editing emoji lists and more.
https://core.telegram.org/bots/api-changelog#march-9-2023
Note: Mentions of thumb across all methods and classes have been updated to thumbnail.
Bot API 6.5
Chat and User Selection
• Bots can now show a friendly interface that can be used to select any channel, group or user.
• Added the KeyboardButtonRequestUser and KeyboardButtonRequestChat keyboard buttons for private chats.
• Added support for "user_shared" and "chat_shared" service messages, which hold the identifiers of users and chats shared via the buttons.
Improved Permissions
• Added support for granular media permissions by replacing can_send_media_messages in ChatMemberRestricted and ChatPermissions with several separate fields for the respective media type.
• Added the parameter use_independent_chat_permissions to the methods restrictChatMember and setChatPermissions.
• Added the field user_chat_id to the class ChatJoinRequest.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#february-3-2023
Bot API 6.3
Topics
• Bots now support Topics in Groups.
• Added the fields is_forum and is_topic_message to Chat and Message respectively.
• Bots can send messages to a topic via the new message_thread_id parameter.
• Added service messages about new, closed and reopened topics, each with an optional field in Message.
• Bots can now create, close, edit and delete topics.
• Added chat member permissions for topic management, see can_manage_topics as a field in all relevant classes and as a parameter in promoteChatMember.
Multiple Usernames and Emoji Status
• Multiple Usernames are listed by the active_usernames field in the Chat class.
• Custom user statuses are now shown in the emoji_status_custom_emoji_id field returned from getChat.
• And more, see the full changelog for details:
https://core.telegram.org/bots/api-changelog#november-5-2022
The Bot API v.3.5 is alive and well.
- Added support for the new albums feature.
- Added support for pinned messages in channels.
Full changelog:
https://core.telegram.org/bots/api-changelog#november-17-2017
Some more good news for bot developers from Russia. Sberbank is now available as a payment option in the Bot API.
To connect it to your bot, pay a visit to @BotFather > Edit Bot > Payments and select Sberbank.
Read more about the platform here: https://core.telegram.org/bots/payments
The Bot API v.3.3 has arrived!
- Mention users via inline mentions, without using usernames.
- Get pinned messages from group chats.
- And a little more.
See the full changelog here:
https://core.telegram.org/bots/api-changelog#august-23-2017
May the Bot API v.3.2 be with you! Your bot can now handle sticker sets:
- Create sets of stickers or masks
- Rearrange and delete stickers from sets
See full changelog:
https://core.telegram.org/bots/api-changelog#july-21-2017
The Bot Payment Platform now supports payments from more than 200 countries via 4 payment providers.
Three new payment providers have joined the platform since launch:
- Paymentwall, a global provider that works in 200 countries
- Yandex.Money, well known in Russia
- Paycom, popular in Uzbekistan
To connect them to your bot, pay a visit to @BotFather > Edit Bot > Payments. Read more about the platform here: https://core.telegram.org/bots/payments
We will be adding more payment providers soon.
We're having some DNS issues with our web properties (the issues are not on our side). Messaging is alive and well, but your bot may have trouble reaching api.telegram.org until this is resolved. Working on this, back soon!
Sorry about that.
Moar good news, everyone!
We're extending the #BotPrize and will continue giving out grants to great bots in 2017.
Introducing Bot API 2.3.1, a nifty little update that will give you more control over how your bot gets its updates.
Changelog:
https://core.telegram.org/bots/api-changelog#december-4-2016
In the coming Bot API update, the edit_message parameter in setGameScore will default to True (currently defaults to False).
Please consider explicitly passing False in the cases where you don't want the message with high scores to be updated.
https://core.telegram.org/bots/api#setgamescore