Added the parameter message_effect_id to the methods forwardMessage and copyMessage.

Author: coder2020official

telebot/__init__.py

@@ -1827,7 +1827,8 @@ def forward_message(
             message_thread_id: Optional[int]=None,
             video_start_timestamp: Optional[int]=None,
             direct_messages_topic_id: Optional[int]=None,
-            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None) -> types.Message:
+            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None, 
+            message_effect_id: Optional[str]=None) -> types.Message:
         """
         Use this method to forward messages of any kind.
 
@@ -1866,6 +1867,9 @@ def forward_message(
             is automatically declined.
         :type suggested_post_parameters: :class:`telebot.types.SuggestedPostParameters`
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; only available when forwarding to private chats
+        :type message_effect_id: :obj:`str`
+
         :return: On success, the sent Message is returned.
         :rtype: :class:`telebot.types.Message`
         """
@@ -1877,7 +1881,7 @@ def forward_message(
                 self.token, chat_id, from_chat_id, message_id, disable_notification=disable_notification,
                 timeout=timeout, protect_content=protect_content, message_thread_id=message_thread_id,
                 video_start_timestamp=video_start_timestamp, direct_messages_topic_id=direct_messages_topic_id,
-                suggested_post_parameters=suggested_post_parameters
+                suggested_post_parameters=suggested_post_parameters, message_effect_id=message_effect_id
             )
         )
 
@@ -1901,7 +1905,8 @@ def copy_message(
             allow_paid_broadcast: Optional[bool]=None,
             video_start_timestamp: Optional[int]=None,
             direct_messages_topic_id: Optional[int]=None,
-            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None) -> types.MessageID:
+            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None,
+            message_effect_id: Optional[str]=None) -> types.MessageID:
         """
         Use this method to copy messages of any kind.
         Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied.
@@ -1973,6 +1978,9 @@ def copy_message(
             is automatically declined.
         :type suggested_post_parameters: :class:`telebot.types.SuggestedPostParameters`
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; only available when copying to private chats
+        :type message_effect_id: :obj:`str`
+
         :return: On success, the MessageId of the sent message is returned.
         :rtype: :class:`telebot.types.MessageID`
         """
@@ -2006,7 +2014,7 @@ def copy_message(
                 message_thread_id=message_thread_id, reply_parameters=reply_parameters,
                 show_caption_above_media=show_caption_above_media, allow_paid_broadcast=allow_paid_broadcast,
                 video_start_timestamp=video_start_timestamp, direct_messages_topic_id=direct_messages_topic_id,
-                suggested_post_parameters=suggested_post_parameters
+                suggested_post_parameters=suggested_post_parameters, message_effect_id=message_effect_id
             ))
 
 

telebot/apihelper.py

@@ -432,7 +432,8 @@ def get_chat_member(token, chat_id, user_id):
 def forward_message(
         token, chat_id, from_chat_id, message_id,
         disable_notification=None, timeout=None, protect_content=None, message_thread_id=None,
-        video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None):
+        video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None,
+        message_effect_id=None):
     method_url = r'forwardMessage'
     payload = {'chat_id': chat_id, 'from_chat_id': from_chat_id, 'message_id': message_id}
     if disable_notification is not None:
@@ -449,13 +450,16 @@ def forward_message(
         payload['direct_messages_topic_id'] = direct_messages_topic_id
     if suggested_post_parameters is not None:
         payload['suggested_post_parameters'] = suggested_post_parameters.to_json()
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
     return _make_request(token, method_url, params=payload)
 
 
 def copy_message(token, chat_id, from_chat_id, message_id, caption=None, parse_mode=None, caption_entities=None,
                  disable_notification=None, reply_markup=None, timeout=None, protect_content=None, message_thread_id=None,
                  reply_parameters=None, show_caption_above_media=None, allow_paid_broadcast=None,
-                 video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None):
+                 video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None,
+                 message_effect_id=None):
     method_url = r'copyMessage'
     payload = {'chat_id': chat_id, 'from_chat_id': from_chat_id, 'message_id': message_id}
     if caption is not None:
@@ -486,6 +490,8 @@ def copy_message(token, chat_id, from_chat_id, message_id, caption=None, parse_m
         payload['direct_messages_topic_id'] = direct_messages_topic_id
     if suggested_post_parameters is not None:
         payload['suggested_post_parameters'] = suggested_post_parameters.to_json()
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
     return _make_request(token, method_url, params=payload)
 
 def send_checklist(

telebot/async_telebot.py

@@ -3355,7 +3355,8 @@ async def forward_message(
             message_thread_id: Optional[int]=None,
             video_start_timestamp: Optional[int]=None,
             direct_messages_topic_id: Optional[int]=None,
-            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None) -> types.Message:
+            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None,
+            message_effect_id: Optional[str]=None) -> types.Message:
         """
         Use this method to forward messages of any kind.
 
@@ -3394,6 +3395,9 @@ async def forward_message(
             is automatically declined.
         :type suggested_post_parameters: :class:`telebot.types.SuggestedPostParameters`
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; only available when forwarding to private chats
+        :type message_effect_id: :obj:`str`
+
         :return: On success, the sent Message is returned.
         :rtype: :class:`telebot.types.Message`
         """
@@ -3404,7 +3408,8 @@ async def forward_message(
             await asyncio_helper.forward_message(self.token, chat_id=chat_id, from_chat_id=from_chat_id, message_id=message_id,
                                                     disable_notification=disable_notification, protect_content=protect_content,
                                                     timeout=timeout, message_thread_id=message_thread_id, video_start_timestamp=video_start_timestamp,
-                                                    direct_messages_topic_id=direct_messages_topic_id, suggested_post_parameters=suggested_post_parameters)
+                                                    direct_messages_topic_id=direct_messages_topic_id, suggested_post_parameters=suggested_post_parameters,
+                                                    message_effect_id=message_effect_id)
         )
 
     async def copy_message(
@@ -3426,7 +3431,8 @@ async def copy_message(
             allow_paid_broadcast: Optional[bool]=None,
             video_start_timestamp: Optional[bool]=None,
             direct_messages_topic_id: Optional[int]=None,
-            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None) -> types.MessageID:
+            suggested_post_parameters: Optional[types.SuggestedPostParameters]=None,
+            message_effect_id: Optional[str]=None) -> types.MessageID:
         """
         Use this method to copy messages of any kind.
         If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages,
@@ -3499,6 +3505,9 @@ async def copy_message(
             is automatically declined.
         :type suggested_post_parameters: :class:`telebot.types.SuggestedPostParameters`
 
+        :param message_effect_id: Unique identifier of the message effect to be added to the message; only available when forwarding to private chats
+        :type message_effect_id: :obj:`str`
+
         :return: On success, the MessageId of the sent message is returned.
         :rtype: :class:`telebot.types.MessageID`
         """
@@ -3533,7 +3542,8 @@ async def copy_message(
                                                     reply_parameters=reply_parameters, reply_markup=reply_markup, timeout=timeout,
                                                     message_thread_id=message_thread_id, show_caption_above_media=show_caption_above_media,
                                                     allow_paid_broadcast=allow_paid_broadcast, video_start_timestamp=video_start_timestamp,
-                                                    direct_messages_topic_id=direct_messages_topic_id, suggested_post_parameters=suggested_post_parameters
+                                                    direct_messages_topic_id=direct_messages_topic_id, suggested_post_parameters=suggested_post_parameters,
+                                                    message_effect_id=message_effect_id
                                                 )
         )
 

telebot/asyncio_helper.py

@@ -434,7 +434,7 @@ async def forward_message(
         token, chat_id, from_chat_id, message_id,
         disable_notification=None, timeout=None, protect_content=None,
         message_thread_id=None, video_start_timestamp=None, direct_messages_topic_id=None,
-        suggested_post_parameters=None):
+        suggested_post_parameters=None, message_effect_id=None):
     method_url = r'forwardMessage'
     payload = {'chat_id': chat_id, 'from_chat_id': from_chat_id, 'message_id': message_id}
     if disable_notification is not None:
@@ -451,13 +451,16 @@ async def forward_message(
         payload['direct_messages_topic_id'] = direct_messages_topic_id
     if suggested_post_parameters is not None:
         payload['suggested_post_parameters'] = suggested_post_parameters.to_json()
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
     return await _process_request(token, method_url, params=payload)
 
 
 async def copy_message(token, chat_id, from_chat_id, message_id, caption=None, parse_mode=None, caption_entities=None,
                  disable_notification=None,  
                  reply_markup=None, timeout=None, protect_content=None, message_thread_id=None, reply_parameters=None, show_caption_above_media=None,
-                 allow_paid_broadcast=None, video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None):
+                 allow_paid_broadcast=None, video_start_timestamp=None, direct_messages_topic_id=None, suggested_post_parameters=None,
+                 message_effect_id=None):
     method_url = r'copyMessage'
     payload = {'chat_id': chat_id, 'from_chat_id': from_chat_id, 'message_id': message_id}
     if caption is not None:
@@ -488,6 +491,8 @@ async def copy_message(token, chat_id, from_chat_id, message_id, caption=None, p
         payload['direct_messages_topic_id'] = direct_messages_topic_id
     if suggested_post_parameters is not None:
         payload['suggested_post_parameters'] = suggested_post_parameters.to_json()
+    if message_effect_id:
+        payload['message_effect_id'] = message_effect_id
     return await _process_request(token, method_url, params=payload)
 
 async def send_checklist(