When sending conversational WhatsApp messages through Insider One, 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 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"
}Activation Error
A 2003 response means that the message failed the activation checks and was not queued. Check the detail field to identify the exact cause.
{
"message": "Message could not be sent. ",
"detail": "commerce feature is not active.",
"errorCode": "2003",
"error": {
"message": "Message could not be sent.",
"code": 2003
}
}Error code 2003 is a general activation error. The detail field can include:
commerce feature is not active.:Conversational WhatsApp is not enabled, or the request uses the wrong API endpoint.
WhatsApp is not active.: WhatsApp is not active for the account.
There is no active provider.: No active WhatsApp provider or sender phone number is configured.
Account not active: The account is inactive.Another provider or system reason.
Always use the
detailfield to identify the cause. If the relevant capability is enabled but the error continues, contact Insider One Support to verify the account activation.
System Under Maintenance Error
An "Under Maintenance" error is generally related to general web errors rather than Insider One-specific issues. You might encounter it 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"
}