Changelog de la Telegram Bot API
Todos los cambios de la Telegram Bot API desde la versión 9.0 (abril de 2025) hasta la actual Bot API 10.5 (22 de noviembre de 2026), del más reciente al más antiguo. Los nombres de métodos enlazan a nuestra referencia con parámetros y ejemplos; los nombres de clases, a la documentación oficial.
Bot API 10.5 Última
Nuevos métodos: setMySettings
Configuración del bot
- Se agregó el método setMySettings, que permite a los bots cambiar su configuración: el modo inline, el modo de privacidad, la posibilidad de agregarlos a grupos, el modo de temas del foro en chats privados y el modo de recepción de consultas de callback.
- Se agregó la posibilidad de recibir consultas de callback de botones en mensajes enviados por el bot con el campo inline_message_id en lugar del campo message en la clase CallbackQuery, según el parámetro callback_query_mode del método setMySettings.
- Se agregó la posibilidad de que los bots muestren la lista de temas en una barra lateral en los chats privados con el bot mediante el parámetro has_topic_sidebar del método setMySettings.
- Se separó la clase BotFullInfo de la clase User y se cambió el tipo de retorno del método getMe a BotFullInfo. Los campos que solo devolvía getMe se eliminaron de la clase User.
- Se agregó el campo active_usernames a la clase BotFullInfo, que permite al bot obtener la lista de todos sus nombres de usuario activos.
- Se agregó el campo inline_query_placeholder a la clase BotFullInfo, que permite al bot obtener su texto de marcador para consultas inline.
- Se agregó el campo needs_inline_query_location a la clase BotFullInfo, que permite al bot comprobar si solicita la ubicación del usuario en cada consulta inline.
- Se agregó el campo has_topic_sidebar a la clase BotFullInfo, que permite al bot comprobar si los temas de los chats privados con el bot se muestran en una barra lateral.
General
- Se agregó la posibilidad de que los propietarios de bots inviten hasta 10 usuarios a la vez a chats privados con el bot mediante el enlace
https://t.me/botinvite/<bot_username>. El bot puede enviar mensajes a los usuarios invitados. - Se agregó el campo inviter a la clase WriteAccessAllowed para los mensajes de servicio sobre usuarios que el propietario del bot invitó al chat privado con el bot.
- Se reemplazó el campo text por el campo blocks en las clases RichBlockExpandableBlockQuotation y InputRichBlockExpandableBlockQuotation, lo que permite que las citas en bloque expandibles contengan bloques arbitrarios.
Bot API 10.4
Nuevos métodos: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widgets
- Se agregaron la clase Widget y el campo widget a las clases Message y ExternalReplyInfo para mensajes con HTML widgets.
- Se agregó el método sendWidget, que permite a los bots enviar mensajes con widgets HTML. Por ahora, en el entorno de producción los widgets solo se pueden enviar a chats privados, y los widgets enviados tienen automáticamente contenido protegido, por lo que no se pueden reenviar.
- Se agregó el método sendSharedWidget, que permite a los bots volver a enviar widgets compartidos creados por el bot.
- Se agregaron la clase WidgetQuery y el campo widget_query a la clase Update para las consultas que envían al bot los widgets de mensajes enviados por el bot o a través de él.
- Se agregaron la clase SharedWidgetQuery y el campo shared_widget_query a la clase Update para las consultas enviadas al bot desde mensajes reenviados con widgets compartidos.
- Se agregaron las clases WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction y WidgetQueryWallet, que describen el tipo de una consulta de un widget. Una consulta puede contener datos para el bot junto con la tarjeta de la billetera TON del usuario, datos firmados por una billetera TON del usuario o una notificación sobre una transacción enviada desde una billetera TON del usuario.
- Se agregó el método answerWidgetQuery, que permite a los bots responder a consultas de widgets.
- Se agregó el método editMessageWidgetData, que permite a los bots cambiar los datos de un widget en un mensaje.
- Se agregó el método editSharedWidgetData, que permite a los bots cambiar los datos públicos de un widget compartido.
- Se agregaron las clases InputWidgetMessageContent y InputSharedWidgetMessageContent, que permiten a los bots enviar widgets en respuesta a consultas inline. Por ahora, en el entorno de producción no se pueden enviar widgets en respuesta a consultas inline.
- Los mensajes con widgets no se pueden copiar con los métodos copyMessage y copyMessages.
- El permiso can_send_other_messages de las clases ChatPermissions y ChatMemberRestricted ahora también permite enviar widgets.
Mensajes efímeros
- Se permitió a los bots enviar respuestas efímeras a consultas de callback en cualquier chat, excepto en los chats de mensajes directos de canales, indicando callback_query_id sin receiver_user_id en el parámetro ephemeral_message_parameters de los métodos sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote y sendVoice.
- El campo receiver_user_id de la clase EphemeralMessageParameters y el parámetro chat_id de los métodos mencionados ahora son opcionales.
Citas de mensajes enriquecidos
- Se agregó el campo rich_texts a la clase TextQuote para citas seleccionadas de un RichMessage.
- Se agregó el campo quote_rich_texts a la clase ReplyParameters, que permite a los bots citar mensajes enriquecidos.
Billetera TON
- Se agregaron las clases TonWalletCard, TonWalletCardSticker, TonNft y TonNftAttribute, y el campo ton_wallet_card a la clase ChatFullInfo.
- Se agregaron la clase TonWalletTransfer y el campo ton_wallet_transfer a la clase Message para los mensajes de servicio sobre transferencias con una billetera TON.
- Se renombró la clase StoryAreaPosition a AreaPosition, ya que ahora también se usa para describir la posición de los stickers en las tarjetas de billeteras TON.
Temas para compartir chats
- Se agregaron las clases ChatShareTheme, ChatShareThemeEmoji y ChatShareThemeUniqueGift, y el campo share_theme a la clase ChatFullInfo, que describen el tema de la pantalla para compartir un enlace a un usuario o a un chat.
- Se agregaron las clases EmojiType, EmojiTypeEmoji y EmojiTypeCustomEmoji.
- Se agregaron las clases ChatShareThemeBackdrop y ChatShareThemeBackdrops y el método getChatShareThemeBackdrops.
Regalos
- Se agregó el método getUniqueGift, que permite a los bots obtener información sobre un regalo único por su nombre.
- Se agregó el método deleteBusinessAccountGift, que permite a los bots eliminar regalos normales de una cuenta empresarial administrada sin recibir Telegram Stars por ellos.
General
- Se permitió a los usuarios con suscripción a Telegram Premium asignar nombres de usuario secundarios terminados en “agent”, “ai”, “app”, “game” o “gay” a hasta 2 bots propios. Estos nombres de usuario se pueden sugerir en el campo suggested_username de la clase KeyboardButtonRequestManagedBot.
- Se agregó la clase RichTextTonAddress, que representa una dirección de la blockchain de TON en un RichMessage.
- Se agregó el tipo “ton_address” a la clase MessageEntity para direcciones de la blockchain de TON.
- Se agregó el tipo “bank_card_number” a la clase MessageEntity para números de tarjetas bancarias.
- Se agregaron los parámetros custom_description_parse_mode y custom_description_entities a los métodos verifyUser y verifyChat.
- Se agregaron la clase PaidMessagesWaived y el campo paid_messages_waived a la clase Message para los mensajes de servicio que indican que el remitente usó un enlace que permite enviar mensajes sin pagar Telegram Stars.
- Se agregó la posibilidad de crear enlaces a temas de chats privados con el bot en el formato
https://t.me/<bot_username>/<message_thread_id>. Un enlace así abre el tema solo para el usuario del chat privado en el que existe ese tema.
Bot API 10.3
Mensajes enriquecidos
- Se agregó la clase RichMessageButton, que representa un botón en un RichMessage.
- Se agregó la clase RichTextButton.
- Se agregaron las clases RichBlockButtons y InputRichBlockButtons.
- Se agregó el campo is_compact a las clases RichBlockTable y InputRichBlockTable.
- Se agregaron las clases RichBlockExpandableBlockQuotation y InputRichBlockExpandableBlockQuotation, que representan una cita en bloque que se puede expandir y volver a contraer.
- Se agregaron las clases RichBlockDocument y InputRichBlockDocument, que contienen un archivo.
- Se agregó soporte para enlaces del tipo
tg://document?id=para cargar archivos genéricos en mensajes enriquecidos.
Mensajes efímeros
- Se agregó la clase EphemeralMessageParameters y se reemplazaron los parámetros receiver_user_id y callback_query_id de los métodos sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation y sendVenue por el parámetro ephemeral_message_parameters.
- Se agregó el parámetro ephemeral_message_parameters al método sendRichMessage.
- Se agregó el campo replace_callback_query_message a la clase EphemeralMessageParameters, que permite a los bots mostrar un mensaje efímero en lugar del mensaje original.
- Se admite la carga de archivos nuevos en editEphemeralMessageMedia.
- Se agregó el parámetro show_caption_above_media al método editEphemeralMessageCaption.
- Se agregó el parámetro rich_message al método editEphemeralMessageText.
- Se agregó el campo can_send_welcome_messages a las clases ChatAdministratorRights y ChatMemberAdministrator.
- Se agregó el parámetro can_send_welcome_messages al método promoteChatMember.
Teclados de respuesta
- Se agregaron la clase DisabledButton y el campo disabled a la clase InlineKeyboardButton.
- Se agregó el campo force_reply a las clases InlineKeyboardMarkup y ReplyKeyboardMarkup.
General
- Se agregaron los parámetros can_stop y keep_on_stop a los métodos sendMessageDraft y sendRichMessageDraft.
- Se agregaron actualizaciones sobre la detención de la generación de un mensaje por parte del usuario, representadas por la clase MessageGenerationStopped y el campo stopped_message_generation de la clase Update.
- Se agregaron la clase CommunityChatJoined y el campo community_chat_joined a la clase Message para los mensajes de servicio sobre la unión a un chat de una comunidad.
- Se agregaron los campos text, entities e is_private a la clase UniqueGiftInfo.
Bot API 10.2
Nuevos métodos: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Mensajes enriquecidos
- Se agregaron la clase InputRichMessageMedia y el campo media a la clase InputRichMessage, que permiten a los bots indicar explícitamente los archivos multimedia usados en el formato markdown o html al enviar un mensaje enriquecido.
- Se agregó la clase InputMediaVoiceNote, que representa un mensaje de voz para enviar.
- Se agregó la clase InputRichBlockListItem, que representa un elemento de una lista para enviar.
- Se agregaron las clases InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote y InputRichBlockThinking, que representan los distintos tipos de bloques disponibles para dar formato a un mensaje enriquecido saliente.
- Se agregó el campo blocks a la clase InputRichMessage, que permite a los bots definir el formato de un mensaje enriquecido mediante entidades de bloque.
Mensajes efímeros
- Se agregó soporte para Ephemeral Messages, que permite a los bots enviar mensajes en grupos y recibir comandos visibles solo para un usuario concreto y el bot.
- Se agregó el campo is_ephemeral a la clase BotCommand.
- Se agregó el campo receiver_user a la clase Message.
- Se agregó el campo ephemeral_message_id a la clase Message.
- Se agregaron los parámetros receiver_user_id y callback_query_id a los métodos sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation y sendVenue.
- Se agregó el campo ephemeral_message_id a la clase ReplyParameters, que permite a los bots responder a mensajes efímeros.
- El campo message_id de la clase ReplyParameters ahora es opcional si está presente el campo ephemeral_message_id.
- Se agregaron los métodos editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption y editEphemeralMessageReplyMarkup, que permiten a los bots editar mensajes efímeros.
- Se agregó el método deleteEphemeralMessage, que permite a los bots eliminar mensajes efímeros.
Comunidades
- Se agregó el soporte inicial para Comunidades: varios supergrupos, canales y bots vinculados en torno a un tema o una audiencia en común.
- Se agregó la clase Community, que representa una comunidad.
- Se agregaron la clase CommunityChatAdded y el campo community_chat_added a la clase Message.
- Se agregaron la clase CommunityChatRemoved y el campo community_chat_removed a la clase Message.
- Se agregó el campo community a la clase ChatFullInfo.
General
- Se agregaron actualizaciones sobre cambios en la suscripción de pago de un usuario, representadas por la clase BotSubscriptionUpdated y el campo subscription de la clase Update.
- Se reforzó la seguridad de las Mini Apps al impedir el uso de los métodos de Mini App desde orígenes distintos del dominio original de la Mini App. La protección se activará automáticamente para todas las Mini Apps el 20 de julio de 2026. Puedes desactivarla desde la Mini App de @BotFather. Si lo haces, aceptas que es responsabilidad del bot garantizar que la Mini App no tenga enlaces a sitios no confiables.
Bot API 10.1
Nuevos métodos: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Mensajes enriquecidos
- Se agregó soporte para Rich Messages, que permite a los bots enviar texto altamente estructurado y transmitir en streaming respuestas generadas por IA con formato enriquecido fluido.
- Se agregaron las clases RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference y RichTextReferenceLink, que representan los distintos tipos de texto con formato enriquecido.
- Se agregó la clase RichText, que representa texto con formato enriquecido.
- Se agregó la clase RichBlockCaption, que representa el pie de un texto con formato enriquecido.
- Se agregó la clase RichBlockTableCell, que representa una celda de una tabla.
- Se agregó la clase RichBlockListItem, que representa un elemento de una lista.
- Se agregaron las clases RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote y RichBlockThinking, que representan los distintos tipos de bloques de un mensaje con formato enriquecido.
- Se agregó la clase RichBlock, que representa un bloque de un mensaje con formato enriquecido.
- Se agregó la clase RichMessage, que representa un mensaje con formato enriquecido.
- Se agregó el campo rich_message a la clase Message.
- Se agregó la clase InputRichMessage, que describe un mensaje enriquecido para enviar.
- Se agregó la clase InputRichMessageContent y se permitió usarla como InputMessageContent en los resultados de consultas inline, de invitado y de Web App.
- Se agregó el método sendRichMessage, que permite a los bots enviar mensajes enriquecidos.
- Se agregó el método sendRichMessageDraft, que permite a los bots transmitir en streaming mensajes enriquecidos parciales.
- Se agregó el parámetro rich_message al método editMessageText, que permite a los bots editar mensajes enriquecidos.
Consultas de solicitudes de unión
- Se agregó el campo supports_join_request_queries a la clase User.
- Se agregó el campo guard_bot a la clase ChatFullInfo.
- Se agregó el campo query_id a la clase ChatJoinRequest.
- Se agregó el método answerChatJoinRequestQuery.
- Se agregó el método sendChatJoinRequestWebApp.
Encuestas
- Se agregaron la clase Link y el campo link a la clase PollMedia.
- Se agregó la clase InputMediaLink y se permitió usarla como InputPollOptionMedia.
Bot API 10.0
Nuevos métodos: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Modo invitado
- Se agregó soporte para el guest mode, que permite a los bots recibir ciertos mensajes y responder en chats de los que no son miembros.
- Se agregó el campo supports_guest_queries a la clase User.
- Se agregaron los campos guest_bot_caller_user y guest_bot_caller_chat a la clase Message.
- Se agregó el campo guest_query_id a la clase Message.
- Se agregó el campo guest_message a la clase Update.
- Se agregaron la clase SentGuestMessage y el método answerGuestQuery.
Administración de chats
- Se agregó el campo can_react_to_messages a las clases ChatMemberRestricted y ChatPermissions.
- Se agregó el parámetro return_bots al método getChatAdministrators.
- Se agregó el método deleteAllMessageReactions.
- Se agregó el método deleteMessageReaction.
- Se agregó la posibilidad de ver ciertos mensajes enviados por otros bots en grupos.
Encuestas
- Se agregaron las clases InputMediaSticker, InputMediaLocation y InputMediaVenue.
- Se agregó la clase PollMedia, que representa un archivo multimedia de una encuesta.
- Se agregó el campo media a la clase Poll, que permite a los bots ver archivos multimedia en las encuestas.
- Se agregó el campo explanation_media a la clase Poll, que permite a los bots ver archivos multimedia en las explicaciones de los cuestionarios.
- Se agregó el campo media a la clase PollOption, que permite a los bots ver archivos multimedia en las opciones de las encuestas.
- Se agregaron la clase InputPollMedia y los parámetros media y explanation_media al método sendPoll, que permiten a los bots agregar archivos multimedia a las encuestas.
- Se agregaron la clase InputPollOptionMedia y el campo media a la clase InputPollOption, que permiten a los bots agregar archivos multimedia a las opciones de las encuestas.
- Se agregó el campo members_only a la clase Poll.
- Se agregó el parámetro members_only al método sendPoll.
- Se agregó el campo country_codes a la clase Poll.
- Se agregó el parámetro country_codes al método sendPoll.
- Se redujo el número mínimo de opciones de una encuesta de 2 a 1.
Live Photos
- Se agregó la clase LivePhoto, que representa una foto con un video corto.
- Se agregó la clase InputMediaLivePhoto.
- Se agregó el campo live_photo a las clases Message y ExternalReplyInfo.
- Se agregó el método sendLivePhoto, que permite a los bots enviar Live Photos.
- Se agregó la clase PaidMediaLivePhoto, que describe contenido de pago con una Live Photo.
- Se agregó la clase InputPaidMediaLivePhoto, que permite a los bots enviar Live Photos como contenido de pago.
- Se permitió usar Live Photos en sendMediaGroup y editMessageMedia.
General
- Se permitió a los bots empresariales administrar cuentas de usuario sin suscripción a Telegram Premium.
- Se agregó la posibilidad de enviar mensajes a otros bots por nombre de usuario si ambos bots habilitaron la comunicación entre bots.
- Se agregó la posibilidad de responder a otros bots desde un bot empresarial si este habilitó la comunicación entre bots.
- Se permitió a los bots pasar un texto vacío en el método sendMessageDraft.
- Se agregaron la clase BotAccessSettings y el método getManagedBotAccessSettings.
- Se agregó el método setManagedBotAccessSettings.
- Se agregó el método getUserPersonalChatMessages.
Bot API 9.6
Nuevos métodos: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Bots administrados
- Se agregó el campo can_manage_bots a la clase User.
- Se agregaron la clase KeyboardButtonRequestManagedBot y el campo request_managed_bot a la clase KeyboardButton.
- Se agregaron la clase ManagedBotCreated y el campo managed_bot_created a la clase Message.
- Se agregaron actualizaciones sobre la creación de bots administrados y el cambio de su token, representadas por la clase ManagedBotUpdated y el campo managed_bot de la clase Update.
- Se agregaron los métodos getManagedBotToken y replaceManagedBotToken.
- Se agregaron la clase PreparedKeyboardButton y el método savePreparedKeyboardButton, que permiten a los bots solicitar usuarios, chats y bots administrados desde Mini Apps.
- Se agregó el método requestChat a la clase WebApp.
- Se agregó soporte para enlaces
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}], que permiten a los bots solicitar la creación de un bot administrado mediante un enlace.
Encuestas
- Se agregó soporte para cuestionarios con varias respuestas correctas.
- Se reemplazó el campo correct_option_id por el campo correct_option_ids en la clase Poll.
- Se reemplazó el parámetro correct_option_id por el parámetro correct_option_ids en el método sendPoll.
- Se permitió pasar allows_multiple_answers para cuestionarios en el método sendPoll.
- Se aumentó el tiempo máximo para el cierre automático de una encuesta a 2628000 segundos.
- Se agregó el campo allows_revoting a la clase Poll.
- Se agregó el parámetro allows_revoting al método sendPoll.
- Se agregó el parámetro shuffle_options al método sendPoll.
- Se agregó el parámetro allow_adding_options al método sendPoll.
- Se agregó el parámetro hide_results_until_closes al método sendPoll.
- Se agregaron los campos description y description_entities a la clase Poll.
- Se agregaron los parámetros description, description_parse_mode y description_entities al método sendPoll.
- Se agregó el campo persistent_id a la clase PollOption, que representa un identificador persistente de la opción.
- Se agregó el campo option_persistent_ids a la clase PollAnswer.
- Se agregaron los campos added_by_user y added_by_chat a la clase PollOption, que indican el usuario y el chat que agregaron la opción.
- Se agregó el campo addition_date a la clase PollOption, que indica la fecha en que se agregó la opción.
- Se agregaron la clase PollOptionAdded y el campo poll_option_added a la clase Message.
- Se agregaron la clase PollOptionDeleted y el campo poll_option_deleted a la clase Message.
- Se agregó el campo poll_option_id a la clase ReplyParameters, que permite a los bots responder a una opción concreta de una encuesta.
- Se agregó el campo reply_to_poll_option_id a la clase Message.
- Se permitieron las entidades “date_time” en el título de una checklist, el texto de una checklist task, en TextQuote, en la cita de ReplyParameters, en sendGift y en giftPremiumSubscription.
Bot API 9.5
Nuevos métodos: setChatMemberTag
- Se agregó el tipo “date_time” de MessageEntity, que permite a los bots mostrar al usuario una fecha y hora con formato.
- Se permitió a todos los bots usar el método sendMessageDraft.
- Se agregó el campo tag a las clases ChatMemberMember y ChatMemberRestricted.
- Se agregó el método setChatMemberTag.
- Se agregó el campo can_edit_tag a las clases ChatMemberRestricted y ChatPermissions.
- Se agregó el campo can_manage_tags a las clases ChatMemberAdministrator y ChatAdministratorRights.
- Se agregó el parámetro can_manage_tags al método promoteChatMember.
- Se agregó el campo sender_tag a la clase Message.
- Se agregó el campo iconCustomEmojiId a la clase BottomButton.
Bot API 9.4
Nuevos métodos: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Se permitió a los bots usar emojis personalizados en los mensajes que envían directamente a chats privados, grupos y supergrupos si el propietario del bot tiene suscripción a Telegram Premium.
- Se permitió a los bots crear temas en chats privados con el método createForumTopic.
- Se permitió a los bots impedir que los usuarios creen y eliminen temas en chats privados mediante una nueva opción en la Mini App de @BotFather.
- Se agregó el campo allows_users_to_create_topics a la clase User.
- Se agregó el campo icon_custom_emoji_id a las clases KeyboardButton y InlineKeyboardButton, que permite a los bots mostrar un emoji personalizado en los botones si pueden usar emojis personalizados en el mensaje.
- Se agregó el campo style a las clases KeyboardButton y InlineKeyboardButton, que permite a los bots cambiar el color de los botones.
- Se agregaron la clase ChatOwnerLeft y el campo chat_owner_left a la clase Message.
- Se agregaron la clase ChatOwnerChanged y el campo chat_owner_changed a la clase Message.
- Se agregaron los métodos setMyProfilePhoto y removeMyProfilePhoto, que permiten a los bots administrar su foto de perfil.
- Se agregaron la clase VideoQuality y el campo qualities a la clase Video, que permiten a los bots obtener información sobre otras calidades disponibles de un video.
- Se agregó el campo first_profile_audio a la clase ChatFullInfo.
- Se agregaron la clase UserProfileAudios y el método getUserProfileAudios, que permiten a los bots obtener la lista de audios agregados al perfil de un usuario.
- Se agregó el campo rarity a la clase UniqueGiftModel.
- Se agregó el campo is_burned a la clase UniqueGift.
Bot API 9.3
Nuevos métodos: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Temas en chats privados
- Se agregó el campo has_topics_enabled a la clase User, que permite determinar si el modo de temas del foro está activado para el bot en chats privados.
- Se agregó el método sendMessageDraft, que permite transmitir en streaming mensajes parciales a un usuario mientras se generan.
- Se admiten los campos message_thread_id e is_topic_message en la clase Message para mensajes en chats privados con el modo de temas del foro activado.
- Se admite el parámetro message_thread_id en chats privados con temas en los métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage y forwardMessages, lo que permite a los bots enviar un mensaje a un tema concreto.
- Se admite el parámetro message_thread_id en chats privados en el método sendChatAction, lo que permite a los bots enviar acciones de chat a un tema concreto de un chat privado.
- Se admite el parámetro message_thread_id en chats privados con temas en los métodos editForumTopic, deleteForumTopic y unpinAllForumTopicMessages, lo que permite a los bots administrar temas en chats privados.
- Se agregó el campo is_name_implicit a las clases ForumTopic y ForumTopicCreated.
Regalos
- Se agregaron los métodos getUserGifts y getChatGifts.
- Se reemplazó el campo last_resale_star_count por los campos last_resale_currency y last_resale_amount en la clase UniqueGiftInfo.
- Se reemplazó el parámetro exclude_limited por los parámetros exclude_limited_upgradable y exclude_limited_non_upgradable en el método getBusinessAccountGifts.
- Se agregó el valor “gifted_upgrade” como posible valor de UniqueGiftInfo.origin para mensajes sobre la mejora de un regalo que se compró después de enviarlo.
- Se agregó el valor “offer” como posible valor de UniqueGiftInfo.origin para mensajes sobre la compra de un regalo mediante una oferta de compra.
- Se agregó el campo gift_upgrade_sent a la clase Message.
- Se agregó el campo gift_id a la clase UniqueGift.
- Se agregó el campo is_from_blockchain a la clase UniqueGift.
- Se agregó el parámetro exclude_from_blockchain al método getBusinessAccountGifts para excluir los regalos asignados desde la blockchain de TON.
- Se agregaron los campos personal_total_count y personal_remaining_count a la clase Gift.
- Se agregó el campo is_premium a las clases Gift y UniqueGift.
- Se agregó el campo is_upgrade_separate a las clases GiftInfo y OwnedGiftRegular.
- Se agregó la clase UniqueGiftColors, que describe el esquema de colores del nombre de un usuario, las respuestas a mensajes y las vistas previas de enlaces basado en un regalo único.
- Se agregó el campo has_colors a la clase Gift.
- Se agregó el campo colors a la clase UniqueGift.
- Se agregaron la clase GiftBackground y el campo background a la clase Gift.
- Se agregó el campo unique_gift_variant_count a la clase Gift.
- Se agregó el campo unique_gift_number a las clases GiftInfo y OwnedGiftRegular.
- Se agregó el campo gifts_from_channels a la clase AcceptedGiftTypes.
Varios
- Se permitió a los bots desactivar su nombre de usuario principal si tienen nombres de usuario activos adicionales comprados en Fragment.
- Se permitió a los bots desactivar el permiso can_restrict_members en canales.
- Se agregó el método repostStory, que permite a los bots republicar historias entre distintas cuentas empresariales que administran.
- Se agregaron la clase UserRating y el campo rating a la clase ChatFullInfo.
- Se aumentó el precio máximo del contenido de pago a 25000 Telegram Stars.
- Se agregó el campo paid_message_star_count a la clase ChatFullInfo.
- Se agregó el parámetro message_effect_id a los métodos forwardMessage y copyMessage.
- Se agregó el campo unique_gift_colors a la clase ChatFullInfo.
- Se agregó el campo completed_by_chat a la clase ChecklistTask.
Bot API 9.2
Nuevos métodos: approveSuggestedPost, declineSuggestedPost
Listas de tareas
- Se agregó el campo checklist_task_id a la clase ReplyParameters, que permite a los bots responder a una tarea concreta de una lista de tareas.
- Se agregó el campo reply_to_checklist_task_id a la clase Message.
Regalos
- Se agregó el campo publisher_chat a las clases Gift y UniqueGift, que permite obtener información sobre el chat que publicó un regalo.
Mensajes directos en canales
- Se agregó el campo is_direct_messages a las clases Chat y ChatFullInfo, que permite identificar los supergrupos que se usan como chats de mensajes directos de canales.
- Se agregó el campo parent_chat a la clase ChatFullInfo, que indica el canal principal de un chat de mensajes directos de canal.
- Se agregaron la clase DirectMessagesTopic y el campo direct_messages_topic a la clase Message, que describen un tema de un chat de mensajes directos.
- Se agregó el parámetro direct_messages_topic_id a los métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage y forwardMessages. Este parámetro permite enviar un mensaje a un tema de un chat de mensajes directos.
Publicaciones sugeridas
- Se agregó la clase SuggestedPostParameters y el parámetro suggested_post_parameters a los métodos sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage y forwardMessage. Este parámetro permite enviar una publicación sugerida a un tema de un chat de mensajes directos.
- Se agregó el método approveSuggestedPost, que permite a los bots aprobar publicaciones sugeridas entrantes.
- Se agregó el método declineSuggestedPost, que permite a los bots rechazar publicaciones sugeridas entrantes.
- Se agregó el campo can_manage_direct_messages a las clases ChatMemberAdministrator y ChatAdministratorRights.
- Se agregó el parámetro can_manage_direct_messages al método promoteChatMember.
- Se agregó el campo is_paid_post a la clase Message, que permite identificar publicaciones pagadas. Estas publicaciones no deben eliminarse durante 24 horas para recibir el pago.
- Se agregó la clase SuggestedPostPrice, que describe el precio de una publicación sugerida.
- Se agregaron la clase SuggestedPostInfo y el campo suggested_post_info a la clase Message, que describen una publicación sugerida.
- Se agregaron la clase SuggestedPostApproved y el campo suggested_post_approved a la clase Message, que describen un mensaje de servicio sobre la aprobación de una publicación sugerida.
- Se agregaron la clase SuggestedPostApprovalFailed y el campo suggested_post_approval_failed a la clase Message, que describen un mensaje de servicio sobre la aprobación fallida de una publicación sugerida.
- Se agregaron la clase SuggestedPostDeclined y el campo suggested_post_declined a la clase Message, que describen un mensaje de servicio sobre el rechazo de una publicación sugerida.
- Se agregaron la clase SuggestedPostPaid y el campo suggested_post_paid a la clase Message, que describen un mensaje de servicio sobre el pago exitoso de una publicación sugerida.
- Se agregaron la clase SuggestedPostRefunded y el campo suggested_post_refunded a la clase Message, que describen un mensaje de servicio sobre el reembolso del pago de una publicación sugerida.
Bot API 9.1
Nuevos métodos: sendChecklist, editMessageChecklist, getMyStarBalance
Listas de tareas
- Se agregó la clase ChecklistTask, que representa una tarea de una lista de tareas.
- Se agregó la clase Checklist, que representa una lista de tareas.
- Se agregó la clase InputChecklistTask, que representa una tarea para agregar a una lista de tareas.
- Se agregó la clase InputChecklist, que representa una lista de tareas para crear.
- Se agregó el campo checklist a las clases Message y ExternalReplyInfo, que describe una lista de tareas en un mensaje.
- Se agregaron la clase ChecklistTasksDone y el campo checklist_tasks_done a la clase Message, que describen un mensaje de servicio sobre cambios de estado de tareas de una lista (es decir, marcadas como completadas o no completadas).
- Se agregaron la clase ChecklistTasksAdded y el campo checklist_tasks_added a la clase Message, que describen un mensaje de servicio sobre la incorporación de nuevas tareas a una lista de tareas.
- Se agregó el método sendChecklist, que permite a los bots enviar una lista de tareas en nombre de una cuenta empresarial.
- Se agregó el método editMessageChecklist, que permite a los bots editar una lista de tareas en nombre de una cuenta empresarial.
Regalos
- Se agregó el campo next_transfer_date a las clases OwnedGiftUnique y UniqueGiftInfo.
- Se agregó el campo last_resale_star_count a la clase UniqueGiftInfo.
- Se agregó “resale” como posible valor del campo origin de la clase UniqueGiftInfo.
General
- Se aumentó el número máximo de opciones de una encuesta a 12.
- Se agregó el método getMyStarBalance, que permite a los bots obtener su saldo actual de Telegram Stars.
- Se agregaron la clase DirectMessagePriceChanged y el campo direct_message_price_changed a la clase Message, que describen un mensaje de servicio sobre el cambio de precio de los mensajes directos enviados al canal.
- Se agregó el método hideKeyboard a la clase WebApp.
Bot API 9.0
Nuevos métodos: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Cuentas empresariales
- Se agregó la clase BusinessBotRights y se reemplazó el campo can_reply por el campo rights de tipo BusinessBotRights en la clase BusinessConnection.
- Se agregó el método readBusinessMessage, que permite a los bots marcar mensajes entrantes como leídos en nombre de una cuenta empresarial.
- Se agregó el método deleteBusinessMessages, que permite a los bots eliminar mensajes en nombre de una cuenta empresarial.
- Se agregó el método setBusinessAccountName, que permite a los bots cambiar el nombre y el apellido de una cuenta empresarial administrada.
- Se agregó el método setBusinessAccountUsername, que permite a los bots cambiar el nombre de usuario de una cuenta empresarial administrada.
- Se agregó el método setBusinessAccountBio, que permite a los bots cambiar la biografía de una cuenta empresarial administrada.
- Se agregó la clase InputProfilePhoto, que describe una foto de perfil para establecer.
- Se agregaron los métodos setBusinessAccountProfilePhoto y removeBusinessAccountProfilePhoto, que permiten a los bots cambiar la foto de perfil de una cuenta empresarial administrada.
- Se agregó el método setBusinessAccountGiftSettings, que permite a los bots cambiar la configuración de privacidad de los regalos entrantes de una cuenta empresarial administrada.
- Se agregaron la clase StarAmount y el método getBusinessAccountStarBalance, que permiten a los bots consultar el saldo actual de Telegram Stars de una cuenta empresarial administrada.
- Se agregó el método transferBusinessAccountStars, que permite a los bots transferir Telegram Stars del saldo de una cuenta empresarial administrada a su propio saldo para retirarlas.
- Se agregaron las clases OwnedGiftRegular, OwnedGiftUnique, OwnedGifts y el método getBusinessAccountGifts, que permiten a los bots obtener la lista de regalos de una cuenta empresarial administrada.
- Se agregó el método convertGiftToStars, que permite a los bots convertir en Telegram Stars los regalos recibidos por una cuenta empresarial administrada.
- Se agregó el método upgradeGift, que permite a los bots mejorar a regalos únicos los regalos normales recibidos por una cuenta empresarial administrada.
- Se agregó el método transferGift, que permite a los bots transferir regalos únicos de una cuenta empresarial administrada.
- Se agregaron las clases InputStoryContentPhoto y InputStoryContentVideo, que representan el contenido de una historia para publicar.
- Se agregaron las clases StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather y StoryAreaTypeUniqueGift, que describen las áreas activas en las que se puede hacer clic en las historias.
- Se agregó el método postStory, que permite a los bots publicar una historia en nombre de una cuenta empresarial administrada.
- Se agregó el método editStory, que permite a los bots editar historias que publicaron previamente en nombre de una cuenta empresarial administrada.
- Se agregó el método deleteStory, que permite a los bots eliminar historias que publicaron previamente en nombre de una cuenta empresarial administrada.
Mini Apps
- Se agregó el campo DeviceStorage, que permite a las Mini Apps usar almacenamiento local persistente en el dispositivo del usuario.
- Se agregó el campo SecureStorage, que permite a las Mini Apps usar un almacenamiento local seguro en el dispositivo del usuario para datos sensibles.
Regalos
- Se agregaron las clases UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors y UniqueGiftBackdrop para describir las propiedades de un regalo único.
- Se agregó la clase UniqueGift, que describe un regalo mejorado a único.
- Se agregó la clase AcceptedGiftTypes, que describe los tipos de regalos que acepta un usuario o un chat.
- Se reemplazó el campo can_send_gift por el campo accepted_gift_types de tipo AcceptedGiftTypes en la clase ChatFullInfo.
- Se agregaron la clase GiftInfo y el campo gift a la clase Message, que describen un mensaje de servicio sobre un regalo normal enviado o recibido.
- Se agregaron la clase UniqueGiftInfo y el campo unique_gift a la clase Message, que describen un mensaje de servicio sobre un regalo único enviado o recibido.
Telegram Premium
- Se agregó el método giftPremiumSubscription, que permite a los bots regalar a un usuario una suscripción a Telegram Premium pagada con Telegram Stars.
- Se agregó el campo premium_subscription_duration a la clase TransactionPartnerUser para transacciones con una suscripción a Telegram Premium comprada por el bot.
- Se agregó el campo transaction_type a la clase TransactionPartnerUser, que simplifica la diferenciación y el procesamiento de todos los tipos de transacciones.
General
- Se aumentó el precio máximo del contenido de pago a 10000 Telegram Stars.
- Se aumentó el precio máximo de un período de suscripción a 10000 Telegram Stars.
- Se agregaron la clase PaidMessagePriceChanged y el campo paid_message_price_changed a la clase Message, que describen un mensaje de servicio sobre el cambio de precio de los mensajes de pago enviados al chat.
- Se agregó el campo paid_star_count a la clase Message, que contiene la cantidad de Telegram Stars pagadas para enviar el mensaje.
Versiones anteriores
Las versiones anteriores a la Bot API 9.0 se listan con sus fechas. Sus descripciones completas están en el changelog oficial.
- Bot API 8.3 — 12 de febrero de 2025
- Bot API 8.2 — 1 de enero de 2025
- Bot API 8.1 — 4 de diciembre de 2024
- Bot API 8.0 — 17 de noviembre de 2024
- Bot API 7.11 — 31 de octubre de 2024
- Bot API 7.10 — 6 de septiembre de 2024
- Bot API 7.9 — 14 de agosto de 2024
- Bot API 7.8 — 31 de julio de 2024
- Bot API 7.7 — 7 de julio de 2024
- Bot API 7.6 — 1 de julio de 2024
- Bot API 7.5 — 18 de junio de 2024
- Bot API 7.4 — 28 de mayo de 2024
- Bot API 7.3 — 6 de mayo de 2024
- Bot API 7.2 — 31 de marzo de 2024
- Bot API 7.1 — 16 de febrero de 2024
- Bot API 7.0 — 29 de diciembre de 2023
- Bot API 6.9 — 22 de septiembre 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 marzo de 2023
- Bot API 6.5 — 3 de febrero de 2023
- Bot API 6.4 — 30 de diciembre de 2022
- Bot API 6.3 — 5 de noviembre de 2022
- Bot API 6.2 — 12 de agosto de 2022
- Bot API 6.1 — 20 de junio de 2022
- Bot API 6.0 — 16 de abril de 2022
- Bot API 5.7 — 31 de enero de 2022
- Bot API 5.6 — 30 de diciembre de 2021
- Bot API 5.5 — 7 de diciembre de 2021
- Bot API 5.4 — 5 de noviembre de 2021
- Bot API 5.3 — 25 de junio de 2021
- Bot API 5.2 — 26 de abril de 2021
- Bot API 5.1 — 9 de marzo de 2021
- Bot API 5.0 — 4 de noviembre de 2020
- Bot API 4.9 — 4 de junio de 2020
- Bot API 4.8 — 24 de abril de 2020
- Bot API 4.7 — 30 de marzo de 2020
- Bot API 4.6 — 23 de enero de 2020
- Bot API 4.5 — 31 de diciembre de 2019
- Bot API 4.4 — 29 de julio de 2019
- Bot API 4.3 — 31 de mayo 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 julio de 2018
- Bot API 3.6 — 13 de febrero de 2018
- Bot API 3.5 — 17 de noviembre de 2017
- Bot API 3.4 — 11 de octubre de 2017
- Bot API 3.3 — 23 de agosto de 2017
- Bot API 3.2 — 21 de julio de 2017
- Bot API 3.1 — 30 de junio de 2017
- Bot API 3.0 — 18 de mayo de 2017
- Bot API 2.3.1 — 4 de diciembre de 2016
- Bot API 2.3 — 21 de noviembre de 2016
- Bot API 2.2. — 3 de octubre de 2016
- Bot API 2.1. — 22 de mayo de 2016
- Bot API 2.0 — 9 de abril de 2016
Preguntas frecuentes
¿Cuál es la versión más reciente de la Telegram Bot API?
La Bot API 10.5, publicada el 22 de noviembre de 2026. Tiene 194 métodos.
¿Con qué frecuencia cambia la Telegram Bot API?
Telegram suele publicar una nueva versión de la Bot API cada uno o dos meses. Cada versión agrega métodos y campos; algunas también incluyen cambios incompatibles, que se señalan en las descripciones.
¿Cómo sé cuándo se agregó un método?
Abre el método en nuestra referencia de métodos: la sección Historial de versiones muestra la versión que lo agregó y las que lo modificaron, con enlaces a esta página.