API Campaigns
WhatsApp allows businesses to send pre-approved template messages as notifications to users once the business goes live on WhatsApp Business API. These notifications can be account update, payment update, shipping update etc.
SAMWAD offers businesses an easy gateway to send notifications and track performance through campaigns. Businesses can even broadcast messages apart from automating them.
How are WhatsApp Broadcast and API Campaign different?
WhatsApp API Campaign: In this, you choose a fixed pre-approved template message for a particular event that is being triggered by the user. Now, every time users trigger the event, they receive that particular template message automatically through APIs.
Example – Abandoned Cart message for e-Commerce stores, Payment Confirmation message for every successful payment etc.
WhatsApp Broadcast Campaign: In this, you have the liberty to choose a message type from Pre-approved Template Message and Regular Message. Let’s suppose you choose a template message.
Now, you configure the dynamic values of the template message, choose the audience you want to send the message to and shoot the campaign. Hence, this is done manually and not through APIs.
Example – Event reminder message to all the participants, offer Message to all the Active Users through a Regular Message etc.
Does one get charged for Failed Messages also?
No. You won't be charged for the failed messages. Only sent messages are charged.
Messaging errors in SAMWAD & what they mean!
Disclaimer: The majority of these errors occur due to your violation of Meta's policies. Kindly follow these rules for a seamless experience with SAMWAD.
There might be times when you face errors in the SAMWAD platform but don't know why they occur or how to resolve them!
Whether it be errors in broadcasting, Live Chat, or another SAMWAD feature, you'll find exactly why these errors are happening to your SAMWAD dashboard, in this document.
So, let's get started.
Types of Messaging errors you might face in SAMWAD
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”.
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.
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 of "Invalid parameter", you might have misspelled the parameter or used it wrong.
Solution
To prevent an Invalid parameter issue, check whether you've correctly enclosed the parameter or not!
Read the guide below
How to Use Parameters in Samwad for WhatsApp Template Messages
Using Parameters to Create WhatsApp Template Messages
Parameters are placeholders enclosed in brackets {{}} used to customize your WhatsApp Template Messages. You need to set up the parameters properly along with sample messages before submitting them to WhatsApp for approval.
Here’s a step-by-step guide on how to use parameters while creating WhatsApp Template Messages 👇
Steps to Draft a WhatsApp Template Message with Parameters
1. Create a New WhatsApp Template
Navigate to the Template Message section in Samwad and click on ‘New’ to create a new WhatsApp Template Message.
2. Parameters in Template Format
When drafting your template, include parameters in the following format:
Use double curly brackets for variables (e.g., {{1}}). Ensure the number of curly brackets on both sides is correct.
Insert meaningful text within each parameter.
Examples:
✅ Correct Format: Hello {{1}}
❌ Wrong Format:
CopyEdit
Hello
{{1}}
{{2}}
3. Parameters in Sample Message
When filling in the Sample Message, replicate the Template Message content with one key difference:
Replace curly brackets {{ }} with square brackets [ ].
Instead of a variable (e.g., 1), provide a sample value like a name or number.
Example:
Template: Hello {{1}}, your order {{2}} is confirmed.
Sample: Hello [John], your order [12345] is confirmed.
This ensures the WhatsApp review team clearly understands the intended use of the template.
Important Notes:
The parameters will not be visible to the end user once the message is sent.
Be precise while filling the Template Label, Type, Category, and Language
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 send 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.
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
The 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 happen 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 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.
Last updated