Product
...
WhatsApp Business API
Meta Messages Error Codes
5 min
this page provides an overview of common whatsapp business api error codes from meta, their reasons, and recommended solutions getting here navigate to the inbox overview docid 9qqxrivvbzhkon5ujlek8 module from the left hand menu 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 maintain an organized repository of templates overview docid\ gmlv5kxg4quy8moxo x0s and monitor their performance 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