Skip to navigation

WhatsApp Text Message

Send a plain-text WhatsApp message to a recipient.

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": "74785939"
}
],
"sender": {
"channelType": "whatsapp",
"phone": "858493494"
},
"source": 8001,
"messageId": "wa-001",
"message": {
"type": "text",
"content": {
"messageText": "WhatsApp text message"
}
}
}
]
}'

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

Common WhatsApp errors

CodeMeaningSuggested fix
100Request contains unsupported or misspelled parametersCheck field names and length limits
131008A required parameter is missingCheck that all required fields are present
131009One or more parameter values are invalidValidate values such as phone number format
131021Sender and recipient numbers are the sameSend to a different recipient
131026Message undeliverable: recipient may not be on WhatsApp, may not have accepted the latest Terms of Service, or may be on an outdated app versionAsk the recipient to confirm they can message your number and update WhatsApp
130403Your business has blocked this user on WhatsAppDo not retry; unblock the user to resume messaging
130429Cloud API throughput limit reachedRetry later or reduce sending rate
131048Sending restricted because too many earlier messages were blocked or flagged as spamCheck your quality rating in WhatsApp Manager
131056Too many messages to the same recipient in a short periodWait before retrying; other recipients are unaffected
131064Messaging limit reached due to template classification violations (affects template and non-template messages)Correct template categories; restriction lifts after the enforcement period
368 / 131031WhatsApp Business Account restricted or disabled for a policy violationReview Meta’s Policy Enforcement guidelines
130497Account cannot message users in certain countriesCheck allowed countries for your business category
131042Payment method errorVerify WhatsApp Business billing setup
131045Sender number registration errorRegister the sender phone number
133010Sender number not registered on the WhatsApp Business PlatformRegister the sender phone number
131057Business account is in maintenance modeRetry after a few minutes
1 / 2 / 131000 / 131016Invalid request, server error, downtime, or temporary service outageCheck the WhatsApp Business Platform Status page, then retry

WhatsApp Text Message and WhatsApp Media Message: Session message errors

CodeMeaningSuggested fix
131047More than 24 hours since the recipient last repliedSend a template message instead
131051Message type not supportedUse a supported message type

WhatsApp Media Message and WhatsApp Media Template: Media errors

CodeMeaningSuggested fix
131053Media could not be uploaded (e.g. unsupported media type)Confirm the file’s MIME type is supported and the URL is publicly accessible

WhatsApp Template Message and WhatsApp Media Template: Template errors

CodeMeaningSuggested fix
132000Number of variable values doesn’t match the template’s variablesSend one value for each template variable
132001Template not found in the given language, or not approvedCheck template name, language.code, and approval status
132005Translated text is too longCheck the template translation in WhatsApp Manager
132007Template content violates WhatsApp policyReview and revise the template content
132012Variable values don’t match the format defined in the templateMatch each parameter type to the template (e.g. image for an image header)
132015Template paused due to low qualityEdit the template and resend once re-approved
132016Template permanently disabled after repeated pausesCreate a new template with different content
131049Not delivered due to per-user marketing message limitsWait at least 24 hours before resending
131050Recipient has opted out of your marketing messagesDo not retry
131063Marketing templates are disabled for this Cloud API configurationUse the Marketing Messages API or re-enable marketing templates