WhatsApp Business API Errors
BizMagnets is committed to enhancing your communication experience. We provide clear explanations and solutions for common error codes to ensure smooth and uninterrupted communication.
BizMagnets aims to streamline your communication process. "If you encounter any errors, it's essential to understand and resolve them quickly to maintain uninterrupted communication. Here are straightforward explanations and solutions for frequently encountered error codes:
131026
Message Undeliverable
Messages may fail to deliver for various reasons, such as the recipient not having WhatsApp, not consenting to updated policies, or using an outdated version of the app.
Ensure the recipient meets the WhatsApp version requirements and has agreed to the latest rules. If necessary, propose alternative communication methods. Read more.
472
WhatsApp testing may impact the delivery of marketing messages, preventing users from receiving them unless there is an ongoing conversation.
Reach out to users via alternative channels and encourage them to start a message on WhatsApp during the permissible window.
1014
Problems with uploading images or files online are commonly due to technical issues or content integrity checks.
To mitigate these problems, convert images to JPG
format, videos to MP4
, and documents to PDF
. Additionally, verify the integrity of the content before uploading.
131048
Spam rate limit hit
The message was not sent because it exceeded the message limits associated with your phone number.
Review the daily broadcast limits, check the quality status of your phone number, and consult the Quality-based Rate Limit documentation for more information.
1026
Messages may fail to deliver for a variety of reasons.
Verify that the recipient uses WhatsApp and that their app is updated to the required version. If necessary, recommend alternative communication methods.
1000
The message failed to send because of server problems.
Please wait for 10 minutes before trying again. If the problem continues, submit a support ticket.
470
The message failed because there was no reply from the customer within 24 hours. To restart the conversation, use a message template.
Begin a new conversation with a template or encourage the user to initiate a message.
131053
Media upload error
Supported media types are subject to size restrictions. Files larger than 100MB will trigger a 'File too big' notification.
To ensure reliable transmission, compress media files to less than 10MB.
131031
Account has been locked
Problems with the WhatsApp Business Account connected to the app.
Refer to the 'Policy Enforcement document' for instructions on how to address violations or errors.
131047
Re-engagement message
The message did not send because there was no reply from the customer within 24 hours. To continue the conversation, use a message template.
Start a conversation using a template or encourage the user to initiate a message.
1011
Service is experiencing downtime or is overloaded. Please try again in 15 minutes.
Attempt to resend the message after a 15-minute wait.
408
If a message has been pending for an extended time, resend after 15 minutes.
Try resending it after waiting 15 minutes.
131000
Something went wrong
The message did not send because of an unknown error.
Message failed due to an unknown error. Wait for 10 minutes. If the issue persists, raise a support ticket.
rephrase
471
Your phone number has messaging limits due to previous blocks or being marked as spam.
Verify your 'quality status' in WhatsApp Manager and consult the 'Quality-Based Rate Limits' documentation.
131052
Media download error
Media files larger than 100MB sent by the user cannot be downloaded.
For reliable sending, compress the media to less than 10MB.
1023
Database issue.
Please wait 10 minutes and if the problem continues, submit a support ticket.
1006
File or item not found.
Ensure the correct media format has been uploaded.
2028
This is only accessible to businesses in India due to incomplete e-commerce compliance details.
Please update your Compliance Information on BizMagnets within WhatsApp Manager.
2027
The shared catalog contains no products.
Check the catalogs linked in BizMagnets. If the problem continues, submit a support ticket.
131042
Business eligibility payment issue
Problems with the payment method for WhatsApp Business.
Ensure all previous dues associated with your account have been settled.
If there are no outstanding balances and the issue remains, please contact the Support team for additional help.
130472
User's number is part of an experiment
Marketing template message was not delivered to a customer as they are part of an experiment group that restricts such messages.
To reach the customer, contact them through another non-WhatsApp channel and request that they message you on WhatsApp. This will allow you to resend the message within the customer service window.
131049
Meta chose not to deliver.
This message was not delivered to help maintain a healthy engagement ecosystem.
Avoid retrying immediately if you encounter this error code and believe it's due to reaching a limit. Instead, try resending the message after gradually increasing time intervals, as the limit may apply for varying durations.
For more details, refer to "New Per-user messaging Limits"
131051
Unsupported message type
The message type is not supported.
Please refer to the list of supported message types in the Messages section before retrying with a valid message type.
Last updated