Summary
This help article provides a comprehensive guide to troubleshooting common error messages encountered when sending broadcasts or template messages in WATI. It covers various error scenarios, their possible causes, and actionable solutions to resolve them. The guide also includes information on Meta restrictions, template message requirements, messaging limits, and payment-related issues. If you cannot find a resolution for a specific error, the article provides details on how to contact WATI support for further assistance.
Instructions
You might run into errors while sending messages in WATI. Below are common error messages, their meanings, and troubleshooting steps.
The message is not delivered, and you see the following error:
This means WhatsApp could not deliver your message due to an issue with the recipient’s phone number.
The number may not be associated with a valid WhatsApp account.
The country code might be missing.
The recipient may be using an outdated version of WhatsApp.
The recipient has not accepted WhatsApp’s latest Terms of Service and Privacy Policy.
Ask them to visit this link to accept the latest Terms of Service.
Read more about this error here: "Message Undeliverable" when sending template messages
The message is not delivered, and you see the following error:
“Message undeliverable as Meta has restricted it for higher quality messaging - retry again in a few days.”
If you’re sending a marketing template, note that Meta imposes restrictions on such messages. Please refer to this guide to learn more about these restrictions.
The user’s number is not reachable, and you see the following error:
“User’s number is part of an experiment”
Since June 14, 2023, Meta has been running experiments where about 1% of WhatsApp users do not receive marketing template messages from businesses unless they have initiated the conversation first. If this happens, you’ll need to contact the customer through another channel and ask them to message you, allowing you to send the marketing template within the 24-hour window.
You are not able to send the messages and see one of the following errors:
“Spam rate limit hit”
"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."
This error indicates that the number of messages sent from your account has exceeded the Messaging Limit set by WhatsApp (e.g., 1k/10k/100k contacts per 24 hours). Once the 24-hour window resets, you can continue sending messages. Your messaging tier will automatically increase over time based on your message volume and quality rating. Check your messaging limit in Broadcast Analytics or on the Channel status page. Messaging limit is an automated process from WhatsApp based on your messaging volume history and quality ratings.
You are not able to send messages and see the following error:
"Account has been locked."
Check if your account is currently restricted or disabled by Meta.
If restricted, you can raise an appeal to Meta.
Reviews typically take 24-48 hours.
If the restriction has been lifted but the error persists, contact us for further assistance.
You cannot use a template and see one of the following errors:
"Check your template, it cannot have typos or blank text"
Ensure that the template is correctly formatted and contains no blank fields.
"Missing customer attributes - check contact information"
Verify that all necessary customer information has been included in your message.
"Missing information - please check template media or contact information"
Ensure that all required parameters/variables are properly filled when sending a template message.
If using a dynamic header, always define a value for the header.
Avoid using newlines, tabs, or more than four consecutive spaces in template parameters and carousel content.
Some variables are specific for Shopify or WooCommerce integration, some variables can only be used for specific automated messages.
The message failed to send and you see the following error:
"Message failed to send because there were one or more errors related to your payment method"
You are not able to use a template and see one of the following errors:
"Template name does not exist"
"Template status is paused or disabled, can't be sent."
Newly approved templates may take 15-30 minutes to appear in Facebook's records.
WhatsApp may have disabled the template due to a low-quality rating.
Check this status in WhatsApp Manager in your Facebook Business Account.
You can 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 the template has been deleted, you may need to resubmit it as a new template.
If sending through API, check for typos in the template name.
You are seeing the following error about the message:
"Translated text too long."
Check the message that you sent and make sure the character count does not exceed the formatting rules:
Ensure your message meets the following character limits:
Header and Footer: 60 characters
Body: 1024 characters
Visit Website dynamic button: 2000 characters
Formatting symbols also count towards the character limit.
You are trying to send a message via API and see the following error:
"Not enough required request Parameters to send template XYZ"
If sending a template message via API, ensure that all parameters and values are correctly set.
Check for typos in parameter names.
We've compiled a library of API recipes to help you get the most out of WATI. You can find them here
You are trying to send a message via API and see the following error:
"Number of parameters does not match the expected number of params!"
If you updated the number of parameters in WhatsApp Manager, you must submit a new template instead of modifying an existing one.
You are trying to send a media and see the following error:
"Media upload error"
Ensure the uploaded media meets WhatsApp’s supported media guidelines:
Images: Must be 8-bit, RGB or RGBA.
Videos: Must use H.264 video codec and AAC audio codec. Only one audio stream is allowed.
Documents: If used as a template header, only PDF format is supported.
If a video meets the size limit but still fails, try converting it using an online converter to resolve codec issues.
You cannot contact a user and see the following error:
"Generic user error"
This is an unknown error from Meta for newly approved templates.
Try resubmitting the template and see if the issue is resolved.
You cannot use a template and see the following error:
"Content in this language already exists"
Check if another approved template has the same name.
Deleted templates remain pending deletion for 30 days, preventing the reuse of the same name within that period.
You cannot send a broadcast message and see the following error:
"Insufficient credits"
Ensure you have sufficient credits for the broadcast.
Verify that all contacts have the correct country codes added.
Frequently Asked Questions (FAQs)
General Questions
1. Why am I seeing an error when sending a message in WATI?
→ Errors can occur due to various reasons, such as incorrect phone numbers, WhatsApp restrictions, missing parameters, or messaging limits. Check the error message details in this guide to troubleshoot the issue.
Delivery and Messaging Limit Errors
2. What does “Message undeliverable” mean?
→ This error occurs when the recipient’s number is invalid, missing a country code, using an outdated WhatsApp version, or hasn’t accepted WhatsApp’s latest Terms of Service.
3. Why does my message fail due to “Spam rate limit hit”?
→ This means you have exceeded WhatsApp’s messaging limit for your account tier (1k/10k/100k messages per 24 hours). Wait for the 24-hour window to reset before resuming.
4. How can I check my messaging limit?
→ You can check your messaging limit tier in Broadcast Analytics or on the Channel status page.
5. Why is my message blocked due to Meta’s restrictions on marketing templates?
→ Meta imposes restrictions on marketing templates for quality control. If you see this error, try again after a few days or use a different approach to engage with your audience.
Template and Formatting Issues
6. Why do I see “Template name does not exist”?
→ The template may not have been registered in the system, or there may be a typo in the name if you’re using the API.
7. What should I do if my template is “paused or disabled”?
→ Newly approved templates take 15-30 minutes to appear in Facebook’s records. If disabled, check WhatsApp Manager in your Facebook Business Account for quality issues or resubmit a new template.
8. How can I fix the “Translated text too long” error?
→ Ensure your message does not exceed these character limits:
Header/Footer: 60 characters
Body: 1024 characters
Visit Website button: 2000 characters
9. What does “Not enough required request Parameters to send template XYZ” mean?
→ If you’re using the API, verify that all parameters are correctly included in your request. Check for typos and missing values.
Account and Payment Issues
10. What does “Account has been locked” mean?
→ Your account may be restricted or disabled by Meta. You can submit an appeal, and the review process usually takes 24-48 hours.
11. How do I resolve “Message failed to send because there were one or more errors related to your payment method”?
→ If you recently created an account or migrated from another BSP, ensure you followed the correct WhatsApp Business Account onboarding process.
12. What should I do if I see the “Insufficient credits” error?
→ Check your available credits for broadcasts and verify that your contacts have the correct country codes added.