Skip to main content
All CollectionsWhatsApp Business Platform
Understanding undelivered messages.
Understanding undelivered messages.

Messages most common failure reasons.

Updated over 2 months ago

Sometimes, WhatsApp Business messages don't get delivered. Don't worry; this can happen for a few common reasons. If you encounter message delivery issues on WhatsApp Business, please refer to the respective error codes and follow the provided solutions to fix them.

Below, we'll simplify the most common error codes, explain why they occur, and provide solutions.

Meta Error Codes and Solutions:

1. Error Code 131026: Message Undeliverable / Receiver is incapable of receiving this message.

Why?

  • The recipient's number isn't a WhatsApp number.

  • The recipient hasn't accepted the new Terms of Service and Privacy Policy.

  • The recipient uses an outdated WhatsApp version.

Solution:

  • Confirm the recipient's WhatsApp and agreement.

  • Ensure the recipient's app is up to date.


2. Error Code 131000: Something went wrong.

Why?

  • Unknown error.

Solution:

  • Try sending it again.


3. Error Code 131042: Business eligibility payment issue.

Why?

  • Payment method issues.

Solution:

  • Check billing setup.

  • Address payment problems.


4. Error Code 132001: Template does not exist.

Why?

  • Template not approved or not in the correct language.

Solution:

  • Verify template approval and language.

  • Follow template guidelines.


5. Error Code 132015: Template is Paused.

Why?

Solution:

  • Improve template quality.

  • Await approval.


6. Error Code 132016: Template is Disabled.

Why?

Solution:

  • Create a new template.


7. Error Code 130472: User's number is part of an experiment.

Why?

Solution:


8. Error Code 131048: Spam rate limit hit.

Why?

  • Restrictions on messages due to spam history.

Solution:


9. Error Code 130429: Rate limit hit.

Why?

  • Cloud API message throughput has been reached.

Solution:

  • The app has reached the API's throughput limit. See Throughput. Try again later or reduce the frequency with which the app sends messages.


10. Error Code 131049: Meta chose not to deliver.

Why?

  • Businesses are limited to sending a maximum of two marketing template messages within a 24-hour conversation window without a customer response.

Solution:

  • Increase the time between sending marketing messages. To ensure this, activate the smart sending.

Did this answer your question?