PrivacidadeTermos
Status

Send a text status

Publishes a text status (story) to the connected WUTS WhatsApp session. The text is rendered on a colored card and delivered to the Status broadcast channel, visible according to the session's status privacy rules. Provide the body in 'message'; optional backgroundColor, textColor and font style the card.

POST
/send-text-status

Publishes a text status (story) to the connected WUTS WhatsApp session. The text is rendered on a colored card and delivered to the Status broadcast channel, visible according to the session's status privacy rules. Provide the body in 'message'; optional backgroundColor, textColor and font style the card.

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.

Text status payload. Provide the body in 'message' (preferred); 'text' is accepted as a legacy alias. When no backgroundColor is given a default opaque background is applied so the status renders correctly.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/send-text-status" \  -H "Content-Type: application/json" \  -d '{    "message": "We are open today from 9am to 6pm. Reply here for support.",    "backgroundColor": "#1F8C4D",    "font": "bold"  }'
{  "success": true,  "message_id": "3EB0XXXX1234567890ABCDEF",  "zaapId": "3EB0XXXX1234567890ABCDEF",  "id": "3EB0XXXX1234567890ABCDEF",  "timestamp": "2026-06-21T14:32:05-03:00",  "status_type": "text"}
{  "success": false,  "error": {    "code": "invalid_request",    "message": "message cannot be empty"  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": {    "code": "device_error",    "message": "failed to resolve user device"  }}
{  "success": false,  "error": {    "code": "status_failed",    "message": "failed to send status broadcast"  }}
{  "success": false,  "error": {    "code": "device_disconnected",    "message": "whatsapp session is not connected"  }}
{  "success": false,  "error": {    "code": "status_timeout",    "message": "context deadline exceeded"  }}

Send an image status POST

Uploads and publishes an image status (story) through the connected WUTS WhatsApp session. Provide the image as a URL or base64. An optional caption is shown beneath the image.

Send a video status POST

Uploads and publishes a video status (story) through the connected WUTS WhatsApp session. Provide the video as a URL or base64. Keep videos small (~10MB) for status. An optional caption is shown beneath the video.