Messages

Send a product message

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).

POST
/send/product

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).

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/product" \  -H "Content-Type: application/json" \  -d '{    "number": "5511999999999",    "business_owner_jid": "5511988887777@s.whatsapp.net",    "product": {      "product_id": "9876543210",      "title": "Camiseta WUTS",      "description": "Camiseta 100% algodao",      "currency_code": "BRL",      "price_amount_1000": 49900,      "sale_price_amount_1000": 39900,      "retailer_id": "SKU-WUTS-001",      "url": "https://shop.example.com/camiseta-wuts",      "product_image_url": "https://shop.example.com/img/camiseta.jpg",      "product_image_count": 1    },    "body": "Confira nosso lancamento",    "footer": "Loja WUTS",    "delay": 0  }'
{  "success": true,  "message_id": "3EB0X2B1C0D9E8F7A6",  "timestamp": "2026-06-15T12:00:00Z",  "status": "sent",  "chat_jid": "5511999999999@s.whatsapp.net"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z",  "validation": [    {      "field": "product.title",      "message": "title is required"    }  ]}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "failed to upload product image: timeout",  "error_code": "UPLOAD_FAILED",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "failed to send product message: rate-overlimit",  "error_code": "SEND_FAILED",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "whatsapp session is not connected",  "error_code": "DEVICE_DISCONNECTED",  "timestamp": "2026-06-15T12:00:00Z"}