Skip to content

feat(telegram): support Telegram Bot API 10.2 #64497

Description

@codxt

Summary

Please add compatibility and first-class support for Telegram Bot API 10.2, released on July 14, 2026.

Official changelog: https://core.telegram.org/bots/api-changelog#july-14-2026

Relevant additions

Rich Messages

  • Support InputRichMessage.media.
  • Support InputMediaVoiceNote.
  • Support the new outgoing rich block types, including lists, tables, details, collages, slideshows, media blocks, and thinking blocks.
  • Support InputRichMessage.blocks for block-based outgoing rich messages.

Ephemeral Messages

  • Parse BotCommand.is_ephemeral, Message.receiver_user, and Message.ephemeral_message_id.
  • Support receiver_user_id and callback_query_id when sending messages and media.
  • Support replies through ReplyParameters.ephemeral_message_id.
  • Expose the new edit methods:
    • editEphemeralMessageText
    • editEphemeralMessageMedia
    • editEphemeralMessageCaption
    • editEphemeralMessageReplyMarkup
  • Expose deleteEphemeralMessage.

Communities

  • Parse the new Community, CommunityChatAdded, and CommunityChatRemoved objects.
  • Handle Message.community_chat_added, Message.community_chat_removed, and ChatFullInfo.community without dropping or rejecting updates.

General compatibility

  • Parse Update.subscription / BotSubscriptionUpdated.
  • Upgrade or patch the Telegram client dependency as required for Bot API 10.2.
  • Ensure unknown/new fields do not cause inbound updates to be discarded.
  • Add adapter tests for representative 10.2 payloads and outbound method parameters.
  • Document which 10.2 capabilities are exposed directly through Hermes and which remain pass-through only.

Motivation

Hermes uses Telegram as a primary agent interface. Bot API 10.2 adds user-specific ephemeral interactions and richer structured agent responses, both of which are particularly relevant to AI-agent workflows in shared chats.

A staged implementation is reasonable: payload compatibility and non-dropping parsing first, followed by first-class Hermes abstractions for ephemeral and rich-message capabilities.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Low — cosmetic, nice to havecomp/gatewayGateway runner, session dispatch, deliveryplatform/telegramTelegram bot adaptertype/featureNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions