Skip to navigation

WhatsApp Template Message

Send a pre-approved WhatsApp Message Template (MTM) with body variables.

Authentication

All requests require an apiKey header containing your Conversive API key.

apiKey: <YOUR_API_KEY>

Pass the API key as a request header named apiKey, not as a Bearer token in the Authorization header.

Request

POST
/api/v2/message/send
curl -X POST https://api.beconversive.com/api/v2/message/send \
-H "apiKey: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"userPayload": {
"type": "api",
"apiKey": "YOUR_API_KEY"
},
"messageDetails": [
{
"recipient": [
{
"channelType": "whatsapp",
"phone": "RECIPIENT_PHONE"
}
],
"sender": {
"channelType": "whatsapp",
"phone": "SENDER_PHONE"
},
"source": "YOUR_SOURCE_ID",
"messageId": "UNIQUE_MESSAGE_ID",
"message": {
"type": "template",
"content": {
"messageText": "Sample Tempalte message ${contact.email} ${contact.phone}",
"template": {
"components": [
{
"parameters": [
{
"type": "text",
"value": "CONTACT_EMAIL"
},
{
"type": "text",
"value": "CONTACT_PHONE"
}
],
"type": "body"
}
],
"language": {
"code": "en",
"policy": "deterministic"
},
"name": "whatsapp_template_name"
}
}
}
}
]
}'

Request

userPayloadobjectRequired
messageDetailslist of objectsRequired

Response

Response

responseobjectOptional

Errors

Status CodeMeaning
400Bad Request — missing or invalid parameters
401Unauthorized — invalid or missing API key
403Forbidden — insufficient permissions
404Not Found — endpoint or resource not found
429Too Many Requests — rate limit exceeded
500Internal Server Error — contact support