Skip to main content
POST
/
message
/
sendReaction
/
:instanceName
Send reaction
curl --request POST \
  --url https://api.example.com/message/sendReaction/:instanceName \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": {
    "remoteJid": "<string>",
    "fromMe": true,
    "id": "<string>"
  },
  "reaction": "<string>"
}
'
{
  "key": {},
  "message": {}
}

​
Request

React to a message with an emoji. Reactions appear next to the message and are visible to all chat participants.
​
instanceName
string
required
Name of the instance

​
Body parameters

​
key
object
required
Message key identifying the message to react to
​
reaction
string
required
Emoji to react with (e.g., ”👍”, “❤️”, ”😂”). Use an empty string "" to remove a reaction.

​
Response

​
key
object
Message key information
​
message
object
Reaction message details

​
Example request

curl -X POST https://your-api.com/message/sendReaction/my-instance \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": false,
      "id": "3EB0F2F5E6B5F5B5F5B5F5B5F5B5F5B5"
    },
    "reaction": "👍"
  }'

​
Common reactions

Send any emoji as the reaction value:
{
  "key": { ...messageKey },
  "reaction": "❤️"
}
Common reactions:
  • 👍 Thumbs up
  • ❤️ Heart
  • 😂 Laughing
  • 😮 Surprised
  • 😢 Sad
  • 🙏 Thank you
To remove your reaction, send an empty string:
{
  "key": { ...messageKey },
  "reaction": ""
}

​
Getting the message key

To react to a message, you need its message key. You can obtain this from:
  1. Webhook events: When you receive a message via webhook, the key object is included
  2. Send message response: When you send a message, the response includes the message key
  3. Message history: Retrieve messages using the chat endpoints
The message key format varies:
You can change your reaction by sending a new reaction to the same message. The previous reaction will be replaced.

Build docs developers (and LLMs) love

Get started for freeTalk to us