Skip to main content

Troubleshooting WhatsApp Message Errors

If you're having trouble sending WhatsApp messages, it may be due to a specific error related to Meta's standards. Here are the most common errors, their meanings, and how to fix them.

Number of parameters does not match​

Code: 132000

The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.

Solution:
Fix the discrepancy between the number of variable parameter values in the request and the number of variable parameters in the template.

Parameter format does not match​

Code: 132012

The variable parameter values included in the request are not using the format specified in the template.

Solution:
Check the values in your request and the format defined in the template.

User's number is part of an experiment​

Code: 130472

WhatsApp occasionally runs experiments to assess the impact of messaging on WhatsApp user experience and engagement. These are standard practices on the platform and help improve the messaging experience for both you and your customers.

If you send a marketing template message to a user who is part of the experiment group, WhatsApp does not send your message and does not bill you for it. Attempting to resend the message will result in the same error.

Solution:
Contact the user by some other, non-WhatsApp means, and ask them to message you so you can resend the message within an open customer service window.

Message undeliverable​

Code: 131026

Unable to deliver message. Reasons can include:

  • The recipient phone number is not a WhatsApp phone number.
  • Recipient has not accepted the new Terms of Service and Privacy Policy.
  • Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
    • Web: 2.2132.6

Solution:
Using a non-WhatsApp communication method, ask the WhatsApp user to:

  • Confirm that they can actually send a message to your WhatsApp Business phone number.
  • Confirm that they have accepted the latest Terms of Service (Settings > Help, or Settings > Application information will prompt them to accept the latest terms/policies if they haven’t done so already)
  • Update to the latest version of the WhatsApp client.

Media upload error​

Code: 131053

Unable to upload the media used in the message. The media could not be uploaded for one or more reasons, such as an unsupported media type.

Solution:
Inspect any media files that are causing errors and confirm that they are in fact supported.

Invalid parameter​

Code: 100

The request included one or more unsupported or misspelled parameters.

Solution:

  • See the endpoint’s reference to determine which parameters are supported and how they are spelled.
  • Ensure your parameter is under any length restriction for the type.
  • Ensure there is no mismatch between the phone number you are registering and a previously stored phone number.

Unknown error​

Code: 131000

Message failed to send due to an unknown error.

Solution:
Try again. If the error persists, contact NusaSMS support for assistance.

Message was not delivered to maintain healthy ecosystem​

Code: 131049

This message was not delivered to maintain healthy ecosystem engagement. If you do receive this error code and suspect it is due to the limit. Doing so will only result in another error response since the limit may be in effect for differing periods of time.

Solution:
Wait at least 24 hours before resending the template message

Recipient has chosen to stop receiving marketing messages​

Code: 131050

Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business. Do not retry sending messages to this user as they will not be received.

Template does not exist​

Code: 132001

The template does not exist in the specified language or the template has not been approved.

Solution:
Make sure your template has been approved and the template name and language locale are correct. See our Templates document to learn more about templates.

Template validation error​

Code: 132018

There's an issue with the parameters in your template.

Solution:
Review the errors, update the parameters as needed, and resend your message using a correctly configured template.