send_reaction()#

Client.send_reaction()#

Send a reaction to a message or story.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

  • message_id (int, optional) – Identifier of the message.

  • 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.

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

  • big (bool, optional) – Pass True to show a bigger and longer reaction. Defaults to False.

Returns:

bool – On success, True is returned.

Example

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

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

# Send a reaction with premium emoji
await app.send_reaction(chat_id, message_id=message_id, emoji=5319161050128459957)

# Send a reaction to story
await app.send_reaction(chat_id, story_id=story_id, emoji="❤️")

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