PrivacidadeTermos
Messages

Send a one-time password (OTP) copy-code button message

Sends a WhatsApp message carrying a single copy-code button. When the recipient taps it, the one-time password in `code` is copied to their clipboard. An optional image header is supported (remote URL or base64). WUTS attaches the native-flow business nodes required for the button to render on the recipient's device.

POST
/send/button-otp

Sends a WhatsApp message carrying a single copy-code button. When the recipient taps it, the one-time password in code is copied to their clipboard. An optional image header is supported (remote URL or base64). WUTS attaches the native-flow business nodes required for the button to render on the recipient's device.

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/button-otp" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "message": "Your verification code is ready. Tap the button to copy it.",    "code": "123456",    "buttonText": "Copiar código",    "footer": "Valid for 10 minutes"  }'
{  "success": true,  "message_id": "3EB0XXXXOTP1234567890ABCD",  "timestamp": "2026-06-19T14:32:10Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net",  "message": "OTP button message sent successfully"}
{  "error": "Invalid recipient: empty input"}
{  "error": "unauthorized"}
{  "error": "failed to upload header image: timeout"}
{  "error": "WhatsApp device is not connected"}

Send an audio message POST

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.

Send a PIX payment card (copy/pay button) message POST

Sends a WhatsApp message carrying a native PIX payment card. The recipient sees the merchant name and PIX key and can copy or pay it directly via the native pay button. The `keyType` is the PIX key type (`CPF`, `CNPJ`, `PHONE`, `EMAIL`, or `EVP`). An optional `amount` (BRL) sets the charge value; absent or `0` renders a static "any amount" code. WUTS attaches the payment business nodes required for the card to render and be delivered on the recipient's device.