Bot API 10.3 update

[Badiboy]

Description

Bot API 10.3 updates.

Changes

Bot API 10.3 types and serialization

• Added rich-message support:
  • RichMessageButton
  • RichTextButton
  • RichBlockButtons / InputRichBlockButtons
  • RichBlockExpandableBlockQuotation / InputRichBlockExpandableBlockQuotation
  • RichBlockDocument / InputRichBlockDocument
• Added DisabledButton.
• Added EphemeralMessageParameters.
• Added MessageGenerationStopped.
• Added CommunityChatJoined.
• Added newly documented fields for:
  • compact rich-text tables;
  • unique-gift entities;
  • community chat joins;
  • stopped message generation;
  • disabled and force-reply buttons.

API helpers and sending methods

• Updated synchronous and asynchronous helper methods for the Bot API 10.3 request format.
• Replaced top-level ephemeral-message payload fields with ephemeral_message_parameters.
• Added support for ephemeral rich messages and related edit operations.
• Added support for rich-message drafts, message-generation control, community chat operations, welcome-rights updates, and other 10.3 endpoint changes.

Backward compatibility

• Deprecated receiver_user_id and callback_query_id parameters.
• Converts legacy arguments to EphemeralMessageParameters.
• Gives an explicitly supplied ephemeral_message_parameters object priority when both old and new forms are passed.

Update dispatch and handlers

• Added complete routing for Update.stopped_message_generation in both TeleBot and AsyncTeleBot.
• Added public handler registration APIs:
  • stopped_message_generation_handler
  • add_stopped_message_generation_handler
  • register_stopped_message_generation_handler
• Added stopped_message_generation to util.update_types.
• Added community_chat_joined to util.content_type_service.
• Fixed an existing async routing issue where removed_chat_boost updates were collected but never dispatched.
• Updated synchronous typed_middleware_handlers to cover all supported top-level update types, including:
  • purchased_paid_media
  • managed_bot
  • guest_message
  • subscription
  • stopped_message_generation

[Copilot]

🟡 Changes recommended

Async draft support remains incomplete, markup deserialization loses data, and several changed signatures break positional callers.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the library for Telegram Bot API 10.3 across types, request helpers, handlers, and metadata.

Changes:

• Adds Bot API 10.3 types and serialization fields.
• Extends synchronous/asynchronous sending and update dispatch.
• Updates tests, documentation, and package version to 4.37.0.

File summaries

File	Description
telebot/types.py	Adds 10.3 types and fields.
telebot/__init__.py	Updates synchronous APIs and handlers.
telebot/async_telebot.py	Updates asynchronous APIs and handlers.
telebot/apihelper.py	Serializes new synchronous request parameters.
telebot/asyncio_helper.py	Serializes new asynchronous request parameters.
telebot/util.py	Registers new update and content types.
tests/test_types.py	Tests new type serialization.
tests/test_telebot.py	Updates Update fixture construction.
tests/test_handler_backends.py	Updates positional Update fixtures.
telebot/version.py	Sets version 4.37.0.
pyproject.toml	Sets package version 4.37.0.
docs/source/conf.py	Sets documentation version 4.37.0.
README.md	Advertises Bot API 10.3 support.

Review details

Suppressed comments (3)

telebot/types.py:3738

• Adding this parameter before can_manage_direct_messages and can_manage_tags silently shifts existing positional constructor calls, assigning those rights to the wrong fields. Append the new right after the existing optional rights.

        custom_title: Optional[str] = None, can_send_welcome_messages: Optional[bool] = None,
        can_manage_direct_messages: Optional[bool] = None,
        can_manage_tags: Optional[bool] = None, **kwargs):

telebot/types.py:8397

• The new right is inserted before two existing positional parameters, so old ChatAdministratorRights(...) calls can now assign direct-message and tag permissions to the wrong fields. Move it after can_manage_tags to keep the constructor backward compatible.

        can_delete_stories: bool = False, can_send_welcome_messages: Optional[bool] = None, can_manage_direct_messages: Optional[bool] = None,
        can_manage_tags: Optional[bool]=None, **kwargs) -> None:

telebot/types.py:17194

• This insertion shifts the existing positional caption argument to is_compact, producing an invalid payload instead of the caller's caption. Add is_compact after caption to preserve the prior constructor ordering.

        is_compact: Optional[bool] = None,
        caption: Optional[RichText] = None,

• Files reviewed: 13/13 changed files
• Comments generated: 18
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Badiboy]

Some more fixes tomorrow.

[Badiboy]

@coder2020official Looks done.

[coder2020official]

Saw it, will review it tomorrow

[coder2020official]

I'd still like placing new parameters at the end.. just to be safe..

WTF? Was direct_messages_topic_id missing since bot api 10.0?

[coder2020official]

On a quick glance, this looks fine

[Badiboy]

@coder2020official Go? :)

[coder2020official]

yes