Bot API 6.1
Telegram Premium
• To support 4GB files uploaded by premium accounts,
• Bots can now distinguish premium Users and Stickers with the new respective fields
Web Apps
• Added several methods and fields to the class WebApp to handle API version, additional colors, haptic feedback and more.
• Added the events
• Updated ThemeParams, MainButton and WebAppInitData with new fields and methods.
Groups, Payments and Attachment Menu
• Bots can now process join requests created without an invite link – they will still receive a
• HTTP links for invoices can be generated with the new createInvoiceLink method.
• Bots can now detect when a user added them to their attachment menu via the new
• Check that your bot's webhook was set by you with the new secret_token parameter.
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#june-20-2022
Warning: Only HTTPS links are now allowed in
Telegram Premium
• To support 4GB files uploaded by premium accounts,
file_size
in most media classes can no longer be stored in a signed 32-bit integer type.• Bots can now distinguish premium Users and Stickers with the new respective fields
is_premium
and premium_animation
.Web Apps
• Added several methods and fields to the class WebApp to handle API version, additional colors, haptic feedback and more.
• Added the events
backButtonClicked
, settingsButtonClicked
and invoiceClosed
.• Updated ThemeParams, MainButton and WebAppInitData with new fields and methods.
Groups, Payments and Attachment Menu
• Bots can now process join requests created without an invite link – they will still receive a
chat_join_request
update.• HTTP links for invoices can be generated with the new createInvoiceLink method.
• Bots can now detect when a user added them to their attachment menu via the new
added_to_attachment_menu
field. Integrated bots can now also be used in groups, supergroups and channels.• Check that your bot's webhook was set by you with the new secret_token parameter.
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#june-20-2022
Warning: Only HTTPS links are now allowed in
login_url
.Bot API 6.2
Custom Emoji
• Bots can identify custom emoji sent by Telegram Premium users via the new type "custom_emoji" and field custom_emoji_id added to the MessageEntity class.
• Added the method getCustomEmojiStickers to obtain information about specific emoji.
• Added the fields type and custom_emoji_id to the Sticker class.
• Added sticker_type as a new field for StickerSet and as a new parameter for createNewStickerSet.
Web Apps
• Implemented support for native dialog windows including alerts, popups with custom buttons and confirmation messages.
• A confirmation dialog can now be shown when users close the web app. The dialog can be toggled via the enableClosingConfirmation and disableClosingConfirmation functions.
• Added the field is_premium to the WebAppUser class — the standard User class already included this field, see version 6.1.
• Added has_restricted_voice_and_video_messages to the Chat class to support the new premium setting.
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#august-12-2022
Note: The documentation for createNewStickerSet and StickerSet no longer mentions the contains_masks parameter and field respectively. In both instances, contains_masks will continue to work for backward compatibility but developers should use sticker_type instead.
Custom Emoji
• Bots can identify custom emoji sent by Telegram Premium users via the new type "custom_emoji" and field custom_emoji_id added to the MessageEntity class.
• Added the method getCustomEmojiStickers to obtain information about specific emoji.
• Added the fields type and custom_emoji_id to the Sticker class.
• Added sticker_type as a new field for StickerSet and as a new parameter for createNewStickerSet.
Web Apps
• Implemented support for native dialog windows including alerts, popups with custom buttons and confirmation messages.
• A confirmation dialog can now be shown when users close the web app. The dialog can be toggled via the enableClosingConfirmation and disableClosingConfirmation functions.
• Added the field is_premium to the WebAppUser class — the standard User class already included this field, see version 6.1.
• Added has_restricted_voice_and_video_messages to the Chat class to support the new premium setting.
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#august-12-2022
Note: The documentation for createNewStickerSet and StickerSet no longer mentions the contains_masks parameter and field respectively. In both instances, contains_masks will continue to work for backward compatibility but developers should use sticker_type instead.
New payment provider added:
• Paykassma 🇮🇳
More about bot payments:
https://publielectoral.lat/s/fxnotez/bots/payments
• Paykassma 🇮🇳
More about bot payments:
https://publielectoral.lat/s/fxnotez/bots/payments
General Documentation about Bots Updated!
• Introduction for Developers
Shows how bots can bring any idea to life – replacing websites, creating shops, automating tasks and integrating services.
• Telegram Bot Features
Explains bot features in depth with tips, quick-start guides and cheat sheets on all possible inputs, interfaces, commands and more.
• Tutorial: From BotFather to ‘Hello World’
Teaches how to build your own bot with a step-by-step tutorial – and explores advanced topics like improving logic and navigation.
Check out the new docs to find more tips, features and ideas for your next project.
• Introduction for Developers
Shows how bots can bring any idea to life – replacing websites, creating shops, automating tasks and integrating services.
• Telegram Bot Features
Explains bot features in depth with tips, quick-start guides and cheat sheets on all possible inputs, interfaces, commands and more.
• Tutorial: From BotFather to ‘Hello World’
Teaches how to build your own bot with a step-by-step tutorial – and explores advanced topics like improving logic and navigation.
Check out the new docs to find more tips, features and ideas for your next project.
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://publielectoral.lat/s/fxnotez/bots/api-changelog#november-5-2022
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://publielectoral.lat/s/fxnotez/bots/api-changelog#november-5-2022
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
Spoilers
• Added spoiler detection via the new
• Bots can send media covered by a spoiler animation via the
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
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#december-30-2022
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://publielectoral.lat/s/fxnotez/bots/api-changelog#december-30-2022
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 "
Improved Permissions
• Added support for granular media permissions by replacing
• Added the parameter
• Added the field
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#february-3-2023
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://publielectoral.lat/s/fxnotez/bots/api-changelog#february-3-2023
New payment providers added:
• bill_line
• Freedom Pay
• PayBox.money
More about bot payments:
https://publielectoral.lat/s/fxnotez/bots/payments
• bill_line
• Freedom Pay
• PayBox.money
More about bot payments:
https://publielectoral.lat/s/fxnotez/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
• 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://publielectoral.lat/s/fxnotez/bots/api-changelog#march-9-2023
Note: Mentions of thumb across all methods and classes have been updated to thumbnail.
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://publielectoral.lat/s/fxnotez/bots/api-changelog#march-9-2023
Note: Mentions of thumb across all methods and classes have been updated to thumbnail.
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://publielectoral.lat/s/fxnotez/bots/api-changelog#april-21-2023
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://publielectoral.lat/s/fxnotez/bots/api-changelog#april-21-2023
New payment provider added:
• Chapa 🇪🇹
More about bot payments:
https://publielectoral.lat/s/fxnotez/bots/payments
• Chapa 🇪🇹
More about bot payments:
https://publielectoral.lat/s/fxnotez/bots/payments
Bot API 6.8
• Bots can now detect forwarded stories via an empty Story object in the new
• Added support for chat voters in non-anonymous Polls via the new field
• Added the field
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#august-18-2023
• 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://publielectoral.lat/s/fxnotez/bots/api-changelog#august-18-2023
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
• Added the respective fields to ChatMemberAdministrator, ChatAdministratorRights and parameters promoteChatMember.
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#september-22-2023
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://publielectoral.lat/s/fxnotez/bots/api-changelog#september-22-2023
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
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
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
• 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://publielectoral.lat/s/fxnotez/bots/api-changelog#december-29-2023
Happy Holidays from the Telegram Team 🎆
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://publielectoral.lat/s/fxnotez/bots/api-changelog#december-29-2023
Happy Holidays from the Telegram Team 🎆
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
• Added the field
Stories
• Bots can now check if admins have the rights to post, edit and delete stories in supergroups.
• Added the field
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#february-16-2024
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://publielectoral.lat/s/fxnotez/bots/api-changelog#february-16-2024
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
• 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://publielectoral.lat/s/fxnotez/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.
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://publielectoral.lat/s/fxnotez/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.3
Telegram Business
• Messages sent on behalf of a business account now support
Live Locations
• Added support for live locations that can be edited indefinitely.
• Bots can now edit live periods via the new
General
• Added support for custom emoji in Polls.
• Added the field
• Bots can now detect service messages about background changes in chats via the new
• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#may-6-2024
Note: The method getChat now returns the new ChatFullInfo class, which has been split out from Chat.
Telegram Business
• Messages sent on behalf of a business account now support
url
, login_url
, and callback_game
inline buttons.Live Locations
• Added support for live locations that can be edited indefinitely.
• Bots can now edit live periods via the new
live_period
parameter.General
• Added support for custom emoji in Polls.
• Added the field
via_join_request
to ChatMemberUpdated, for users whose join request was approved.• Bots can now detect service messages about background changes in chats via the new
chat_background_set
field in Message.• And more, see the full changelog for details:
https://publielectoral.lat/s/fxnotez/bots/api-changelog#may-6-2024
Note: The method getChat now returns the new ChatFullInfo class, which has been split out from Chat.