Changelog da Telegram Bot API
Todas as mudanças da Telegram Bot API desde a versão 9.0 (abril de 2025) até a atual Bot API 10.5 (22 de novembro de 2026), das mais recentes para as mais antigas. Os nomes dos métodos levam à nossa referência com parâmetros e exemplos; os nomes das classes levam à documentação oficial.
Bot API 10.5 Mais recente
Novos métodos: setMySettings
Configurações do bot
- Adicionado o método setMySettings, que permite aos bots alterar suas configurações, incluindo as do modo inline, o modo de privacidade, a possibilidade de ser adicionado a grupos, o modo de tópicos do fórum em chats privados e o modo de recebimento de consultas de callback.
- Adicionada a possibilidade de receber consultas de callback de botões em mensagens enviadas pelo bot com o campo inline_message_id em vez do campo message na classe CallbackQuery, dependendo do parâmetro callback_query_mode do método setMySettings.
- Adicionada a possibilidade de os bots exibirem a lista de tópicos em uma barra lateral nos chats privados com o bot, por meio do parâmetro has_topic_sidebar do método setMySettings.
- A classe BotFullInfo foi separada da classe User, e o tipo de retorno do método getMe passou a ser BotFullInfo. Os campos que eram retornados apenas em getMe foram removidos da classe User.
- Adicionado o campo active_usernames à classe BotFullInfo, que permite ao bot obter a lista de todos os seus usernames ativos.
- Adicionado o campo inline_query_placeholder à classe BotFullInfo, que permite ao bot obter seu placeholder para consultas inline.
- Adicionado o campo needs_inline_query_location à classe BotFullInfo, que permite ao bot verificar se ele solicita a localização do usuário a cada consulta inline.
- Adicionado o campo has_topic_sidebar à classe BotFullInfo, que permite ao bot verificar se os tópicos nos chats privados com o bot são exibidos em uma barra lateral.
Geral
- Adicionada a possibilidade de os donos de bots convidarem até 10 usuários de uma vez para chats privados com o bot pelo link
https://t.me/botinvite/<bot_username>. O bot pode enviar mensagens aos usuários convidados. - Adicionado o campo inviter à classe WriteAccessAllowed para mensagens de serviço sobre usuários convidados pelo dono do bot para o chat privado com o bot.
- O campo text foi substituído pelo campo blocks nas classes RichBlockExpandableBlockQuotation e InputRichBlockExpandableBlockQuotation, permitindo que citações expansíveis contenham blocos arbitrários.
Bot API 10.4
Novos métodos: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widgets
- Adicionada a classe Widget e o campo widget às classes Message e ExternalReplyInfo para mensagens com widgets HTML.
- Adicionado o método sendWidget, que permite aos bots enviar mensagens com widgets HTML. Por enquanto, no ambiente de produção, widgets só podem ser enviados para chats privados, e os widgets enviados têm conteúdo protegido automaticamente, por isso não podem ser encaminhados.
- Adicionado o método sendSharedWidget, que permite aos bots reenviar widgets compartilhados criados pelo bot.
- Adicionada a classe WidgetQuery e o campo widget_query à classe Update para consultas enviadas ao bot por widgets em mensagens enviadas pelo bot ou por meio dele.
- Adicionada a classe SharedWidgetQuery e o campo shared_widget_query à classe Update para consultas enviadas ao bot a partir de mensagens encaminhadas com widgets compartilhados.
- Adicionadas as classes WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction e WidgetQueryWallet, que descrevem o tipo de uma consulta de um widget. Uma consulta pode conter dados para o bot junto com o cartão da carteira TON do usuário, dados assinados por uma carteira TON do usuário ou uma notificação sobre uma transação enviada de uma carteira TON do usuário.
- Adicionado o método answerWidgetQuery, que permite aos bots responder a consultas de widgets.
- Adicionado o método editMessageWidgetData, que permite aos bots alterar os dados de um widget em uma mensagem.
- Adicionado o método editSharedWidgetData, que permite aos bots alterar os dados públicos de um widget compartilhado.
- Adicionadas as classes InputWidgetMessageContent e InputSharedWidgetMessageContent, que permitem aos bots enviar widgets em resposta a consultas inline. Por enquanto, widgets não podem ser enviados em resposta a consultas inline no ambiente de produção.
- Mensagens com widgets não podem ser copiadas com os métodos copyMessage e copyMessages.
- O direito can_send_other_messages nas classes ChatPermissions e ChatMemberRestricted agora também permite enviar widgets.
Mensagens efêmeras
- Os bots agora podem enviar respostas efêmeras a consultas de callback em qualquer chat, exceto chats de mensagens diretas de canais, informando callback_query_id sem receiver_user_id no parâmetro ephemeral_message_parameters dos métodos sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote e sendVoice.
- O campo receiver_user_id da classe EphemeralMessageParameters e o parâmetro chat_id dos métodos mencionados agora são opcionais.
Citações de mensagens ricas
- Adicionado o campo rich_texts à classe TextQuote para citações escolhidas de uma RichMessage.
- Adicionado o campo quote_rich_texts à classe ReplyParameters, que permite aos bots citar mensagens ricas.
Carteira TON
- Adicionadas as classes TonWalletCard, TonWalletCardSticker, TonNft e TonNftAttribute, além do campo ton_wallet_card à classe ChatFullInfo.
- Adicionada a classe TonWalletTransfer e o campo ton_wallet_transfer à classe Message para mensagens de serviço sobre transferências com uma carteira TON.
- A classe StoryAreaPosition foi renomeada para AreaPosition, pois agora também é usada para descrever a posição de stickers nos cartões de carteira TON.
Temas da tela de compartilhamento
- Adicionadas as classes ChatShareTheme, ChatShareThemeEmoji e ChatShareThemeUniqueGift, além do campo share_theme à classe ChatFullInfo, que descrevem o tema da tela de compartilhamento do link de um usuário ou chat.
- Adicionadas as classes EmojiType, EmojiTypeEmoji e EmojiTypeCustomEmoji.
- Adicionadas as classes ChatShareThemeBackdrop e ChatShareThemeBackdrops e o método getChatShareThemeBackdrops.
Presentes
- Adicionado o método getUniqueGift, que permite aos bots obter informações sobre um presente único pelo nome.
- Adicionado o método deleteBusinessAccountGift, que permite aos bots apagar presentes comuns de uma conta comercial gerenciada sem receber Telegram Stars por eles.
Geral
- Usuários com assinatura do Telegram Premium agora podem atribuir usernames secundários terminados em “agent”, “ai”, “app”, “game” ou “gay” a até 2 bots próprios. Esses usernames podem ser sugeridos no campo suggested_username da classe KeyboardButtonRequestManagedBot.
- Adicionada a classe RichTextTonAddress, que representa um endereço na blockchain TON em uma RichMessage.
- Adicionado o tipo “ton_address” à classe MessageEntity para endereços na blockchain TON.
- Adicionado o tipo “bank_card_number” à classe MessageEntity para números de cartão bancário.
- Adicionados os parâmetros custom_description_parse_mode e custom_description_entities aos métodos verifyUser e verifyChat.
- Adicionada a classe PaidMessagesWaived e o campo paid_messages_waived à classe Message para mensagens de serviço sobre o remetente usar um link que permite enviar mensagens sem pagar Telegram Stars.
- Adicionada a possibilidade de criar links para tópicos em chats privados com o bot no formato
https://t.me/<bot_username>/<message_thread_id>. Esse link abre o tópico apenas para o usuário do chat privado em que o tópico existe.
Bot API 10.3
Mensagens ricas
- Adicionada a classe RichMessageButton, que representa um botão em uma RichMessage.
- Adicionada a classe RichTextButton.
- Adicionadas as classes RichBlockButtons e InputRichBlockButtons.
- Adicionado o campo is_compact às classes RichBlockTable e InputRichBlockTable.
- Adicionadas as classes RichBlockExpandableBlockQuotation e InputRichBlockExpandableBlockQuotation, que representam uma citação em bloco que pode ser expandida e recolhida.
- Adicionadas as classes RichBlockDocument e InputRichBlockDocument, que contêm um arquivo.
- Adicionado suporte a links no formato
tg://document?id=para upload de arquivos genéricos em mensagens ricas.
Mensagens efêmeras
- Adicionada a classe EphemeralMessageParameters, e os parâmetros receiver_user_id e callback_query_id dos métodos sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation e sendVenue foram substituídos pelo parâmetro ephemeral_message_parameters.
- Adicionado o parâmetro ephemeral_message_parameters ao método sendRichMessage.
- Adicionado o campo replace_callback_query_message à classe EphemeralMessageParameters, que permite aos bots exibir uma mensagem efêmera no lugar da mensagem original.
- Adicionado suporte ao upload de novos arquivos em editEphemeralMessageMedia.
- Adicionado o parâmetro show_caption_above_media ao método editEphemeralMessageCaption.
- Adicionado o parâmetro rich_message ao método editEphemeralMessageText.
- Adicionado o campo can_send_welcome_messages às classes ChatAdministratorRights e ChatMemberAdministrator.
- Adicionado o parâmetro can_send_welcome_messages ao método promoteChatMember.
Reply markup
- Adicionada a classe DisabledButton e o campo disabled à classe InlineKeyboardButton.
- Adicionado o campo force_reply às classes InlineKeyboardMarkup e ReplyKeyboardMarkup.
Geral
- Adicionados os parâmetros can_stop e keep_on_stop aos métodos sendMessageDraft e sendRichMessageDraft.
- Adicionados updates sobre o usuário interromper a geração de uma mensagem, representados pela classe MessageGenerationStopped e pelo campo stopped_message_generation na classe Update.
- Adicionada a classe CommunityChatJoined e o campo community_chat_joined à classe Message para mensagens de serviço sobre a entrada em um chat de uma comunidade.
- Adicionados os campos text, entities e is_private à classe UniqueGiftInfo.
Bot API 10.2
Novos métodos: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Mensagens ricas
- Adicionada a classe InputRichMessageMedia e o campo media à classe InputRichMessage, que permitem aos bots especificar explicitamente a mídia usada na formatação markdown ou html ao enviar uma mensagem rica.
- Adicionada a classe InputMediaVoiceNote, que representa uma mensagem de voz a ser enviada.
- Adicionada a classe InputRichBlockListItem, que representa um item de uma lista a ser enviada.
- Adicionadas as classes InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote e InputRichBlockThinking, que representam os diferentes tipos de blocos disponíveis para formatar uma mensagem rica a ser enviada.
- Adicionado o campo blocks à classe InputRichMessage, que permite aos bots definir a formatação da mensagem rica por meio de entidades de bloco.
Mensagens efêmeras
- Introduzido o suporte a mensagens efêmeras, que permitem aos bots enviar mensagens em grupos e receber comandos visíveis apenas para um usuário específico e para o bot.
- Adicionado o campo is_ephemeral à classe BotCommand.
- Adicionado o campo receiver_user à classe Message.
- Adicionado o campo ephemeral_message_id à classe Message.
- Adicionados os parâmetros receiver_user_id e callback_query_id aos métodos sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation e sendVenue.
- Adicionado o campo ephemeral_message_id à classe ReplyParameters, que permite aos bots responder a mensagens efêmeras.
- O campo message_id da classe ReplyParameters passou a ser opcional se o campo ephemeral_message_id estiver presente.
- Adicionados os métodos editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption e editEphemeralMessageReplyMarkup, que permitem aos bots editar mensagens efêmeras.
- Adicionado o método deleteEphemeralMessage, que permite aos bots apagar mensagens efêmeras.
Comunidades
- Introduzido o suporte inicial a comunidades: vários supergrupos, canais e bots vinculados em torno de um tema ou público em comum.
- Adicionada a classe Community, que representa uma comunidade.
- Adicionada a classe CommunityChatAdded e o campo community_chat_added à classe Message.
- Adicionada a classe CommunityChatRemoved e o campo community_chat_removed à classe Message.
- Adicionado o campo community à classe ChatFullInfo.
Geral
- Adicionados updates sobre mudanças na assinatura paga de um usuário, representados pela classe BotSubscriptionUpdated e pelo campo subscription na classe Update.
- A segurança dos Mini Apps foi reforçada: os métodos de Mini App não podem mais ser usados a partir de origens diferentes do domínio original do Mini App. A proteção será ativada automaticamente para todos os Mini Apps em 20 de julho de 2026. É possível desativá-la pelo Mini App do @BotFather. Ao fazer isso, você reconhece que cabe ao bot garantir que o Mini App não tenha links para sites não confiáveis.
Bot API 10.1
Novos métodos: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Mensagens ricas
- Adicionado suporte a mensagens ricas, que permitem aos bots enviar texto altamente estruturado e fazer streaming de respostas geradas por IA com formatação rica contínua.
- Adicionadas as classes RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference e RichTextReferenceLink, que representam os diferentes tipos de texto com formatação rica.
- Adicionada a classe RichText, que representa texto com formatação rica.
- Adicionada a classe RichBlockCaption, que representa a legenda de um texto com formatação rica.
- Adicionada a classe RichBlockTableCell, que representa uma célula de uma tabela.
- Adicionada a classe RichBlockListItem, que representa um item de uma lista.
- Adicionadas as classes RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote e RichBlockThinking, que representam os diferentes tipos de blocos de uma mensagem com formatação rica.
- Adicionada a classe RichBlock, que representa um bloco de uma mensagem com formatação rica.
- Adicionada a classe RichMessage, que representa uma mensagem com formatação rica.
- Adicionado o campo rich_message à classe Message.
- Adicionada a classe InputRichMessage, que descreve uma mensagem rica a ser enviada.
- Adicionada a classe InputRichMessageContent, que pode ser usada como InputMessageContent nos resultados de consultas inline, de convidado e de Web App.
- Adicionado o método sendRichMessage, que permite aos bots enviar mensagens ricas.
- Adicionado o método sendRichMessageDraft, que permite aos bots fazer streaming de mensagens ricas parciais.
- Adicionado o parâmetro rich_message ao método editMessageText, que permite aos bots editar mensagens ricas.
Consultas de solicitação de entrada
- Adicionado o campo supports_join_request_queries à classe User.
- Adicionado o campo guard_bot à classe ChatFullInfo.
- Adicionado o campo query_id à classe ChatJoinRequest.
- Adicionado o método answerChatJoinRequestQuery.
- Adicionado o método sendChatJoinRequestWebApp.
Enquetes
- Adicionada a classe Link e o campo link à classe PollMedia.
- Adicionada a classe InputMediaLink, que pode ser usada como InputPollOptionMedia.
Bot API 10.0
Novos métodos: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Modo convidado
- Introduzido o suporte ao modo convidado, que permite aos bots receber certas mensagens e responder em chats dos quais não são membros.
- Adicionado o campo supports_guest_queries à classe User.
- Adicionados os campos guest_bot_caller_user e guest_bot_caller_chat à classe Message.
- Adicionado o campo guest_query_id à classe Message.
- Adicionado o campo guest_message à classe Update.
- Adicionada a classe SentGuestMessage e o método answerGuestQuery.
Gerenciamento de chats
- Adicionado o campo can_react_to_messages às classes ChatMemberRestricted e ChatPermissions.
- Adicionado o parâmetro return_bots ao método getChatAdministrators.
- Adicionado o método deleteAllMessageReactions.
- Adicionado o método deleteMessageReaction.
- Os bots agora podem ver certas mensagens enviadas por outros bots em grupos.
Enquetes
- Adicionadas as classes InputMediaSticker, InputMediaLocation e InputMediaVenue.
- Adicionada a classe PollMedia, que representa uma mídia em uma enquete.
- Adicionado o campo media à classe Poll, que permite aos bots ver a mídia em enquetes.
- Adicionado o campo explanation_media à classe Poll, que permite aos bots ver a mídia nas explicações de quizzes.
- Adicionado o campo media à classe PollOption, que permite aos bots ver a mídia nas opções de enquetes.
- Adicionada a classe InputPollMedia e os parâmetros media e explanation_media ao método sendPoll, que permitem aos bots adicionar mídia a enquetes.
- Adicionada a classe InputPollOptionMedia e o campo media à classe InputPollOption, que permitem aos bots adicionar mídia às opções de enquetes.
- Adicionado o campo members_only à classe Poll.
- Adicionado o parâmetro members_only ao método sendPoll.
- Adicionado o campo country_codes à classe Poll.
- Adicionado o parâmetro country_codes ao método sendPoll.
- O número mínimo de opções de uma enquete foi reduzido de 2 para 1.
Live photos
- Adicionada a classe LivePhoto, que representa uma foto com um vídeo curto.
- Adicionada a classe InputMediaLivePhoto.
- Adicionado o campo live_photo às classes Message e ExternalReplyInfo.
- Adicionado o método sendLivePhoto, que permite aos bots enviar live photos.
- Adicionada a classe PaidMediaLivePhoto, que descreve uma mídia paga com uma live photo.
- Adicionada a classe InputPaidMediaLivePhoto, que permite aos bots enviar live photos como mídia paga.
- Agora é possível usar live photos em sendMediaGroup e editMessageMedia.
Geral
- Os bots comerciais agora podem gerenciar contas de usuários sem assinatura do Telegram Premium.
- Adicionada a possibilidade de enviar mensagens a outros bots pelo username, se ambos os bots tiverem ativado a comunicação entre bots.
- Adicionada a possibilidade de responder a outros bots a partir de um bot comercial, se o bot comercial tiver ativado a comunicação entre bots.
- Os bots agora podem passar um texto vazio no método sendMessageDraft.
- Adicionada a classe BotAccessSettings e o método getManagedBotAccessSettings.
- Adicionado o método setManagedBotAccessSettings.
- Adicionado o método getUserPersonalChatMessages.
Bot API 9.6
Novos métodos: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Bots gerenciados
- Adicionado o campo can_manage_bots à classe User.
- Adicionada a classe KeyboardButtonRequestManagedBot e o campo request_managed_bot à classe KeyboardButton.
- Adicionada a classe ManagedBotCreated e o campo managed_bot_created à classe Message.
- Adicionados updates sobre a criação de bots gerenciados e a troca do token deles, representados pela classe ManagedBotUpdated e pelo campo managed_bot na classe Update.
- Adicionados os métodos getManagedBotToken e replaceManagedBotToken.
- Adicionada a classe PreparedKeyboardButton e o método savePreparedKeyboardButton, que permitem aos bots solicitar usuários, chats e bots gerenciados a partir de Mini Apps.
- Adicionado o método requestChat à classe WebApp.
- Adicionado suporte a links
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}], que permitem aos bots solicitar a criação de um bot gerenciado por meio de um link.
Enquetes
- Adicionado suporte a quizzes com várias respostas corretas.
- O campo correct_option_id foi substituído pelo campo correct_option_ids na classe Poll.
- O parâmetro correct_option_id foi substituído pelo parâmetro correct_option_ids no método sendPoll.
- Agora é possível passar allows_multiple_answers para quizzes no método sendPoll.
- O tempo máximo para o encerramento automático de uma enquete foi aumentado para 2628000 segundos.
- Adicionado o campo allows_revoting à classe Poll.
- Adicionado o parâmetro allows_revoting ao método sendPoll.
- Adicionado o parâmetro shuffle_options ao método sendPoll.
- Adicionado o parâmetro allow_adding_options ao método sendPoll.
- Adicionado o parâmetro hide_results_until_closes ao método sendPoll.
- Adicionados os campos description e description_entities à classe Poll.
- Adicionados os parâmetros description, description_parse_mode e description_entities ao método sendPoll.
- Adicionado o campo persistent_id à classe PollOption, que representa um identificador persistente da opção.
- Adicionado o campo option_persistent_ids à classe PollAnswer.
- Adicionados os campos added_by_user e added_by_chat à classe PollOption, que indicam o usuário e o chat que adicionaram a opção.
- Adicionado o campo addition_date à classe PollOption, que indica a data em que a opção foi adicionada.
- Adicionada a classe PollOptionAdded e o campo poll_option_added à classe Message.
- Adicionada a classe PollOptionDeleted e o campo poll_option_deleted à classe Message.
- Adicionado o campo poll_option_id à classe ReplyParameters, que permite aos bots responder a uma opção específica de uma enquete.
- Adicionado o campo reply_to_poll_option_id à classe Message.
- Entidades “date_time” agora são permitidas no título de uma checklist, no texto de uma tarefa da checklist, em TextQuote, na citação de ReplyParameters, em sendGift e em giftPremiumSubscription.
Bot API 9.5
Novos métodos: setChatMemberTag
- Adicionado o tipo “date_time” de MessageEntity, que permite aos bots mostrar ao usuário uma data e hora formatadas.
- Todos os bots agora podem usar o método sendMessageDraft.
- Adicionado o campo tag às classes ChatMemberMember e ChatMemberRestricted.
- Adicionado o método setChatMemberTag.
- Adicionado o campo can_edit_tag às classes ChatMemberRestricted e ChatPermissions.
- Adicionado o campo can_manage_tags às classes ChatMemberAdministrator e ChatAdministratorRights.
- Adicionado o parâmetro can_manage_tags ao método promoteChatMember.
- Adicionado o campo sender_tag à classe Message.
- Adicionado o campo iconCustomEmojiId à classe BottomButton.
Bot API 9.4
Novos métodos: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Os bots agora podem usar emojis personalizados em mensagens enviadas diretamente pelo bot para chats privados, grupos e supergrupos, se o dono do bot tiver assinatura do Telegram Premium.
- Os bots agora podem criar tópicos em chats privados com o método createForumTopic.
- Os bots agora podem impedir que usuários criem e apaguem tópicos em chats privados por meio de uma nova configuração no Mini App do @BotFather.
- Adicionado o campo allows_users_to_create_topics à classe User.
- Adicionado o campo icon_custom_emoji_id às classes KeyboardButton e InlineKeyboardButton, que permite aos bots mostrar um emoji personalizado nos botões, se puderem usar emojis personalizados na mensagem.
- Adicionado o campo style às classes KeyboardButton e InlineKeyboardButton, que permite aos bots alterar a cor dos botões.
- Adicionada a classe ChatOwnerLeft e o campo chat_owner_left à classe Message.
- Adicionada a classe ChatOwnerChanged e o campo chat_owner_changed à classe Message.
- Adicionados os métodos setMyProfilePhoto e removeMyProfilePhoto, que permitem aos bots gerenciar sua foto de perfil.
- Adicionada a classe VideoQuality e o campo qualities à classe Video, que permitem aos bots obter informações sobre as outras qualidades disponíveis de um vídeo.
- Adicionado o campo first_profile_audio à classe ChatFullInfo.
- Adicionada a classe UserProfileAudios e o método getUserProfileAudios, que permitem aos bots obter a lista de áudios adicionados ao perfil de um usuário.
- Adicionado o campo rarity à classe UniqueGiftModel.
- Adicionado o campo is_burned à classe UniqueGift.
Bot API 9.3
Novos métodos: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Tópicos em chats privados
- Adicionado o campo has_topics_enabled à classe User, que pode ser usado para saber se o modo de tópicos do fórum está ativado para o bot em chats privados.
- Adicionado o método sendMessageDraft, que permite fazer streaming de mensagens parciais para o usuário enquanto são geradas.
- Os campos message_thread_id e is_topic_message da classe Message agora são suportados em mensagens de chats privados com o modo de tópicos do fórum ativado.
- O parâmetro message_thread_id agora é suportado em chats privados com tópicos nos métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage e forwardMessages, permitindo que os bots enviem uma mensagem para um tópico específico.
- O parâmetro message_thread_id agora é suportado em chats privados no método sendChatAction, permitindo que os bots enviem ações de chat para um tópico específico em chats privados.
- O parâmetro message_thread_id agora é suportado em chats privados com tópicos nos métodos editForumTopic, deleteForumTopic e unpinAllForumTopicMessages, permitindo que os bots gerenciem tópicos em chats privados.
- Adicionado o campo is_name_implicit às classes ForumTopic e ForumTopicCreated.
Presentes
- Adicionados os métodos getUserGifts e getChatGifts.
- O campo last_resale_star_count foi substituído pelos campos last_resale_currency e last_resale_amount na classe UniqueGiftInfo.
- O parâmetro exclude_limited foi substituído pelos parâmetros exclude_limited_upgradable e exclude_limited_non_upgradable no método getBusinessAccountGifts.
- Adicionado o valor “gifted_upgrade” como possível valor de UniqueGiftInfo.origin para mensagens sobre o upgrade de um presente comprado depois de ser enviado.
- Adicionado o valor “offer” como possível valor de UniqueGiftInfo.origin para mensagens sobre a compra de um presente por meio de uma oferta de compra.
- Adicionado o campo gift_upgrade_sent à classe Message.
- Adicionado o campo gift_id à classe UniqueGift.
- Adicionado o campo is_from_blockchain à classe UniqueGift.
- Adicionado o parâmetro exclude_from_blockchain ao método getBusinessAccountGifts, para excluir presentes atribuídos a partir da blockchain TON.
- Adicionados os campos personal_total_count e personal_remaining_count à classe Gift.
- Adicionado o campo is_premium às classes Gift e UniqueGift.
- Adicionado o campo is_upgrade_separate às classes GiftInfo e OwnedGiftRegular.
- Adicionada a classe UniqueGiftColors, que descreve o esquema de cores do nome de um usuário, das respostas a mensagens e das prévias de links com base em um presente único.
- Adicionado o campo has_colors à classe Gift.
- Adicionado o campo colors à classe UniqueGift.
- Adicionada a classe GiftBackground e o campo background à classe Gift.
- Adicionado o campo unique_gift_variant_count à classe Gift.
- Adicionado o campo unique_gift_number às classes GiftInfo e OwnedGiftRegular.
- Adicionado o campo gifts_from_channels à classe AcceptedGiftTypes.
Diversos
- Os bots agora podem desativar o username principal se tiverem usernames ativos adicionais comprados no Fragment.
- Os bots agora podem desativar o direito can_restrict_members em canais.
- Adicionado o método repostStory, que permite aos bots repostar stories entre as diferentes contas comerciais que gerenciam.
- Adicionada a classe UserRating e o campo rating à classe ChatFullInfo.
- O preço máximo de mídia paga foi aumentado para 25000 Telegram Stars.
- Adicionado o campo paid_message_star_count à classe ChatFullInfo.
- Adicionado o parâmetro message_effect_id aos métodos forwardMessage e copyMessage.
- Adicionado o campo unique_gift_colors à classe ChatFullInfo.
- Adicionado o campo completed_by_chat à classe ChecklistTask.
Bot API 9.2
Novos métodos: approveSuggestedPost, declineSuggestedPost
Checklists
- Adicionado o campo checklist_task_id à classe ReplyParameters, que permite aos bots responder a uma tarefa específica de uma checklist.
- Adicionado o campo reply_to_checklist_task_id à classe Message.
Presentes
- Adicionado o campo publisher_chat às classes Gift e UniqueGift, que pode ser usado para obter informações sobre o chat que publicou um presente.
Mensagens diretas em canais
- Adicionado o campo is_direct_messages às classes Chat e ChatFullInfo, que pode ser usado para identificar supergrupos usados como chats de mensagens diretas de canais.
- Adicionado o campo parent_chat à classe ChatFullInfo, que indica o canal pai de um chat de mensagens diretas de canal.
- Adicionada a classe DirectMessagesTopic e o campo direct_messages_topic à classe Message, que descrevem um tópico de um chat de mensagens diretas.
- Adicionado o parâmetro direct_messages_topic_id aos métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage e forwardMessages. Esse parâmetro pode ser usado para enviar uma mensagem a um tópico de um chat de mensagens diretas.
Publicações sugeridas
- Adicionada a classe SuggestedPostParameters e o parâmetro suggested_post_parameters aos métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage e forwardMessage. Esse parâmetro pode ser usado para enviar uma publicação sugerida a um tópico de um chat de mensagens diretas.
- Adicionado o método approveSuggestedPost, que permite aos bots aprovar publicações sugeridas recebidas.
- Adicionado o método declineSuggestedPost, que permite aos bots recusar publicações sugeridas recebidas.
- Adicionado o campo can_manage_direct_messages às classes ChatMemberAdministrator e ChatAdministratorRights.
- Adicionado o parâmetro can_manage_direct_messages ao método promoteChatMember.
- Adicionado o campo is_paid_post à classe Message, que pode ser usado para identificar publicações pagas. Essas publicações não podem ser apagadas por 24 horas para que o pagamento seja recebido.
- Adicionada a classe SuggestedPostPrice, que descreve o preço de uma publicação sugerida.
- Adicionada a classe SuggestedPostInfo e o campo suggested_post_info à classe Message, que descrevem uma publicação sugerida.
- Adicionada a classe SuggestedPostApproved e o campo suggested_post_approved à classe Message, que descrevem uma mensagem de serviço sobre a aprovação de uma publicação sugerida.
- Adicionada a classe SuggestedPostApprovalFailed e o campo suggested_post_approval_failed à classe Message, que descrevem uma mensagem de serviço sobre a falha na aprovação de uma publicação sugerida.
- Adicionada a classe SuggestedPostDeclined e o campo suggested_post_declined à classe Message, que descrevem uma mensagem de serviço sobre a recusa de uma publicação sugerida.
- Adicionada a classe SuggestedPostPaid e o campo suggested_post_paid à classe Message, que descrevem uma mensagem de serviço sobre o pagamento bem-sucedido de uma publicação sugerida.
- Adicionada a classe SuggestedPostRefunded e o campo suggested_post_refunded à classe Message, que descrevem uma mensagem de serviço sobre o reembolso do pagamento de uma publicação sugerida.
Bot API 9.1
Novos métodos: sendChecklist, editMessageChecklist, getMyStarBalance
Checklists
- Adicionada a classe ChecklistTask, que representa uma tarefa de uma checklist.
- Adicionada a classe Checklist, que representa uma checklist.
- Adicionada a classe InputChecklistTask, que representa uma tarefa a ser adicionada a uma checklist.
- Adicionada a classe InputChecklist, que representa uma checklist a ser criada.
- Adicionado o campo checklist às classes Message e ExternalReplyInfo, que descreve uma checklist em uma mensagem.
- Adicionada a classe ChecklistTasksDone e o campo checklist_tasks_done à classe Message, que descrevem uma mensagem de serviço sobre mudanças de status das tarefas de uma checklist (ou seja, marcadas como concluídas/não concluídas).
- Adicionada a classe ChecklistTasksAdded e o campo checklist_tasks_added à classe Message, que descrevem uma mensagem de serviço sobre a adição de novas tarefas a uma checklist.
- Adicionado o método sendChecklist, que permite aos bots enviar uma checklist em nome de uma conta comercial.
- Adicionado o método editMessageChecklist, que permite aos bots editar uma checklist em nome de uma conta comercial.
Presentes
- Adicionado o campo next_transfer_date às classes OwnedGiftUnique e UniqueGiftInfo.
- Adicionado o campo last_resale_star_count à classe UniqueGiftInfo.
- Adicionado “resale” como possível valor do campo origin na classe UniqueGiftInfo.
Geral
- O número máximo de opções de uma enquete foi aumentado para 12.
- Adicionado o método getMyStarBalance, que permite aos bots obter seu saldo atual de Telegram Stars.
- Adicionada a classe DirectMessagePriceChanged e o campo direct_message_price_changed à classe Message, que descrevem uma mensagem de serviço sobre a mudança de preço das mensagens diretas enviadas ao canal.
- Adicionado o método hideKeyboard à classe WebApp.
Bot API 9.0
Novos métodos: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Contas comerciais
- Adicionada a classe BusinessBotRights, e o campo can_reply foi substituído pelo campo rights do tipo BusinessBotRights na classe BusinessConnection.
- Adicionado o método readBusinessMessage, que permite aos bots marcar mensagens recebidas como lidas em nome de uma conta comercial.
- Adicionado o método deleteBusinessMessages, que permite aos bots apagar mensagens em nome de uma conta comercial.
- Adicionado o método setBusinessAccountName, que permite aos bots alterar o nome e o sobrenome de uma conta comercial gerenciada.
- Adicionado o método setBusinessAccountUsername, que permite aos bots alterar o username de uma conta comercial gerenciada.
- Adicionado o método setBusinessAccountBio, que permite aos bots alterar a bio de uma conta comercial gerenciada.
- Adicionada a classe InputProfilePhoto, que descreve uma foto de perfil a ser definida.
- Adicionados os métodos setBusinessAccountProfilePhoto e removeBusinessAccountProfilePhoto, que permitem aos bots alterar a foto de perfil de uma conta comercial gerenciada.
- Adicionado o método setBusinessAccountGiftSettings, que permite aos bots alterar as configurações de privacidade relativas a presentes recebidos em uma conta comercial gerenciada.
- Adicionada a classe StarAmount e o método getBusinessAccountStarBalance, que permitem aos bots consultar o saldo atual de Telegram Stars de uma conta comercial gerenciada.
- Adicionado o método transferBusinessAccountStars, que permite aos bots transferir Telegram Stars do saldo de uma conta comercial gerenciada para o próprio saldo, para saque.
- Adicionadas as classes OwnedGiftRegular, OwnedGiftUnique, OwnedGifts e o método getBusinessAccountGifts, que permitem aos bots obter a lista de presentes de uma conta comercial gerenciada.
- Adicionado o método convertGiftToStars, que permite aos bots converter em Telegram Stars os presentes recebidos por uma conta comercial gerenciada.
- Adicionado o método upgradeGift, que permite aos bots fazer o upgrade de presentes comuns recebidos por uma conta comercial gerenciada para presentes únicos.
- Adicionado o método transferGift, que permite aos bots transferir presentes únicos de uma conta comercial gerenciada.
- Adicionadas as classes InputStoryContentPhoto e InputStoryContentVideo, que representam o conteúdo de um story a ser publicado.
- Adicionadas as classes StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather e StoryAreaTypeUniqueGift, que descrevem áreas ativas clicáveis em stories.
- Adicionado o método postStory, que permite aos bots publicar um story em nome de uma conta comercial gerenciada.
- Adicionado o método editStory, que permite aos bots editar stories publicados anteriormente em nome de uma conta comercial gerenciada.
- Adicionado o método deleteStory, que permite aos bots apagar stories publicados anteriormente em nome de uma conta comercial gerenciada.
Mini Apps
- Adicionado o campo DeviceStorage, que permite aos Mini Apps usar um armazenamento local persistente no dispositivo do usuário.
- Adicionado o campo SecureStorage, que permite aos Mini Apps usar um armazenamento local seguro no dispositivo do usuário para dados sensíveis.
Presentes
- Adicionadas as classes UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors e UniqueGiftBackdrop para descrever as propriedades de um presente único.
- Adicionada a classe UniqueGift, que descreve um presente que passou por upgrade para presente único.
- Adicionada a classe AcceptedGiftTypes, que descreve os tipos de presentes aceitos por um usuário ou chat.
- O campo can_send_gift foi substituído pelo campo accepted_gift_types do tipo AcceptedGiftTypes na classe ChatFullInfo.
- Adicionada a classe GiftInfo e o campo gift à classe Message, que descrevem uma mensagem de serviço sobre um presente comum enviado ou recebido.
- Adicionada a classe UniqueGiftInfo e o campo unique_gift à classe Message, que descrevem uma mensagem de serviço sobre um presente único enviado ou recebido.
Telegram Premium
- Adicionado o método giftPremiumSubscription, que permite aos bots dar de presente a um usuário uma assinatura do Telegram Premium paga em Telegram Stars.
- Adicionado o campo premium_subscription_duration à classe TransactionPartnerUser para transações que envolvem uma assinatura do Telegram Premium comprada pelo bot.
- Adicionado o campo transaction_type à classe TransactionPartnerUser, o que simplifica a diferenciação e o processamento de todos os tipos de transação.
Geral
- O preço máximo de mídia paga foi aumentado para 10000 Telegram Stars.
- O preço máximo de um período de assinatura foi aumentado para 10000 Telegram Stars.
- Adicionada a classe PaidMessagePriceChanged e o campo paid_message_price_changed à classe Message, que descrevem uma mensagem de serviço sobre a mudança de preço das mensagens pagas enviadas ao chat.
- Adicionado o campo paid_star_count à classe Message, que contém o número de Telegram Stars pagas para enviar a mensagem.
Versões anteriores
As versões anteriores à Bot API 9.0 aparecem com suas datas. As descrições completas estão no changelog oficial.
- Bot API 8.3 — 12 de fevereiro de 2025
- Bot API 8.2 — 1 de janeiro de 2025
- Bot API 8.1 — 4 de dezembro de 2024
- Bot API 8.0 — 17 de novembro de 2024
- Bot API 7.11 — 31 de outubro de 2024
- Bot API 7.10 — 6 de setembro de 2024
- Bot API 7.9 — 14 de agosto de 2024
- Bot API 7.8 — 31 de julho de 2024
- Bot API 7.7 — 7 de julho de 2024
- Bot API 7.6 — 1 de julho de 2024
- Bot API 7.5 — 18 de junho de 2024
- Bot API 7.4 — 28 de maio de 2024
- Bot API 7.3 — 6 de maio de 2024
- Bot API 7.2 — 31 de março de 2024
- Bot API 7.1 — 16 de fevereiro de 2024
- Bot API 7.0 — 29 de dezembro de 2023
- Bot API 6.9 — 22 de setembro de 2023
- Bot API 6.8 — 18 de agosto de 2023
- Bot API 6.7 — 21 de abril de 2023
- Bot API 6.6 — 9 de março de 2023
- Bot API 6.5 — 3 de fevereiro de 2023
- Bot API 6.4 — 30 de dezembro de 2022
- Bot API 6.3 — 5 de novembro de 2022
- Bot API 6.2 — 12 de agosto de 2022
- Bot API 6.1 — 20 de junho de 2022
- Bot API 6.0 — 16 de abril de 2022
- Bot API 5.7 — 31 de janeiro de 2022
- Bot API 5.6 — 30 de dezembro de 2021
- Bot API 5.5 — 7 de dezembro de 2021
- Bot API 5.4 — 5 de novembro de 2021
- Bot API 5.3 — 25 de junho de 2021
- Bot API 5.2 — 26 de abril de 2021
- Bot API 5.1 — 9 de março de 2021
- Bot API 5.0 — 4 de novembro de 2020
- Bot API 4.9 — 4 de junho de 2020
- Bot API 4.8 — 24 de abril de 2020
- Bot API 4.7 — 30 de março de 2020
- Bot API 4.6 — 23 de janeiro de 2020
- Bot API 4.5 — 31 de dezembro de 2019
- Bot API 4.4 — 29 de julho de 2019
- Bot API 4.3 — 31 de maio de 2019
- Bot API 4.2 — 14 de abril de 2019
- Bot API 4.1 — 27 de agosto de 2018
- Bot API 4.0 — 26 de julho de 2018
- Bot API 3.6 — 13 de fevereiro de 2018
- Bot API 3.5 — 17 de novembro de 2017
- Bot API 3.4 — 11 de outubro de 2017
- Bot API 3.3 — 23 de agosto de 2017
- Bot API 3.2 — 21 de julho de 2017
- Bot API 3.1 — 30 de junho de 2017
- Bot API 3.0 — 18 de maio de 2017
- Bot API 2.3.1 — 4 de dezembro de 2016
- Bot API 2.3 — 21 de novembro de 2016
- Bot API 2.2. — 3 de outubro de 2016
- Bot API 2.1. — 22 de maio de 2016
- Bot API 2.0 — 9 de abril de 2016
Perguntas frequentes
Qual é a versão mais recente da Telegram Bot API?
Bot API 10.5, lançada em 22 de novembro de 2026. Ela tem 194 métodos.
Com que frequência a Telegram Bot API muda?
O Telegram costuma lançar uma nova versão da Bot API a cada um ou dois meses. Cada release adiciona métodos e campos; algumas também trazem mudanças incompatíveis, que são indicadas nas descrições.
Como descubro quando um método foi adicionado?
Abra o método na nossa referência de métodos: a seção Histórico de versões mostra a release que o adicionou e as releases que o alteraram, com links para esta página.