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"

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