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).
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 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"}Send a poll message POST
Sends a WhatsApp poll with a question and between 2 and 12 options through the authenticated WUTS device session. When allow_multiple_answers is true, recipients may select every option; otherwise the poll is single-choice. WUTS generates the poll message secret automatically.
Send a PTV (round video note) POST
Sends a PTV — a round "video note" that plays inside a circle, without caption. Supply the video as base64 or an HTTP(S) URL; non-MP4 sources are converted to MP4 automatically. For best results use a short (≤60s), ideally square clip. Replies are supported via 'quoted'. Migration-friendly field aliases are accepted: 'phone' (→number), 'ptv' (→videoUrl when it is an http URL, otherwise →video), and 'delayMessage' (→delay).