Botapi 10.0 by coder2020official · Pull Request #2592 · eternnoir/pyTelegramBotAPI

coder2020official · 2026-05-10T12:52:27Z

May 8, 2026
Bot API 10.0

Guest Mode

Introduced support for guest mode, allowing bots to receive certain messages and issue replies within chats they are not a member of.
Added the field supports_guest_queries to the class User.
Added the fields guest_bot_caller_user and guest_bot_caller_chat to the class Message.
Added the field guest_query_id to the class Message.
Added the field guest_message to the class Update.
Added the class SentGuestMessage and the method answerGuestQuery.

Chat Management

Added the field can_react_to_messages to the classes ChatMemberRestricted and ChatPermissions.
Added the parameter return_bots to the method getChatAdministrators.
Added the method deleteAllMessageReactions.
Added the method deleteMessageReaction.
Added the ability to see certain messages sent by other bots in groups.

Polls

Live photos

Added the class LivePhoto, which represents a photo with a short video.
Added the class InputMediaLivePhoto.
Added the field live_photo to the classes Message and ExternalReplyInfo.
Added the method sendLivePhoto, allowing bots to send live photos.
Added the class PaidMediaLivePhoto, which describes a paid media with a live photo.
Added the class InputPaidMediaLivePhoto, allowing bots to send live photos as paid media.
Allowed to use live photos in sendMediaGroup and editMessageMedia,

General

Allowed Business Bots to manage user accounts without a Telegram Premium subscription.
Added the ability to send messages to other bots via username if both bots enabled bot-to-bot communication.
Added the ability to reply to other bots from a business bot if the business bot enabled bot-to-bot communication.
Allowed bots to pass an empty text in the method sendMessageDraft.
Added the class BotAccessSettings and the method getManagedBotAccessSettings.
Added the method setManagedBotAccessSettings.
Added the method getUserPersonalChatMessages.

…he class Message.

…icted and ChatPermissions.

…diaVenue.

…in polls.

…media in poll options.

…nfo.

…et_managed_bot_access_settings

coder2020official · 2026-05-10T18:15:58Z

@Badiboy I'm done, please check

Badiboy · 2026-05-10T20:36:54Z

Took it.

All-The-Foxes · 2026-05-21T04:52:20Z

@coder2020official

I figured I'd test this to see if it worked. This is missing despite being checked off.

Added the class InputPollMedia and the parameters media and explanation_media to the method sendPoll, allowing bots to add media to polls.

Result: TypeError: AsyncTeleBot.send_poll() got an unexpected keyword argument 'media'

Badiboy · 2026-05-21T07:14:16Z

@coder2020official Sorry for delay, was hardly occupied. Started review, hope od it today.

coder2020official · 2026-05-21T08:56:42Z

Won't work for uploading files, will come back later

coder2020official · 2026-05-21T10:24:52Z

A little messy, should work though

coder2020official · 2026-05-23T17:44:29Z

Anything else?

Badiboy · 2026-05-23T18:18:31Z

Looks fine! Thank you!!!

Copilot

Pull request overview

This PR updates pyTelegramBotAPI to support Telegram Bot API 10.0, adding new update types (guest mode), new API methods/parameters, and new data models for polls and live photos.

Changes:

Add guest mode support via new Update.guest_message handling, guest query answering, and related Message/User fields.
Add new Bot API methods/params (e.g., answerGuestQuery, sendLivePhoto, return_bots for getChatAdministrators, reaction deletion helpers, managed-bot access settings, user personal chat messages).
Add/extend types for poll media and live photos (e.g., PollMedia, InputMediaLivePhoto, paid-media live photo types).

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
`tests/test_telebot.py`	Updates test helper to include `guest_message` in constructed `Update`.
`tests/test_handler_backends.py`	Updates `Update(...)` construction to match new signature/fields.
`telebot/util.py`	Adds `guest_message` to recognized update types.
`telebot/types.py`	Adds/extends core API types for guest mode, polls media, live photos, paid-media live photo, bot access settings.
`telebot/asyncio_helper.py`	Adds async API wrappers for new Bot API 10.0 methods/params and extends `send_poll` to support media + new flags.
`telebot/async_telebot.py`	Wires new update handling + adds high-level async methods (guest queries, live photos, extended poll sending).
`telebot/apihelper.py`	Adds sync API wrappers for new Bot API 10.0 methods/params and extends `send_poll` similarly.
`telebot/__init__.py`	Wires new update handling + adds high-level sync methods (guest queries, live photos, extended poll sending).
`README.md`	Bumps the documented supported Bot API version to 10.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+
+    def to_dict(self):
+        data = super().to_dict()
+        data['photo'] = self.photo if service_utils.is_string(self.photo) else 'attach://{0}'.format(service_utils.generate_random_token())


+    def __init__(self, media: str, photo: str, caption: Optional[str] = None, parse_mode: Optional[str] = None,
+                 caption_entities: Optional[List[MessageEntity]] = None, show_caption_above_media: Optional[bool] = None, has_spoiler: Optional[bool] = None):
+        super(InputMediaLivePhoto, self).__init__(type="live_photo", media=media, caption=caption, parse_mode=parse_mode, caption_entities=caption_entities)
+        self.photo: str = photo
+        self.show_caption_above_media: Optional[bool] = show_caption_above_media
+        self.has_spoiler: Optional[bool] = has_spoiler
+
+    def to_dict(self):
+        json_dict = super(InputMediaLivePhoto, self).to_dict()
+        json_dict['photo'] = self.photo
+        if self.show_caption_above_media is not None:
+            json_dict['show_caption_above_media'] = self.show_caption_above_media
+        if self.has_spoiler is not None:
+            json_dict['has_spoiler'] = self.has_spoiler
+        return json_dict


Badiboy · 2026-05-23T18:26:17Z

Last check from copilot...

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

coder2020official · 2026-05-23T18:33:08Z

Bruh will have to manually address suggested changes

coder2020official · 2026-05-23T18:47:19Z

This should work right..

coder2020official · 2026-05-23T18:51:45Z

Yeah seems to be working

coder2020official · 2026-05-23T18:56:57Z

Should be done @Badiboy please take a look at changes

Badiboy · 2026-05-23T19:23:54Z

Looks like solved... One more round with copilot? :)

Copilot

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 7 comments.

+        data = super().to_dict()
+        data['photo'] = self._photo_dic
+        return data



Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

coder2020official · 2026-05-23T19:57:35Z

Uh @Badiboy isn't inputpaidmedia supposed to have the convert_input_media as a function to return the file?

coder2020official · 2026-05-23T20:02:11Z

@Badiboy could you fix the inputpaidmedia absence of convert_input_media in a separate PR?

Badiboy · 2026-05-23T20:03:59Z

I'm a bit lost with all these medias. Let's merge, then I'll take a look.

coder2020official · 2026-05-23T20:10:25Z

then I'm done, please merge

All-The-Foxes · 2026-05-23T20:15:23Z

Uh @Badiboy isn't inputpaidmedia supposed to have the convert_input_media as a function to return the file?

I would test it but I don't have the resources to pay for random media for test purposes nor am I sure how it even works. Ideally it would be great if it was working, but no one seems to use it anyway or if they did they haven't raised any issues with it.

coder2020official added 23 commits May 10, 2026 16:31

Added the field supports_guest_queries to the class User.

2c2f7bb

Added the fields guest_bot_caller_user and guest_bot_caller_chat to t…

d19162b

…he class Message.

Added the field guest_query_id to the class Message.

1107385

Added the field guest_message to the class Update.

13f3dec

Added the class SentGuestMessage and the method answerGuestQuery.

82d466d

Added the field can_react_to_messages to the classes ChatMemberRestr…

2a0aa5d

…icted and ChatPermissions.

Added the parameter return_bots to the method getChatAdministrators.

abb6663

Added the methods deleteAllMessageReactions and deleteMessageReaction

7aede1a

Added the classes InputMediaSticker, InputMediaLocation, and InputMe…

0cc0e2c

…diaVenue.

Added the class PollMedia, representing a media in a poll.

5981b24

Added the field media to the class Poll, allowing bots to see media …

5dbf1c1

…in polls.

Added fields explanation_media, members_only, and country_codes to Poll

81e2c5e

Added the field media to the class PollOption, allowing bots to see …

4344145

…media in poll options.

Added InputPollMedia and InputPollOptionMedia

d2f5052

Added media to InputPollOption

8f0ddb1

Added country_codes, members_only to sendPoll;

135666c

Added classes InputMediaLivePhoto and LivePhoto

167760e

Added the field live_photo to the classes Message and ExternalReplyI…

fb11143

…nfo.

Added the method sendLivePhoto, allowing bots to send live photos.

a57a688

Added PaidMediaLivePhoto and InputPaidMediaLivePhoto

ac293e2

Allowed to use live photos in sendMediaGroup and editMessageMedia,

5136e29

Allowed bots to pass an empty text in the method sendMessageDraft.

5b91858

Added getuserpersonalchatmessages, get_managed_bot_access_settings, s…

5909976

…et_managed_bot_access_settings

coder2020official requested a review from Badiboy May 10, 2026 18:15

Added media and explanation_media to send_poll

a2a8ff6

Fix media and explanation_media in sendPoll

44163d0

Badiboy reviewed May 21, 2026

View reviewed changes

Minor fixes

5b26dbf

Badiboy requested a review from Copilot May 23, 2026 18:18

Copilot started reviewing on behalf of Badiboy May 23, 2026 18:19 View session

Copilot AI reviewed May 23, 2026

View reviewed changes

Enhance description for guest_handler

20994b4

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Address Suggestions

ff4d948

Badiboy requested a review from Copilot May 23, 2026 19:23

Copilot started reviewing on behalf of Badiboy May 23, 2026 19:24 View session

Copilot AI reviewed May 23, 2026

View reviewed changes

Fix InputMediaLivePhoto file uploads

5817721

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Minor fixes

383da51

Badiboy merged commit 0b0fb8e into eternnoir:master May 23, 2026
6 checks passed

Conversation

coder2020official commented May 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coder2020official commented May 10, 2026

Uh oh!

Badiboy commented May 10, 2026

Uh oh!

All-The-Foxes commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Badiboy commented May 21, 2026

Uh oh!

coder2020official commented May 21, 2026

Uh oh!

coder2020official commented May 21, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

Badiboy commented May 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Badiboy commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

Badiboy commented May 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

Badiboy commented May 23, 2026

Uh oh!

coder2020official commented May 23, 2026

Uh oh!

Uh oh!

All-The-Foxes commented May 23, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

coder2020official commented May 10, 2026 •

edited

Loading

All-The-Foxes commented May 21, 2026 •

edited

Loading