How do I send a WhatsApp message?
Use POST /api/v2/chat for text, media, and interactive chat messages, or POST /api/v2/send for approved template sends.
Understand the Whats91-specific message sending endpoints for templates, chat messages, media, buttons, and lists.
Messaging Overview
Summary
Use Messaging APIs for Whats91-specific send and chat endpoints, including templates, text messages, media messages, and interactive WhatsApp messages.
Prerequisites
- Bearer token authentication
- A connected sender
- Approved templates for business-initiated template sends
The Messaging section documents the Whats91 project-specific public API shape. Use POST /api/v2/send for approved template sends, and POST /api/v2/chat for session/chat messages such as text, media, quick reply buttons, and list messages.
Endpoints
| Method and path | Use for | Content types |
|---|---|---|
| POST /api/v2/send | Approved WhatsApp template sends using Whats91 field names and aliases. | application/json, multipart/form-data |
| POST /api/v2/chat | Free-form customer service window chat messages: text, media, buttons, and lists. | application/json, multipart/form-data |
Authentication and Sender Selection
Send Authorization: Bearer w91_live_xxxxxxxxxxxxxxxxx in the request headers. JSON and multipart requests can also include authToken, auth_token, or token when a client cannot send headers.
senderId is the WhatsApp registered sender phone number. It is optional when the public token resolves a default sender, and number-scoped tokens can only send from their assigned sender.
Multipart media uploads on these Whats91-specific endpoints have a 16 MB upload limit. Use the Chat Media page for supported upload extensions and media field aliases.
Common Response
Successful sends return data.messageId, data.status, data.senderId, data.phoneNumberId, data.receiverId, and metadata.requestId.
Success response
{
"success": true,
"data": {
"messageId": "wamid.HBgMOTE4ODg4ODg4ODg4FQIAERgSMzA2N0Q3...",
"status": "sent",
"senderId": "919999999999",
"phoneNumberId": "1234567890",
"receiverId": "918888888888"
},
"metadata": {
"apiVersion": "v2",
"requestId": "request-uuid"
}
}When a sender is temporarily reconnecting, Whats91 can accept the request and return queued: true with queueUid and reportUid so delivery can continue after the sender reconnects.
Frequently Asked Questions
What message types are supported?
Whats91 supports template sends, text chat, media chat, and interactive messages such as buttons, CTA, and list responses.
How do I track delivery?
Use Webhooks and Reports to track accepted, sent, delivered, read, failed, and queued message states.