send_reaction()

Client.send_reaction()

Use this method to send reactions on a message/stories. Service messages can’t be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. You can also use chat public link in form of t.me/<username> (str).

  • message_id (int, optional) – Identifier of the target message. If the message belongs to a media group, the reaction is set to the first non-deleted message in the group instead.

  • story_id (int, optional) – Identifier of the story.

  • emoji (int | str | List of int | str, optional) – Reaction emoji. Pass None as emoji (default) to retract the reaction. Pass list of int or str to react multiple emojis.

  • big (bool, optional) – Pass True to set the reaction with a big animation. For message reactions only. Defaults to False.

  • add_to_recent (bool, optional) – Pass True if the reaction should appear in the recently used reactions. This option is applicable only for users.

Returns:

MessageReactions – On success, True is returned.

Example

# Send a reaction
await app.send_reaction(chat_id, message_id=message_id, emoji="🔥")
await app.send_reaction(chat_id, story_id=story_id, emoji="🔥")

# Send a multiple reactions
await app.send_reaction(chat_id, message_id=message_id, emoji=["🔥", "❤️"])

# Retract a reaction
await app.send_reaction(chat_id, message_id=message_id)
await app.send_reaction(chat_id, story_id=story_id)