Messages

React to a message with an emoji, or remove the reaction

posthttps://api.whatsable.app/v1/messages/{id}/reaction
Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

Request
curl -X POST 'https://api.whatsable.app/v1/messages/string/reaction' \
  -H 'Content-Type: application/json' \
  -d '{
  "emoji": "👍"
}'

Sets the business's emoji reaction to a message, as the reaction picker does in the inbox. { "emoji": "" } removes it.

A reaction needs an open 24-hour window. Outside it, the call answers 422 session_window_closed.

A new emoji replaces the business's previous reaction, wherever it was set. A message that was withdrawn, that WhatsApp never accepted, or that WhatsApp has not accepted yet (status pending), answers 422 message_not_reactable.

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Path Parameters

id*string

The message id.

Length1 <= length <= 64

Header Parameters

Idempotency-Key?string

Any string up to 255 characters. A repeat with the same key and body answers the stored response; with another body, 409 idempotency_key_reused.

Lengthlength <= 255

Request Body

application/json
  1. body

The business's reaction to a message.

emoji*string

One emoji, such as "👍". It replaces the business's previous reaction to the message. An empty string removes it.

Lengthlength <= 64

Response Body

The message, with its business_reaction.

application/json
  1. response

A WhatsApp message, inbound or outbound.

object*string
id*string
Length1 <= length <= 64
conversation_id*string
Length1 <= length <= 64
contact_id*string
Length1 <= length <= 64
number_id*string

The business number the message was sent from or received on.

Length1 <= length <= 64
direction*string
Value in"inbound""outbound"
type*|string
status*string

pending (Meta did not acknowledge it yet), sent, delivered, read or failed. A send answers sent or failed.

Value in"pending""sent""delivered""read""failed"
sent_by*||

Who sent an outbound message. Null on inbound.

to*|

The recipient of an outbound message. Null on inbound.

from*|

The sender of an inbound message. Null on outbound.

text*|

The text, a caption, or the body of a template or buttons message.

template*|

The template a template message used. Null otherwise.

media*|null
whatsapp_message_id*|

Meta's message id (wamid) when transport is meta. A simulated send stores an id minted here, starting with simulated.. Null when no id was recorded.

transport*string

meta when the send was dispatched to WhatsApp. simulated when WhatsAble answered it in this process and did not call WhatsApp.

Value in"meta""simulated"
error*|

Why the message failed. Null unless status is failed.

created_at*string
Formatdate-time
delivered_at*|null
read_at*|null
edited_at*|

When the message was edited after it was sent: by the customer for an inbound message, or from the WhatsApp Business app for an outbound one. text holds the current wording.

deleted_at*|

When the message was deleted after it was sent: by the customer for an inbound message, or from the WhatsApp Business app for an outbound one. Its text is kept.

revisions*array<>

The earlier wordings of an edited message, oldest first. Empty when it was never edited.

referral*|

Meta's Click-to-WhatsApp referral object as Meta sent it, with keys such as ctwa_clid. Set only on the inbound message that started a chat from an ad or a post.

button_reply*|null
unverified_figures*array<string>

Figures in an AI-written message that nothing in the agent's knowledge, files, the customer's own messages or its instructions contains. The message was sent; a person can review them in the inbox. Empty for every other message.

figures_checked_at*|

When those figures were marked as checked, in the inbox or through the API; null until then.

reply_to*|

The message this one quotes, as a reply in WhatsApp. Null when it quotes none.

reactions*array<>

The customer's emoji reactions to this message, by their last change, oldest first. Empty when there are none. The business's own reaction is business_reaction.

business_reaction*|null
forwarded*boolean

True when WhatsApp marked the message as forwarded.

frequently_forwarded*boolean

True when WhatsApp marked it as forwarded many times (shown as "Forwarded many times" in WhatsApp).

is_voice_note*|

On an audio message: true for a recorded voice note, false for an audio file the person attached. Null on every other type, and on audio when WhatsApp did not say.

Example Request
curl -X POST 'https://api.whatsable.app/v1/messages/string/reaction' \  -H 'Content-Type: application/json' \  -d '{  "emoji": "👍"}'
Example Response
{  "object": "message",  "id": "cm2v8m1a00001qz8h0p1q2r3s",  "conversation_id": "cm2v8c1a00001qz8h4t5u6v7w",  "contact_id": "cm2v8k1a00001qz8h8x9y0z1a",  "number_id": "cm2v8a1b20002qz8h9i0j1k2l",  "direction": "outbound",  "type": "template",  "status": "sent",  "sent_by": "api",  "to": {    "phone": "+5491155550000",    "wa_user_id": null,    "username": null  },  "from": null,  "text": "Hi Ana, your order #1042 is on its way.",  "template": {    "id": "cm2v8t1a00001qz8habcd1234",    "name": "order_shipped",    "language": "en_US"  },  "media": null,  "whatsapp_message_id": "wamid.HBgMNTQ5MTE1NTU1MDAwMBUCABEYEjQ",  "transport": "meta",  "error": null,  "created_at": "2026-10-20T19:51:21Z",  "delivered_at": null,  "read_at": null,  "edited_at": null,  "deleted_at": null,  "referral": null,  "button_reply": null,  "unverified_figures": [],  "figures_checked_at": null,  "reply_to": null,  "reactions": [],  "business_reaction": null,  "revisions": [],  "forwarded": false,  "frequently_forwarded": false,  "is_voice_note": null}