Messages

React to a message with an emoji

Adds (or, with an empty reaction, removes) an emoji reaction on a previously delivered message in a WUTS-connected chat or group. For group reactions to messages from other participants, the original author's participant JID is required.

POST
/send/reaction

Adds (or, with an empty reaction, removes) an emoji reaction on a previously delivered message in a WUTS-connected chat or group. For group reactions to messages from other participants, the original author's participant JID is required.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/send/reaction" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "messageId": "3EB0XXXX1234ABCD",    "reaction": "👍",    "fromMe": false  }'
{  "success": true,  "message_id": "3EB0XXXXAAAA5678",  "timestamp": "2026-06-15T14:32:00Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net",  "metadata": {    "device_id": "dev_abc123",    "user_id": "usr_456",    "processing_time_ms": 95,    "original_message_id": "3EB0XXXX1234ABCD",    "reaction_emoji": "👍",    "sent_at": "2026-06-15T14:32:00Z"  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Send a product message POST

Sends a single catalog product card to a WhatsApp recipient through WUTS. The product snapshot (id and title required) is enriched with optional price, currency, description, and image (base64 or remote URL, which WUTS uploads to WhatsApp media).

Send a sticker message POST

Sends a WebP sticker to a WUTS-connected WhatsApp recipient. The sticker may be supplied as base64 or downloaded from a URL, must be in WebP format, and is capped at 500KB. Animated stickers are auto-detected or flagged explicitly.