post
https://apis.rmlconnect.net/callbacks
Client Callback APIs allow you to receive real-time notifications (callbacks) for events that occur on your WhatsApp Business account. These callbacks are triggered by events that occur on the WhatsApp server, and are delivered to a URL that you specify in your webhook configuration.
For more information, see the Route Mobile WhatsApp OpenAPI Specifications.
Callback Error Codes
| Code | Text | Description |
|---|---|---|
| 400 | Media download error | There was an error while downloading media. |
| 401 | Group does not exist | The specified group does not exist. |
| 402 | Others | An unspecified error occurred. |
| 403 | Error code for blacklisting | The given number is blacklisted. |
| 408 | Message is not valid | The message is not valid or malformed. |
| 410 | Message expired | The message has expired and cannot be delivered. |
| 429 | Rate limit hit | The rate limit for API calls has been reached. |
| 430 - 433 | Others | Unspecified errors occurred. |
| 470 | Re-engagement message | The message is a re-engagement message. |
| 471 | Spam Rate limit | The rate limit for sending spam messages has been reached. |
| 472 | User's number is part of an experiment | The user's number is part of an experiment and cannot be used. |
| 500 | Unknown Error | An unknown or unexpected error occurred. |
| 1000 | Others | Unspecified errors occurred. |
| 1001 | Message too long | The message exceeds the maximum length allowed. |
| 1002 | Invalid recipient type | The recipient type specified is not valid. |
| 1003 | Not a group participant | The user is not a participant of the group. |
| 1004 | Resource already exists | The resource being created already exists. |
| 1005-1006 | Others | Unspecified errors occurred. |
| 1008 | Required parameter is missing | A required parameter for the API call is missing. |
| 1009 | Parameter value is not valid | The value provided for a parameter is not valid. |
| 1010 | Parameter is not required | A parameter that was provided is not required for the API call. |
| 1011-1011 | Others | Unspecified errors occurred. |
| 1012 | Group is unknown | The specified group is unknown. |
| 1013 | User is not valid | The specified user is not valid. |
| 1014 | Corrupt Image | The image provided is corrupt or invalid. |
| 1015-1018 | Others | Unspecified errors occurred. |
| 1019 | Not a group admin | The user is not an admin of the group. |
| 1020 | Bad group | The specified group is invalid or bad. |
| 1021 | Bad User | The specified user is invalid or bad. |
| 1022-1024 | Others | Unspecified errors occurred. |
| 1025 | Invalid Request | The API request is invalid. |
| 1026 | Receiver Incapable | The receiver is incapable of receiving the message. |
| 2000 | Template Param Count Mismatch | The number of parameters provided for a template does not match the required count. |
| 2001 | Template Missing | The specified template does not exist. |
| 2002 | Template Fetch Failed | Failed to fetch the template. |
| 2003 | Template Pack Missing | The template pack is missing. |
| 2004 | Template Param Length Too Long | The length of a parameter in the template is too long. |
| 2005 | Template Hydrated Text Too Long | The length of the hydrated text in the template is too long. |
| 2006 | Template White Space Policy Violated | The template violates the white space policy. |
| 2007 | Template Format Character Policy Violated | The template violates the format character policy. |
| 2008 | Template Media Format Unsupported | The media format in the template is unsupported. |
| 2009 | Template Required Component Missing | A required component in the template is missing. |
| 2010 | Template Invalid Hydrated URL | The hydrated URL in the template is invalid. |
| 2011 | Template Invalid Phone Number | The phone number in the template is invalid. |
| 2012 | Template Parameter Format Mismatch | The format of a parameter in the template is mismatched. |
| 2013 | Template Buttons Unsupported | The buttons in the template are unsupported. |
| 0 | AuthException | An authentication exception occurred. |
| 3 | API Method | An error occurred with the API method. |
| 10 | Permission Denied | The user does not have the necessary permissions to perform the requested action. |
| 190 | Access token has expired | The access token used for authentication has expired. |
| 200-299 | API Permission | The API call requires specific permissions, and the user does not have them. |
| 4 | API Too Many Calls | The API call limit has been exceeded. |
| 80007 | Rate limit issues | There are issues with the rate limits for API calls. |
| 130429 | Rate limit hit | The rate limit for API calls has been reached. |
| 131048 | Spam rate limit hit | The rate limit for sending spam messages has been reached. |
| 131056 | (Business Account, Consumer Account) pair rate limit hit | The rate limit for a specific pair of business and consumer accounts has been reached. |
| 368 | Temporarily blocked for policy violations | The user or account has been temporarily blocked due to policy violations. |
| 131031 | Account has been locked | The user's account has been locked. |
| 1 | API Unknown | An unknown error occurred with the API. |
| 2 | API Service | An error occurred with the API service. |
| 33 | Parameter value is not valid | The value provided for a parameter is not valid. |
| 100 | Invalid parameter | The parameter specified in the API call is invalid. |
| 131000 | Something went wrong | An unspecified error occurred. |
| 131005 | Access denied | Access to the requested resource is denied. |
| 131008 | Required parameter is missing | A required parameter for the API call is missing. |
| 131009 | Parameter value is not valid | The value provided for a parameter is not valid. |
| 131016 | Service unavailable | The requested service is currently unavailable. |
| 131021 | Recipient cannot be sender | The recipient of the message cannot be the sender. |
| 131026 | Message Undeliverable | The message could not be delivered to the recipient. |
| 131042 | Business eligibility payment issue | There is an issue with the payment for business eligibility. |
| 131045 | Incorrect certificate | The certificate used for authentication is incorrect. |
| 131047 | Re-engagement message | The message is a re-engagement message. |
| 131051 | Unsupported message type | The message type is not supported. |
| 131052 | Media download error | There was an error while downloading media. |
| 131053 | Media upload error | There was an error while uploading media. |
| 132000 | Template Param Count Mismatch | The number of parameters provided for a template does not match the required count. |
| 132001 | Template does not exist | The specified template does not exist. |
| 132005 | Template Hydrated Text Too Long | The length of the hydrated text in the template is too long. |
| 132007 | Template Format Character Policy Violated | The template violates the format character policy. |
| 132012 | Template Parameter Format Mismatch | The format of a parameter in the template is mismatched. |
| 132015 | Template parameter invalid | The parameter in the template is invalid. |
| 133000 | Incomplete Deregistration | The deregistration process is incomplete. |
| 133004 | Server Temporarily Unavailable | The server is temporarily unavailable. |
| 133005 | Two-step verification PIN Mismatch | The two-step verification PIN provided does not match. |
| 133006 | Phone number re-verification needed | Phone number re-verification is required. |
| 133008 | Too Many two-step verification PIN Guesses | Too many incorrect guesses for the two-step verification PIN. |
| 133009 | Two-step verification PIN Guessed Too Fast | The two-step verification PIN was guessed too quickly. |
| 133010 | Phone number Not Registered | The phone number is not registered. |
| 135000 | Generic user error | A generic error occurred for the user. |
Template Status Logs
| Template Status | Logs |
|---|---|
| Template Approved | {"product": "whatsapp", "component": "whatsapp-callback-event-worker", "level": "debug", "timestamp": "2023-11-02 07:40:04.402735", "message": {"URL": "xxxxxxxxxxxxxxxxx", "data": {"statuses": [{"id": "xxxxxxxxxxxxxx", "template_name": "xxxxx", "template_id": xxxxxxxxxxxxxx, "template_language": "en", "reason": "NONE", "status": "APPROVED", "timestamp": xxxxxxxx, "type": "event", "information": null}], "brand_msisdn": "{phone}"}, "status": 200, "response_time": 0.0xxxxxxxxxxxxxx, "current_time": "xx:xx:xx.xxxxxx", "response": "{"success":true}"}} |
| Template Paused | {"product": "whatsapp", "component": "whatsapp-callback-event-worker", "level": "debug", "timestamp": "2023-11-02 07:37:58.285408", "message": {"URL": "xxxxxxxxxxxxxxxxxxxxx", "data": {"statuses": [{"id": "xxxxxxxxxxxxxxx", "template_name": "abc__1", "template_id": xxxxxxxxxxxxxxx, "template_language": "en", "reason": "NONE", "status": "PAUSED", "timestamp": xxxxxxxxxx, "type": "event", "information": {"title": "FIRST_PAUSE", "description": "Your WhatsApp message template has been paused for x hours until xxx x at xx:xx AM UTC because it had issues."}}], "brand_msisdn": "{phone}"}, "status": 200, "response_time": 0.0xxxxxxxxxxxxxxx, "current_time": "xxxx-xx-xx xx:xx:xx.xxxxxx", "response": "{"success":true}"}} |
| Template Disabled | {"product": "whatsapp", "component": "whatsapp-callback-event-worker", "level": "debug", "timestamp": "2023-11-02 09:57:45.920074", "message": {"URL": "xxxxxxxxxxxxxxxxxxxxxx", "data": {"statuses": [{"id": "xxxxxxxxxxxxxxxxx", "template_name": "xxxxxxxxxxxxxxx", "template_id": xxxxxxxxxxxxxx, "template_language": "en_US", "reason": "NONE", "status": "FLAGGED", "timestamp": xxxxxxxxxx, "type": "event", "information": null}], "brand_msisdn": "{phone}"}, "status": 200, "response_time": 0.011070728302001953, "current_time": "xxxx-xx-xx xx:xx:xx.xxxxxx", "response": "{"status":"ok"}\n"}} |
| Template Deleted | {"product": "whatsapp", "component": "whatsapp-callback-event-worker", "level": "debug", "timestamp": "2023-11-02 10:36:44.798440", "message": {"URL": "xxxxxxxxxxxxxxxxxxxxxxxx", "data": {"statuses": [{"id": "xxxxxxxxxxxxxxxx", "template_name": "testing_02_2023", "template_id": xxxxxxxxxxxxxx, "template_language": "en_US", "reason": "NONE", "status": "PENDING_DELETION", "timestamp": xxxxxxxxxxx, "type": "event", "information": null}], "brand_msisdn": "{phone}"}, "status": 200, "response_time": 0.0xxxxxxxxxxxxxxxxxx, "current_time": "xxxx-xx-xx xx:xx:xx.xxxxxx", "response": "{"status":"ok"}\n"}} |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Success