Emoji reaction

Adds an emoji reaction to an existing WhatsApp message. Emoji reactions are ideal for lightweight acknowledgements without sending a new message.

Common use cases:

Confirming receipt of a message
Acknowledging user input
Quick positive or negative feedback
Conversational UX in automated flows

URL


https://api.messagesmart.nl/api/v1/whatsapp/messages/emoji

Headers

See Authentication.

Request body

Field	Type	Required	Notes
whatsAppBusinessId	string	Yes	Can be collected from the dashboard or provided via webhook
whatsAppBusinessPhoneNumberId	string	Yes	Can be collected from the dashboard or provided via webhook
to	string	Yes	Recipient phone number in E.164 format
messageId	string	Yes	WhatsApp message ID to react to
emoji	string	Yes	Emoji to react with (e.g. 👍 ❤️ 😂)

Examples

JSON


{
  "whatsAppBusinessId": "123456789012345",
  "whatsAppBusinessPhoneNumberId": "399750423212934",
  "to": "+31622463691",
  "messageId": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA",
  "emoji": "👍"
}

cURL


curl -X POST "https://api.messagesmart.nl/api/v1/whatsapp/messages/emoji" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsAppBusinessId": "123456789012345",
    "whatsAppBusinessPhoneNumberId": "399750423212934",
    "to": "+31622463691",
    "messageId": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA",
    "emoji": "👍"
  }'

Node.js


const response = await fetch(
  "https://api.messagesmart.nl/api/v1/whatsapp/messages/emoji",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MESSAGESMART_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      whatsAppBusinessId: "123456789012345",
      whatsAppBusinessPhoneNumberId: "399750423212934",
      to: "+31622463691",
      messageId:
        "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA",
      emoji: "👍",
    }),
  }
);
 
const json = await response.json();
console.log(json);
 
if (!json.success) {
  throw new Error(`${json.error.code}: ${json.error.message}`);
}

Response

Success (200 OK)


{
  "success": true,
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [
      {
        "input": "+31622463691",
        "wa_id": "31622463691"
      }
    ],
    "messages": [
      {
        "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
      }
    ]
  }
}

Notes

Emoji reactions do not create a new message thread.
The messageId must refer to an existing message in the conversation.

Validation error (400 Bad Request)


{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "Invalid request body",
    "httpStatus": 400,
    "details": null
  }
}

Common causes:

Missing messageId
Missing or invalid emoji
Missing WhatsApp business identifiers

Provider error (502 Bad Gateway)


{
  "success": false,
  "error": {
    "code": "WHATSAPP_SEND_FAILED",
    "message": "Failed to send WhatsApp emoji reaction.",
    "httpStatus": 502,
    "details": {
      "provider": "meta",
      "raw": {}
    }
  }
}