Troubleshoot common errors in WATI

Error messages in broadcasts or template messages

You might come across errors from time to time when trying to send messages in WATI. Here are some examples of the error messages you can get and clues to help you troubleshoot the issue.

We have stopped using hello@wati.io for contacting customer support. Please email us at support@wati.io for any support/technical queries or at billing@wati.io for any billing issues.
1.
"Message undeliverable"
  • This error indicates there's an issue with the recipient's phone number, and WhatsApp is unable to deliver the message.
  • Most likely the number you are messaging does not have a valid WhatsApp account
  • You may have forgotten to include the country code in the phone number
  • This may also happen if the recipient is using an older version of WhatsApp
  • Or they haven't accepted WhatsApp's latest Terms of Service and Privacy Policy. Please send your end user this link https://wa.me/tos/20210210 to accept the latest Terms of Service.
  • It can also be caused by the marketing template limit applied on the recipient side by Meta
2.
"Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam."
"Message failed to send because there were too many messages sent from this phone number in a short period of time"
  • Have you completed your business verification?
  • Are you placed in the sandbox messaging tier by WhatsApp? Click here to read more about sandbox mode.
  • Has your new display name just been approved? In that case, contact support@wati.io and we will register your certificate for you.
  • If you are broadcasting to a large audience, have you reached your 24hour messaging limit set by WhatsApp? (1k/10k/100k contacts per 24 hours).
  • Low-Quality Message which results in getting blocked by WhatsApp (Rare Scenario)
3.
"Check your template, it cannot have typos or blank text"
  • When sending a template, make sure to pass the value of all existing parameters/variables
  • Some variables are specific for Shopify or WooCommerce integration, one variable can only be used for specific automated messages
4.
"Message failed to send because there were one or more errors related to your payment method"
  • Email us at support@wati.io and we will be able to resolve the payment method issue for you.
5.
"This phone number has reached its 24-hour messaging limit and can no longer send messages to customers. Please wait until the message limit is reset to send messages"
  • There is no immediate solution to this error. This means the number of contacts you have sent message to has exceeded your message limitation set by WhatsApp (ie 1k/10k/100k contacts per 24hour). Once the 24-hour window has refreshed, you will be able to continue to send messages. Your tier will also be upgraded automatically by WhatsApp over time as you send more messages.
6.
"Template name does not exist"
  • Newly approved templates do not show up in Facebook's records immediately, so you need to give it 15-30 minutes of time and then try again.
  • WhatsApp might have disabled this template due to its low-quality rating and it won't be available for use. You can check this through your WhatsApp Manager in your Facebook Business Account. You may resubmit the content as a new template and see if WhatsApp approves it. Once it is approved, you will be able to use it again.
  • If sending through API, check if there are typos in the template name.
  • Template might have been deleted through your WhatsApp Manager in your Facebook Business Account. If you are a WATI CRM user, create/delete your templates through your WATI interface instead.
7.
"Not enough required request Parameters to send template XYZ"
  • If sending message through API, check your API request to make sure all the parameters and corresponding values of the template are sent. Template cannot have blank parameters. Usually there might be typos in the parameter names in the API request.
    You may also check our recipes on how to use the API: https://docs.wati.io/recipes
8.
"System overloaded due to job queue size"
  • As this is a system issue so you will have to reach out to WATI Support at support@wati.io
9.
"(#200) Permissions Error"
  • Have you completed your business verification?
  • As this is a system issue so you will have to reach out to WATI Support at support@wati.io
    10.
"Failed to send a template. Number of parameters does not match the expected number of params! header: number of localizable_params (0) does not match the expected number of params (1)"
  • The parameter value for header/footer variable is too long
  • The character limit for the entire header/footer is 60

If you cannot find the error message you see here, please contact us at support@wati.io. Remember to provide a screenshot and the name of the template you are having issues with. Thank you!

How did we do?

How to allow users to Opt-Out or Unsubscribe from Broadcasts?

How can I search and filter Broadcasts?

Contact