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:

Error Codes	Description	Solution
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"

.