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
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 Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameters |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — insufficient permissions |
| 404 | Not Found — endpoint or resource not found |
| 429 | Too Many Requests — rate limit exceeded |
| 500 | Internal Server Error — contact support |
Common WhatsApp errors
| Code | Meaning | Suggested fix |
|---|---|---|
| 100 | Request contains unsupported or misspelled parameters | Check field names and length limits |
| 131008 | A required parameter is missing | Check that all required fields are present |
| 131009 | One or more parameter values are invalid | Validate values such as phone number format |
| 131021 | Sender and recipient numbers are the same | Send to a different recipient |
| 131026 | Message undeliverable: recipient may not be on WhatsApp, may not have accepted the latest Terms of Service, or may be on an outdated app version | Ask the recipient to confirm they can message your number and update WhatsApp |
| 130403 | Your business has blocked this user on WhatsApp | Do not retry; unblock the user to resume messaging |
| 130429 | Cloud API throughput limit reached | Retry later or reduce sending rate |
| 131048 | Sending restricted because too many earlier messages were blocked or flagged as spam | Check your quality rating in WhatsApp Manager |
| 131056 | Too many messages to the same recipient in a short period | Wait before retrying; other recipients are unaffected |
| 131064 | Messaging limit reached due to template classification violations (affects template and non-template messages) | Correct template categories; restriction lifts after the enforcement period |
| 368 / 131031 | WhatsApp Business Account restricted or disabled for a policy violation | Review Meta’s Policy Enforcement guidelines |
| 130497 | Account cannot message users in certain countries | Check allowed countries for your business category |
| 131042 | Payment method error | Verify WhatsApp Business billing setup |
| 131045 | Sender number registration error | Register the sender phone number |
| 133010 | Sender number not registered on the WhatsApp Business Platform | Register the sender phone number |
| 131057 | Business account is in maintenance mode | Retry after a few minutes |
| 1 / 2 / 131000 / 131016 | Invalid request, server error, downtime, or temporary service outage | Check the WhatsApp Business Platform Status page, then retry |
WhatsApp Text Message and WhatsApp Media Message: Session message errors
| Code | Meaning | Suggested fix |
|---|---|---|
| 131047 | More than 24 hours since the recipient last replied | Send a template message instead |
| 131051 | Message type not supported | Use a supported message type |
WhatsApp Media Message and WhatsApp Media Template: Media errors
| Code | Meaning | Suggested fix |
|---|---|---|
| 131053 | Media 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
| Code | Meaning | Suggested fix |
|---|---|---|
| 132000 | Number of variable values doesn’t match the template’s variables | Send one value for each template variable |
| 132001 | Template not found in the given language, or not approved | Check template name, language.code, and approval status |
| 132005 | Translated text is too long | Check the template translation in WhatsApp Manager |
| 132007 | Template content violates WhatsApp policy | Review and revise the template content |
| 132012 | Variable values don’t match the format defined in the template | Match each parameter type to the template (e.g. image for an image header) |
| 132015 | Template paused due to low quality | Edit the template and resend once re-approved |
| 132016 | Template permanently disabled after repeated pauses | Create a new template with different content |
| 131049 | Not delivered due to per-user marketing message limits | Wait at least 24 hours before resending |
| 131050 | Recipient has opted out of your marketing messages | Do not retry |
| 131063 | Marketing templates are disabled for this Cloud API configuration | Use the Marketing Messages API or re-enable marketing templates |
