Send a reaction

Reacts to a message the customer sent you, with a single emoji. Needs an open 24-hour window.

Example

curl -X POST "$HELLO_API_URL/v1/<your-phone-number-id>/messages" \
  -H "Authorization: Bearer $HELLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919999999999",
    "type": "reaction",
    "reaction": {
      "message_id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAEhggQzY4RUEzNzBBOEVBNDQ1QjhBRjc5RUY4RUFCNUIwQzQA",
      "emoji": "👍"
    }
  }'

Remove a reaction

Send the same request with emoji as an empty string.

Response

202 Accepted (queued), or 200 with ?sync=true once WhatsApp accepts it. See Send a message.

Fields

Field	Type	Required	Description
`reaction.message_id`	string	Yes	The `wamid` of the message to react to. Must be a message in this conversation.
`reaction.emoji`	string	Yes	A single emoji, or `""` to remove a previous reaction

Common errors

Status	`code`	Cause
`403`	`OUTSIDE_24H_WINDOW`	The recipient’s 24-hour window is closed
`400`	`VALIDATION_ERROR`	`reaction` is missing or the wrong shape
`422`	`SEND_FAILED`	(`?sync=true` only) `message_id` isn’t a real, reachable `wamid`, or `emoji` isn’t a single emoji