— WhatsApp quickstart
Send your first WhatsApp message
Outside a live conversation, WhatsApp sends approved templates. Name the template, set the language, and fill its variables; the response returns a WhatsApp message ID you reconcile against delivery and read receipts on your webhook.
Send a template message
Authenticate with your bearer token and POST to /whatsapp/messages. The recipient must have opted in, and the template must be approved — we handle approval with you. Media, buttons, and list messages are fields on the same call.
curl https://api.smsapi.in/v1/whatsapp/messages \
-H "Authorization: Bearer $SMSAPI_KEY" -H "Content-Type: application/json" \
-d '{
"to": "+919876543210",
"type": "template",
"template": {
"name": "order_shipped",
"language": "en",
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "AWB123456" }] }
]
}
}'
# -> { "message_id": "wamid.HBg...", "status": "accepted" }Request shapes are representative pending the white-label telco API spec (FLAGS_AND_ASSUMPTIONS.md).
Next steps
- — Get your templates approved in the right category.
- — Handle inbound replies and button taps on your webhook within the 24-hour window.
- — Read the WhatsApp Business API overview for broadcasts and pricing.