Bot API Huge Update - 7.0, introducing reactions, replies and some other changes #2106

coder2020official · 2023-12-29T13:30:56Z

December 29, 2023
Bot API 7.0

Reactions

Added the classes ReactionTypeEmoji and ReactionTypeCustomEmoji representing different types of reaction.
Added updates about a reaction change on a message with non-anonymous reactions, represented by the class MessageReactionUpdated and the field message_reaction in the class Update. The bot must explicitly allow the update to receive it.
Added updates about reaction changes on a message with anonymous reactions, represented by the class MessageReactionCountUpdated and the field message_reaction_count in the class Update. The bot must explicitly allow the update to receive it.
Added the method setMessageReaction that allows bots to react to messages.
Added the field available_reactions to the class Chat.

Replies 2.0

Added the ability to reply to messages in other chats or forum topics.
Added the class ExternalReplyInfo and the field external_reply of type ExternalReplyInfo to the class Message, containing information about a message that is replied to by the current message, but can be from another chat or forum topic.
Added the ability to quote a part of the replied message.
Added the class TextQuote and the field quote of type TextQuote to the class Message, which contains the part of the replied message text or caption that is quoted in the current message.
Added the class ReplyParameters and replaced parameters reply_to_message_id and allow_sending_without_reply in the methods copyMessage, sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, and sendMediaGroup with the field reply_parameters of type ReplyParameters.

Link Preview Customization

Allowed to explicitly specify the URL that will be used for link preview generation in outgoing text messages.
Allowed to position link previews above the message text.
Allowed to choose media size in link previews.
Added the class LinkPreviewOptions and replaced the parameter disable_web_page_preview with link_preview_options in the methods sendMessage and editMessageText.
Replaced the field disable_web_page_preview with link_preview_options in the class InputTextMessageContent.
Added the field link_preview_options to the class Message with information about the link preview options used to send the message.

Block Quotation

Added support for “blockquote” entities in received messages.
Added support for “blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.
Allowed to explicitly specify “blockquote” entities in formatted texts.

Multiple Message Actions

Added the method deleteMessages to allow the deletion of multiple messages in a single request.
Added the method forwardMessages for forwarding of multiple messages in a single request.
Added the method copyMessages for copying of multiple messages in a single request.

Request for multiple users

Renamed the class KeyboardButtonRequestUser to KeyboardButtonRequestUsers and added the field max_quantity to it.
Renamed the field request_user in the class KeyboardButton to request_users. The old name will still work for backward compatibility.
Added the class UsersShared.
Replaced the field user_shared in the class Message with the field users_shared.

Chat Boost

Added updates about chat boost changes, represented by the classes ChatBoostUpdated and ChatBoostRemoved and the fields chat_boost and removed_chat_boost in the class Update. The bot must be an administrator in the chat to receive these updates.
Added the classes ChatBoostSourcePremium, ChatBoostSourceGiftCode and ChatBoostSourceGiveaway, representing different sources of a chat boost.
Added the method getUserChatBoosts for obtaining the list of all active boosts a user has contributed to a chat.

Giveaway

Added the class Giveaway and the field giveaway to the class Message for messages about scheduled giveaways.
Added the class GiveawayCreated and the field giveaway_created to the class Message for service messages about the creation of a scheduled giveaway.
Added the class GiveawayWinners and the field giveaway_winners to the class Message for messages about the completion of a giveaway with public winners.
Added the class GiveawayCompleted and the field giveaway_completed to the class Message for service messages about the completion of a giveaway without public winners.

Other Changes

Added support for the fields emoji_status_custom_emoji_id and emoji_status_expiration_date in the class Chat for non-private chats.
Added the fields accent_color_id, background_custom_emoji_id, profile_accent_color_id, and profile_background_custom_emoji_id to the class Chat.
Added the field has_visible_history to the class Chat.
Added the class MessageOrigin and replaced the fields forward_from, forward_from_chat, forward_from_message_id, forward_signature, forward_sender_name, and forward_date with the field forward_origin of type MessageOrigin in the class Message.
Improved documentation for the field message of the class callbackQuery and the field pinned_message of the class Message by adding the classes MaybeInaccessibleMessage and InaccessibleMessage.

…senting different types of reaction.

…ctions, represented by the class MessageReactionCountUpdated and the field message_reaction_count in the class Update. The bot must explicitly allow the update to receive it.

…ages.

…e ExternalReplyInfo to the class Message, containing information about a message that is replied to by the current message, but can be from another chat or forum topic.

…; CHECK THE COMMIT!

coder2020official · 2023-12-29T16:53:24Z

telebot/types.py

@@ -1208,6 +1214,13 @@ def de_json(cls, json_string):
        if 'story' in obj:
            opts['story'] = Story.de_json(obj['story'])
            content_type = 'story'
+        if 'external_reply' in obj:
+            opts['external_reply'] = ExternalReplyInfo.de_json(obj['external_reply'])
+            content_type = 'text' # @Badiboy not sure about content_types in here, please check


@Badiboy check this line and the lines below

You can check it in previous commit

As I get the meaning of the field "external_reply" - it contains ADDITIONAL INFORMATION to the main content. So it should not process content_type at all: content_type will be set by the main data fields like "text"/"audio" etc.

The same for "quote".

I'll removed the content_type assignment in commit.

… in the class InputTextMessageContent.

…mation about the link preview options used to send the message.

…Users and added the field max_quantity to it. Renamed the field request_user in the class KeyboardButton to request_users. The old name will still work for backward compatibility.

…lass Message with the field users_shared.

coder2020official · 2023-12-29T19:04:35Z

telebot/types.py

-            content_type = 'user_shared'
+        if 'users_shared' in obj:
+            opts['users_shared'] = UserShared.de_json(obj['users_shared'])
+            content_type = 'users_shared' # COMPATIBILITY BROKEN!


@Badiboy compatibility will be broken here. They renamed the property, and this makes me rename the content_type too. Any ideas?

I don't see any better way... Let's hope not much people used this content type...

coder2020official · 2023-12-29T19:05:02Z

Bot API Update is just a bunch of deprecation warnings. Always.

…bout winners

Fix "new_" usage. No valuable changes.

reply_to_message_id and allow_sending_without_reply deprecation extended with more precise values processing

Badiboy · 2024-01-02T21:26:37Z

@coder2020official
For commit 79cc127 please update Async in the same way if you confirm these changes.

disable_web_page_preview deprecation extended with more precise values processing

Badiboy · 2024-01-02T21:39:54Z

@coder2020official For commit 56fbcaf please update Async in the same way if you confirm these changes.

Badiboy · 2024-01-03T10:17:10Z

telebot/apihelper.py

+def set_message_reaction(token, chat_id, message_id, reaction=None, is_big=None):
+    method_url = r'setMessageReaction'
+    payload = {'chat_id': chat_id, 'message_id': message_id}
+    if reaction:


Proposal.
Check if reaction is not list (single reaction) and convert it to list.
or
Check if reaction is not list and raise error with explanation.

Reasonable.
I suppose lot of mistakes by users because of parameter naming: "reaction".

Badiboy · 2024-01-03T10:44:04Z

telebot/async_telebot.py

@@ -586,6 +592,8 @@ async def process_new_updates(self, updates: List[types.Update]):
        new_my_chat_members = None
        new_chat_members = None
        chat_join_request = None


Propose rename all three items to "new_".

Badiboy · 2024-01-03T10:45:01Z

telebot/async_telebot.py

+        if new_message_reaction_count_handlers:
+            await self.process_new_message_reaction_count(new_message_reaction_count_handlers)
+        if chat_boost_handlers:
+            await self.process_new_chat_boost(chat_boost_handlers)


removed_chat_boost_handlers !

Badiboy · 2024-01-03T10:51:38Z

telebot/async_telebot.py

@@ -5490,6 +6133,33 @@ async def answer_callback_query(
        :rtype: :obj:`bool`
        """
        return await asyncio_helper.answer_callback_query(self.token, callback_query_id, text, show_alert, url, cache_time)
+
+# getUserChatBoosts


Remove comment

Badiboy · 2024-01-03T11:11:23Z

telebot/types.py

@@ -776,6 +833,9 @@ class Message(JsonDeserializable):
    :param forward_date: Optional. For forwarded messages, date the original message was sent in Unix time
    :type forward_date: :obj:`int`

+    :forward_origin: Optional. For forwarded messages, information about the original message; 


Comment for me: set deprecation for forward_xxx fields (in the next update: this one is too large).

Added the class MessageOrigin and replaced the fields forward_from, forward_from_chat, forward_from_message_id, forward_signature, forward_sender_name, and forward_date with the field forward_origin of type MessageOrigin in the class Message.

Badiboy · 2024-01-03T12:07:44Z

telebot/types.py

@@ -1283,9 +1390,20 @@ def __init__(self, message_id, from_user, date, chat, content_type, options, jso
        self.general_forum_topic_hidden: Optional[GeneralForumTopicHidden] = None
        self.general_forum_topic_unhidden: Optional[GeneralForumTopicUnhidden] = None
        self.write_access_allowed: Optional[WriteAccessAllowed] = None
-        self.user_shared: Optional[UserShared] = None
+        self.users_shared: Optional[UserShared] = None
+        self.user_shared: Optional[UserShared] = self.users_shared


Comment for me: process with deprecation

Badiboy · 2024-01-03T12:12:21Z

telebot/types.py

        return data

+KeyboardButtonRequestUser = KeyboardButtonRequestUsers


Process with deprecation.

Badiboy · 2024-01-03T12:22:34Z

telebot/types.py

@@ -7515,7 +7647,7 @@ def __init__(self, from_request: Optional[bool]=None, web_app_name: Optional[str
 class UserShared(JsonDeserializable):


Comment for me: change class from UserShared => UsersShared + deprecation

Badiboy · 2024-01-03T12:37:14Z

telebot/types.py

+    :rtype: :class:`ExternalReplyInfo`
+    """
+    @classmethod
+    def de_json(cls, json_string):


Bad autogenerated code not corresponding to common way. It's better to check autogeneration resutls.

Badiboy · 2024-01-03T12:43:49Z

telebot/types.py

+            return None
+        obj = cls.check_json(json_string)
+
+        return cls(is_disabled=obj.get('is_disabled'), url=obj.get('url'), prefer_small_media=obj.get('prefer_small_media'),


Badiboy · 2024-01-03T13:22:11Z

@coder2020official I'm done. You did a huge work. Me too. :)

This update is suitable to merge and then we'll fix raised questions in separate SMALL updates )

coder2020official · 2024-01-03T13:43:37Z

Nice!
Shouldn't I fix some things for async or did you fix them manually?

Badiboy · 2024-01-03T13:53:52Z

Nice! Shouldn't I fix some things for async or did you fix them manually?

I did critical fixes for Async also. The given comments are regarding "fine tuning" and are left for you: if you think it's usefull - you can apply the same in Async.

Badiboy · 2024-01-03T13:57:14Z

@coder2020official What about new version?
4.15? 5.0?

coder2020official · 2024-01-03T14:16:11Z

4.2, 5 is a way big number

coder2020official · 2024-01-03T14:17:42Z

And about the fine tuning - are you talking about type hints?

Badiboy · 2024-01-03T14:23:48Z

4.2, 5 is a way big number

4.2 is not possible, it already exists. :) 4.14 is not 4.1.4 )))
So either 4.15 or 5.0, no other ways )

Badiboy · 2024-01-03T14:24:44Z

And about the fine tuning - are you talking about type hints?

Start of bot API Update - 7.0

430e327

coder2020official changed the title ~~Start of bot API Update - 7.0~~ Bot API Huge Update - 7.0, introducing reactions, replies and some other changes Dec 29, 2023

coder2020official added 11 commits December 29, 2023 19:02

Added the classes ReactionTypeEmoji and ReactionTypeCustomEmoji repre…

134f45b

…senting different types of reaction.

New handler: message_reaction_handler(untested)

974395e

Fix tests for the new handler

8fee136

Fix tests eternnoir#2

97e0d4e

Fix minor issue for tests eternnoir#3

2fb2e30

Added updates about reaction changes on a message with anonymous rea…

854c685

…ctions, represented by the class MessageReactionCountUpdated and the field message_reaction_count in the class Update. The bot must explicitly allow the update to receive it.

Fix tests for the new handler

96b4ced

Added the method setMessageReaction that allows bots to react to mess…

b6a0d6c

…ages.

Added the field available_reactions to the class Chat.

7576458

Added the class ExternalReplyInfo and the field external_reply of typ…

ad816f2

…e ExternalReplyInfo to the class Message, containing information about a message that is replied to by the current message, but can be from another chat or forum topic.

Added TextQuote and fixed extrernal_reply (forgot in previous commit)…

5e01891

…; CHECK THE COMMIT!

coder2020official commented Dec 29, 2023

View reviewed changes

coder2020official added 11 commits December 29, 2023 22:51

ReplyParameters support for sync, including backward compatibility

2604655

Fix the typo and therefore tests

6211366

Fix tests attempt 2

3b5d2d7

Added reply_parameters to sync

c04ae53

Fix some issues with the previous commit

545cedb

Added support for linkpreviewoptions

b8ef19d

Replaced the field disable_web_page_preview with link_preview_options…

0485c31

… in the class InputTextMessageContent.

Added the field link_preview_options to the class Message with infor…

a261174

…mation about the link preview options used to send the message.

Added Copy,Delete,Forward Messages to sync and async

c406e6c

Renamed the class KeyboardButtonRequestUser to KeyboardButtonRequest…

254387d

…Users and added the field max_quantity to it. Renamed the field request_user in the class KeyboardButton to request_users. The old name will still work for backward compatibility.

Added the class UsersShared. Replaced the field user_shared in the c…

350f7fe

…lass Message with the field users_shared.

coder2020official commented Dec 29, 2023

View reviewed changes

coder2020official added 3 commits December 30, 2023 12:42

Chat Boosts full support for handlers;

e1c9223

get_user_chat_boosts for sync and async; +UserChatBoosts

137ea69

Giveaways full support: start and end of giveaways, and information a…

ab2d1fa

…bout winners

coder2020official and others added 3 commits December 31, 2023 21:22

Fix reply_markup issue with reply_parameters conflict

05a939b

Fix naming in Update class

52a0314

Fix "new_" usage. No valuable changes.

reply_to_message_id and allow_sending_without_reply deprecation

79cc127

reply_to_message_id and allow_sending_without_reply deprecation extended with more precise values processing

disable_web_page_preview deprecation

56fbcaf

disable_web_page_preview deprecation extended with more precise values processing

Badiboy added 5 commits January 3, 2024 00:45

Fix forward_messages return value

778a02c

Fix forward_messages return value in Async

0af7f6f

Fix the fix forward_messages return value

0ace17b

Fix message_reaction_x_handler description

578d6a3

Fix message_reaction_x_handler description for Async

4359f4f

Badiboy reviewed Jan 3, 2024

View reviewed changes

Fix and align reply_parameters

9831ae2

Badiboy reviewed Jan 3, 2024

View reviewed changes

Badiboy added 3 commits January 3, 2024 15:24

Fix minor bugs in types.py

71f53d3

reply_parameters => to_json

b96084f

Fix classes loading in types.py

0c9bdfb

Badiboy approved these changes Jan 3, 2024

View reviewed changes

Badiboy merged commit 8b0313a into eternnoir:master Jan 3, 2024
7 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Bot API Huge Update - 7.0, introducing reactions, replies and some other changes #2106

Bot API Huge Update - 7.0, introducing reactions, replies and some other changes #2106

coder2020official commented Dec 29, 2023 •

edited

Loading

coder2020official Dec 29, 2023

coder2020official Dec 29, 2023

Badiboy Jan 3, 2024

coder2020official Dec 29, 2023

Badiboy Jan 3, 2024

coder2020official commented Dec 29, 2023

Badiboy commented Jan 2, 2024

Badiboy commented Jan 2, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy Jan 3, 2024

Badiboy commented Jan 3, 2024

coder2020official commented Jan 3, 2024

Badiboy commented Jan 3, 2024

Badiboy commented Jan 3, 2024

coder2020official commented Jan 3, 2024

coder2020official commented Jan 3, 2024

Badiboy commented Jan 3, 2024

Badiboy commented Jan 3, 2024

		return data

		KeyboardButtonRequestUser = KeyboardButtonRequestUsers

		@@ -7515,7 +7647,7 @@ def __init__(self, from_request: Optional[bool]=None, web_app_name: Optional[str
		class UserShared(JsonDeserializable):

Bot API Huge Update - 7.0, introducing reactions, replies and some other changes #2106

Bot API Huge Update - 7.0, introducing reactions, replies and some other changes #2106

Conversation

coder2020official commented Dec 29, 2023 • edited Loading

Reactions

Replies 2.0

Link Preview Customization

Block Quotation

Multiple Message Actions

Request for multiple users

Chat Boost

Giveaway

Other Changes

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

coder2020official commented Dec 29, 2023

Badiboy commented Jan 2, 2024

Badiboy commented Jan 2, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Badiboy commented Jan 3, 2024

coder2020official commented Jan 3, 2024

Badiboy commented Jan 3, 2024

Badiboy commented Jan 3, 2024

coder2020official commented Jan 3, 2024

coder2020official commented Jan 3, 2024

Badiboy commented Jan 3, 2024

Badiboy commented Jan 3, 2024

coder2020official commented Dec 29, 2023 •

edited

Loading