When sending transactional WhatsApp messages through Insider, you might receive error responses. These errors let you know why a message couldn’t be processed and help you quickly understand what went wrong.
Below, you’ll find the most common error types, what they look like in the response, and what each one means.
Message Limit Reached Error
A POC message limit error refers to the systemic issue when Proof of Concept (POC) partners exceed their allocated message limit.
{
"error": {
"message": "POC Message Limitation",
"code": 20031
}
}Missing Country Code Error
The Missing Country Code Error occurs when messages are dropped because incorrect country codes are used.
{
"error": {
"message": "Country Code Drops",
"code": 20030
}
}Message Validation Failed Error
A validation error can manifest as a "Message not valid" if a message has been pending validation for an excessively long time.
{
"error": {
"code": 2002,
"message": "failed to validate request"
},
"errorCode": "2002",
"errors": "failed to validate request. | ErrorCode: 2002 | Parameters: map[] | Error: Key: 'SubProductMessages.Messages' Error:Field validation for 'Messages' failed on the 'required' tag",
"message": "failed to validate request"
}System Under Maintenance Error
An "Under Maintenance" error is generally related to general web errors rather than being specific to Insider's products. This may occur when a maintenance mode screen is displayed.
{
"error": {
"code": 2020,
"message": "maintenance mode is active"
},
"errorCode": "2020",
"message": "maintenance mode is active"
}Other Issues
Beyond specific categories, other errors encompass a range of issues, including internal system problems and invalid phone number formats, which can lead to dropped messages.
{
"error": {
"code": ****,
"message": "something went wrong"
},
"errorCode": "****",
"message": "something went wrong"
}