Reactions
How to send a reaction (emoji) to a specific WhatsApp message using the WhatsApp Cloud API, and how to remove a reaction.
On this page
A reaction message adds an emoji reaction to a specific message in a conversation, just like
long-pressing a message in WhatsApp and picking an emoji. You can also remove an existing
reaction by sending an empty emoji. You must provide the message_id (wamid) of the message
you want to react to.
Add a reaction#
{
"messaging_product": "whatsapp",
"to": "919959623255",
"type": "reaction",
"reaction": {
"message_id": "wamid.HBgMOTE5OTU5NjIzMjU1...",
"emoji": "👍"
}
}Remove a reaction#
Send the same request with an empty string for emoji:
{
"messaging_product": "whatsapp",
"to": "919959623255",
"type": "reaction",
"reaction": {
"message_id": "wamid.HBgMOTE5OTU5NjIzMjU1...",
"emoji": ""
}
}Fields#
| Field | Required | Description |
|---|---|---|
reaction.message_id | yes | The wamid of the message to react to |
reaction.emoji | yes | Any single Unicode emoji. Empty string removes the reaction. |
Reference image#
Frequently asked#
How do I react to a WhatsApp message with an emoji?
Set type to "reaction", provide the message_id (wamid) of the message you want to
react to, and the emoji character in reaction.emoji.
How do I remove a reaction?
Send the same reaction message with "emoji": "" (empty string).
Where do I get the message_id to react to?
From the API response when the message was sent (messages[0].id), or from the webhook
payload when the message was received.
Can I react to any message in the conversation?
You can react to messages within the 24-hour customer service window. Reactions to very old messages may fail.
Gotchas & common mistakes#
Was this page helpful?
Still stuck? Open a support ticket and our team will help.