Messages

Send an audio message

Sends an audio clip to a WUTS-connected WhatsApp recipient. The audio may be supplied as base64 or downloaded from a URL and is transcoded to the WhatsApp Opus format. Supports push-to-talk (voice note) mode, view-once delivery, mentions, and quoted replies. Large clips may be processed asynchronously, returning 202 with a job id.

POST
/send/audio

Sends an audio clip to a WUTS-connected WhatsApp recipient. The audio may be supplied as base64 or downloaded from a URL and is transcoded to the WhatsApp Opus format. Supports push-to-talk (voice note) mode, view-once delivery, mentions, and quoted replies. Large clips may be processed asynchronously, returning 202 with a job id.

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

application/json

curl -X POST "https://example.com/send/audio" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "audio_url": "https://cdn.example.com/voice/greeting.mp3",    "ptt": true,    "delay": 0  }'
{  "success": true,  "message_id": "3EB0XXXX2C3D4E5F6A7B",  "timestamp": "2026-06-15T14:25:40Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net",  "metadata": {    "device_id": "device-7f3a",    "user_id": "usr_01H9",    "processing_time_ms": 1750,    "audio_size_bytes": 96000,    "audio_format": "audio/ogg; codecs=opus",    "audio_duration_seconds": 12,    "conversion_time_ms": 320,    "download_time_ms": 180,    "upload_time_ms": 410,    "mentions_processed": 0,    "quoted_message_found": false,    "ptt_enabled": true,    "conversion_applied": true,    "original_format": "audio/mpeg",    "sent_at": "2026-06-15T14:25:40Z",    "waveform_generated": true,    "async_processing": false  }}
{  "success": true,  "timestamp": "2026-06-15T14:25:40Z",  "status": "processing",  "chat_jid": "5511999999999@s.whatsapp.net",  "job_id": "job_e5f6a7b8",  "metadata": {    "device_id": "device-7f3a",    "user_id": "usr_01H9",    "async_processing": true,    "sent_at": "2026-06-15T14:25:40Z"  }}
{  "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"}

Request message retransmission POST

Sends a WhatsApp retry receipt for one or more messages, asking the sender device to retransmit content the WUTS gateway could not decrypt. When message_ids is omitted, the message id from the path is used.

Send a quick-reply buttons message POST

Sends a WhatsApp message carrying up to three native quick-reply buttons through the authenticated WUTS device session. WUTS wraps the buttons payload with the interactive business nodes required for the buttons to render on the recipient's device.