Disclaimer: The majority of these errors occur due to your violation of Meta's policies. Kindly follow these rules for a seamless experience with AiSensy.
There might be times when you face errors in the AiSensy platform but don't know why they occurred or how to resolve them!
Whether it be errors in broadcasting, Live Chat, or another AiSensy feature, you'll find exactly why these errors are happening to your AiSensy dashboard, in this document.
So, let's get started.
Types of Messaging errors you might face in AiSensy
1. Error Code 130429: Rate limit issues
This issue occurs when you try to send a broadcast to users above your broadcasting limit. Example: If you are currently in WhatsApp Broadcasting Tier 2, i.e., 10,000 users, and you try sending a broadcast to 11,000 users, you will see a warning on your screen just above the "Send Now" button that says, "Audience size exceeding the remaining quota, some messages may not be delivered." For reference, view the image attached below👇
If you continue to send the broadcast to all 11,000 users, 1000 messages will fail to deliver and will be shown under the Failed Messages section of that campaign. That's why it's recommended to send broadcasts only to users within your broadcast limit to avoid such an error.
Solution
To send broadcasts to unlimited users, here's how you can upgrade your WhatsApp Broadcasting limit.
2. Error Code 131048: Spam rate limit hit
This error shows when Meta restricts your WhatsApp Business API account because too many of your previously sent messages were blocked or flagged as spam.
If you're sending too many messages to the same audience or if you're sending messages to users who haven't opted into your WhatsApp updates, there are higher chances these users will block your account or report you as spam.
When this happens, Meta considers your messages as spam and if this continues, they might restrict your account.
If your account is restricted and you try to send a WhatsApp broadcast, all messages will fail to deliver and the reason will show as "Spam rate limit hit."
Solution
-
Make sure messages follow the WhatsApp Business Policy and Commerce Policy.
-
Only send messages to users who have opted into receiving messages from your business.
-
Make the messages highly personalized and useful to users. Avoid sending open-ended welcome or introductory messages.
-
Be mindful of messaging frequency; avoid sending customers too many messages a day. Be thoughtful of informational messages, optimizing for content and length.
3. Temporarily blocked for policy violations
If your account has been temporarily blocked or restricted, there are chances you might have violated a platform policy.
See the Policy Enforcement document to learn about policy violations and how to resolve them.
Solution
If this issue happens to you, kindly Contact us and we'll raise a ticket from our end to Meta to get your account live again.
4. Invalid parameter
If you encounter the issue "Invalid parameter", you might have misspelt the parameter or used it wrong.
Solution
To prevent an Invalid parameter issue, check whether you've correctly enclosed the parameter or not!
Read this guide on how to correctly use a parameter in AiSensy app.
5. Error Code 130472: The user's number is part of an experiment
If you see the issue "user's phone number is part of an experiment" as a reason under failed messages, this means that the user to whom the message failed to sent was a part of an experiment from Meta.
You won't be able to send messages to these users for 24-48 hours. However, do note that these users might still receive messages from other brands since they are not a part of an experiment for every brand that sends them a WhatsApp message.
6. Required parameter is missing
If you encounter the issue "Required parameter is missing," you might have misspelt the parameter or used it wrong.
Solution
To prevent this issue, check whether you've correctly enclosed the parameter or not!
Read this guide on how to correctly use a parameter in AiSensy app.
7. Service unavailable
If the error shows "Service unavailable", it means that Meta's servers are currently running down.
Solution
Check the WhatsApp Business Platform Status page to see API status information before trying again.
8. Error Code 131026: Message Undeliverable
Reasons for this error include:
-
User's WhatsApp Version: If the recipients are using an older version of WhatsApp Messenger or Business App, they may encounter difficulties in receiving messages. We recommend advising your contacts to update their WhatsApp applications to the latest version to ensure smooth message delivery.
-
The recipient has not accepted WhatsApp's new Terms of Service and Privacy Policy.
-
Recipients 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
-
-
The message was not delivered to create a high-quality user experience. See Per-User Marketing Template Message Limits.
WhatsApp Anti-Spam Measures: WhatsApp prioritizes user experience and employs anti-spam measures to protect users from unwanted messages to ensure high quality user experience. If a user has never initiated contact with a business API number or typically does not engage with messages from such numbers, WhatsApp may restrict messages from that specific API or other Business APIs for a period of 24 to 48 hours.
Solution
Using a non-WhatsApp communication method, ask the WhatsApp user to:
-
Confirm that they can send a message to your WhatsApp business phone number.
-
Confirm that your WhatsApp business API phone number is not in their list of blocked numbers (Settings > Privacy > Blocked or Blocked contacts).
-
Confirm that they have accepted our 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 app.
-
If all the above are not the reason, then try messaging the same users after 24 hours
9. Error Code 131042:Business eligibility payment issue
In case you face an error related to your payment method, it might be that you haven't set up your billing method correctly for your WhatsApp Business account.
It might be possible that you accidentally removed your WhatsApp API provider from Facebook Business manager as a payment method for the API. For resolution, connect with support.
Here are a few common problems due to which this error happens:
-
The payment account is not attached to a WhatsApp Business Account
-
The credit line is over the limit
-
Credit line (Payment Account) not set or active
-
WhatsApp Business Account is deleted
-
WhatsApp Business Account is suspended
-
Timezone not set
-
Currency not set
-
Messaging for the request (On Behalf Of) is pending or declined
-
Exceeded conversation-free tier threshold without a valid payment method
Solution
If this issue happens to you, kindly Contact us and we'll raise a ticket from our end to Meta to get your account live again.
10. Media upload error
In case you're unable to upload a media item, it might be that you're uploading an unsupported media type.
Solution
We recommend that you inspect any media files that are causing errors and confirm that they are supported. For more info, check which media files are supported along with their maximum upload size
For example, in UNIX, you can use file inspection via the command line to determine its MIME type:
file -I rejected-file.mov
You can then confirm if its MIME type is listed in our list of supported media types.
For more reliable performance when sending media, refer to Media HTTP Caching and uploading the media.
11. Error Code 132001: Template does not exist
If while sending a broadcast, you face the issue "Template does not exist," it might be happening because the template does not exist in the specified language or the template has not been approved.
Solution
The possible solutions in this case include making sure that your template has been approved and that the template name and language locale are correct. Please ensure you follow the message template guidelines.
12. Error Code 132015: Template is Paused
If your active WhatsApp API campaign gets paused, it might be that Meta has disabled or paused the template message due to users blocking the template or some issue with the template message.
Solution
The solution here is to Edit the template to improve its quality and run the API campaign or WhatsApp broadcast once it is approved.
13. Unidentified Error
This is an unidentified error by Meta servers. When the message could not be sent due to unidentified issues.
Solution
The solution is to try sending the messages to the contacts after some time like a few hours and it should get sent to the users.
14. Failed message is “unhealthy system activity"
The error you are facing occurs when the users you are broadcasting to have not replied to any of your recent messages or, in general, have not replied to messages received from business accounts on their numbers.
To protect users from spam, WhatsApp has introduced a messaging limit. If a user hasn't replied to messages from businesses recently, new businesses cannot message them for 24-48 hours. This is why your messages are failing.
Solution
Please try sending the message again after 24-48 hours.