React to a message with an emoji, or remove the 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.
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.
bearerAuthAuthorizationBearer <nfy_live_<32 characters>>An API key from Settings > API keys, sent as Authorization: Bearer <key>.
id*stringThe message id.
1 <= length <= 64Idempotency-Key?stringAny string up to 255 characters. A repeat with the same key and body answers the stored response; with another body, 409 idempotency_key_reused.
length <= 255application/json- body
The business's reaction to a message.
emoji*stringOne emoji, such as "👍". It replaces the business's previous reaction to the message. An empty string removes it.
length <= 64The message, with its business_reaction.
application/json- response
A WhatsApp message, inbound or outbound.
object*stringid*string1 <= length <= 64conversation_id*string1 <= length <= 64contact_id*string1 <= length <= 64number_id*stringThe business number the message was sent from or received on.
1 <= length <= 64direction*string"inbound""outbound"type*|stringstatus*stringpending (Meta did not acknowledge it yet), sent, delivered, read or failed. A send answers sent or failed.
"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*|nullwhatsapp_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*stringmeta when the send was dispatched to WhatsApp. simulated when WhatsAble answered it in this process and did not call WhatsApp.
"meta""simulated"error*|Why the message failed. Null unless status is failed.
created_at*stringdate-timedelivered_at*|nullread_at*|nulledited_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*|nullunverified_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*|nullforwarded*booleanTrue when WhatsApp marked the message as forwarded.
frequently_forwarded*booleanTrue 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.
curl -X POST 'https://api.whatsable.app/v1/messages/string/reaction' \ -H 'Content-Type: application/json' \ -d '{ "emoji": "👍"}'{ "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}Mark an AI message's unverified figures as checked POST
Marks the unverified figures of an AI message as checked, as the inbox does: `figures_checked_at` is set and the conversation's `figures_to_check` goes down by one. Calling it on a message already checked is safe and changes nothing.
Download a message's media file GET
Downloads the file of a message, from the link in its `media.url`. The link needs no API key, because its signature is the credential. It expires after 15 minutes. An expired, changed or broken link gets the same 404 as a deleted file.