React to messages

Send a reaction through the same Meta-style messages endpoint used for other outbound WhatsApp messages. The target must be an inbound customer message owned by the WhatsApp number in the URL.

cURL

curl -X POST \
  https://api.kirimdev.com/v1/$PHONE_ID/messages \
  -H "Authorization: Bearer $KIRIM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "15551234567",
    "type": "reaction",
    "reaction": {
      "message_id": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA",
      "emoji": "👍"
    }
  }'

TypeScript SDK

import { Kirim } from '@kirimdev/sdk'

const kirim = new Kirim({ apiKey: process.env.KIRIM_KEY! })
const phone = kirim.phoneNumbers(process.env.PHONE_ID!)

await phone.messages.send({
  messaging_product: 'whatsapp',
  to: '15551234567',
  type: 'reaction',
  reaction: {
    message_id: 'wamid.HBgN...',
    emoji: '👍',
  },
})

Note

reaction.message_id is the Meta-native wamid from the inbound message.received webhook, not a Kirimdev msg_* resource ID. The to number (or recipient BSUID) must identify the same contact that sent the target message.

Remove a reaction

Send the same request with an empty emoji string:

{
  "messaging_product": "whatsapp",
  "to": "15551234567",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgN...",
    "emoji": ""
  }
}

Response

{
  "data": {
    "id": "msg_01HXYZABCDEFGHJKMNPQRSTVWX",
    "object": "message",
    "to": "+15551234567",
    "type": "reaction",
    "status": "pending",
    "reaction": {
      "message_id": "wamid.HBgN...",
      "emoji": "👍"
    },
    "created_at": "2026-09-08T09:00:00.000Z"
  },
  "request_id": "req_01HXYZABCDEFGHJKMNPQRSTVWX"
}

The returned id identifies the target inbound message. Reaction delivery is queued; Meta sends only a sent status for reactions and does not send the usual delivered or read statuses.

Restrictions

• The target must be an inbound customer message, not an outbound message or another reaction.
• Meta rejects reactions to messages older than 30 days or messages that were deleted.
• Only one business reaction is retained per target message. Sending another emoji replaces it.
• Send an empty emoji to remove the business reaction.

See also

• Receive messages - obtain the target wamid and receive customer reactions
• API reference - Send a WhatsApp message