Meta Messages Error Codes
This page provides an overview of common WhatsApp Business API error codes from Meta, their reasons, and recommended solutions.
Getting Here
- Select Failed Messages Logs under the Teams section to view detailed error information.
Error Codes and Solutions
Below is a table of common WhatsApp Business API error codes, their descriptions, and suggested solutions:
Error Code | Description | Possible Causes | Recommended Solutions |
|---|---|---|---|
131026 | Message Undeliverable | Recipient's number is not registered on WhatsApp<br>- Recipient has not accepted the latest Terms of Service<br>- Recipient is using an outdated WhatsApp version | Verify the recipient's number is correct and active on WhatsApp<br>- Request the recipient to accept the latest Terms of Service<br>- Ask the recipient to update their WhatsApp application |
131042 | Something Went Wrong | Temporary server issues<br>- Incorrect request parameters | Retry sending the message after a short delay<br>- Ensure all request parameters are correctly formatted |
131042 | Business Eligibility Payment Issue | Business Eligibility Payment Issue | Verify and update billing details in WhatsApp Business Account settings |
132001 | Template Does Not Exist | Template not approved or does not exist in the specified language | Confirm the template name and language are correct<br>- Ensure the template is approved in WhatsApp Manager |
131047 | Re-engagement Message | More than 24 hours have passed since the recipient's last message | Use a pre-approved message template to re-engage the customer |
131048 | Spam Rate Limit Hit | Too many messages sent in a short period, flagged as potential spam | Reduce the frequency of messages<br>- Monitor message quality and avoid repetitive content |
131049 | Message Blocked for Ecosystem Protection | Meta limiting delivery to protect users from unsolicited messages | Ensure messages are sent to users who have opted in<br>- Improve message quality and personalization |
131051 | Unsupported Message Type | Attempting to send a message type not supported by WhatsApp | Refer to WhatsApp documentation to ensure the message type is supported |
133010 | Phone Number Not Registered | Business phone number not registered on the WhatsApp Business Platform | Register the phone number before attempting to send messages |
132016 | Template is Disabled | Template has been disabled due to low quality | Create a new template with improved content and submit for approval |
131053 | Media upload error | Unable to upload the media used in the message. | inspect any media files that are causing errors and confirm that they are in fact supported. |
For more detailed information and updates, please refer to the Official Meta Error Codes.
Practical Use Cases
- Monitoring Message Failures:
- Regularly check the Failed Messages Logs to identify and address delivery issues promptly.
- Improving Message Quality:
- Analyze error patterns to refine message templates and reduce the likelihood of messages being marked as spam.
- Ensuring Compliance:
- Stay updated with WhatsApp's policies to ensure all messages meet the required standards and avoid delivery restrictions.
Best Practices
- Regular Audits:
- Periodically review message logs to detect recurring issues and implement corrective measures.
- Template Management:
- User Engagement:
- Encourage recipients to interact with messages to keep communication channels active and reduce the chances of messages being undelivered.
- Stay Informed:
- Keep abreast of updates from Meta regarding changes to messaging policies and error codes.
FAQs
- What does "Message Undeliverable" mean?
- This indicates that the message could not be delivered due to reasons such as the recipient not being on WhatsApp, not accepting the latest Terms of Service, or using an outdated app version.
- How can I resolve a "Spam Rate Limit Hit" error?
- Reduce the frequency of messages sent to users and ensure content is relevant and personalized to avoid being flagged as spam.
- Why is my template marked as "Does Not Exist"?
- This occurs when the specified template is not approved or does not exist in the chosen language. Verify the template's status in WhatsApp Manager.
- What should I do if a template is disabled?
- Create a new template with improved content quality and submit it for approval to replace the disabled one.
- Can I resend messages that failed due to errors?
- Yes, after addressing the underlying issue, you can attempt to resend the message.
- How do I check the status of my WhatsApp Business Account?
- Access your account settings in WhatsApp Business Manager to review billing details, template statuses, and compliance notifications.
- What is the 24-hour customer care window?
- WhatsApp allows businesses to respond to user-initiated messages within 24 hours. Beyond this window, only pre-approved templates can be used to initiate conversations.
- Why are messages blocked for ecosystem protection?
- Meta may restrict message delivery to users who have not opted in or to prevent spam, ensuring a healthy messaging environment.
- How can I prevent message delivery issues?
- Ensure recipients have opted in, use approved templates, maintain message quality, and monitor delivery reports regularly.
- Where can I find more information on WhatsApp API error codes?
- Refer to the Official Meta Error Codes and the Sanoflow blog for comprehensive details on error codes and their resolutions.