1 Locating Failure Data: The First Step in Diagnosis
Before you can solve a problem, you must first identify and locate it. Failure data can be found at the campaign level or even for individual messages.
For campaigns sent to a specific customer list, the platform provides a detailed performance report. Follow these steps to access it:
Navigate to the Bulk Marketing Campaigns section from the main dashboard.
Click on the specific campaign you wish to analyze.
The campaign's dashboard will display key performance metrics, including the total number of messages that Failed, were Delivered, and were Read.
To understand the specific reasons for each failure, click on Export Campaign Data and select the Customer Report.
You will receive an email with a link to download the report. This detailed file provides a contact-by-contact breakdown, including a specific reason for any message that failed to deliver. You can filter the file after downloading to see the failure reasons and the failure percentage for each.
Note: if you couldn’t download the report file after opening the email, copy the link and paste it in an incognito tab, and a save request should pop up to save the file.
With the failure data and error codes in hand, the next step is to understand what they mean and how to act on them.
2.0 Decoding Failure Reasons: A Categorized Analysis
Campaign failures are rarely random; they typically fall into distinct categories. By understanding these categories, and understand how to handle each case.
2.1 Technical Delivery Failures: Meta and WhatsApp Error Codes
When a message fails to send, WhatsApp often provides a specific error code. This code is the key to understanding the technical reason for the failure and its corresponding solution.
Common WhatsApp Delivery Error Codes and Solutions
Error Code | Reason for Failure (Why?) | Recommended Solution |
131026 | The recipient cannot receive the message. This may be because their number is not a valid WhatsApp number, they have not accepted the latest Terms of Service, or they are using an outdated version of the app. | Confirm the recipient has accepted the latest terms and is using an updated version of WhatsApp. |
131000 | An unknown error occurred during the sending process. | The issue is likely temporary. Attempt to send the message again. |
131042 | There is an issue with the payment method on the WhatsApp Business account. | Check your billing and payment settings in your Facebook Business Manager and settle any outstanding invoices. |
132001 | The message template does not exist or is not approved for the recipient's language. | Verify that the template has been approved by WhatsApp and that the correct language version is being used. |
132015 | The template has been paused by WhatsApp due to low-quality signals, such as being reported or blocked by users. | Edit the content of the template and resubmit it for approval. |
132016 | The template has been permanently disabled after being repeatedly paused for low quality. | The template cannot be used again. You must create a new template with improved content. |
130472 | The user's number is part of an experiment and cannot receive the message. | Contact the customer through another channel or attempt to send a customer service-type template instead. |
131048 | The spam rate limit has been reached. This can be due to a history of spam reports or exceeding the daily sending limit. | Check your WhatsApp number's quality status and daily sending limit in your WhatsApp Manager. |
130429 | The per-second message sending rate has been exceeded. | Reduce the frequency of sending messages or try again after a short delay. |
131049 | Meta has chosen not to deliver the message. This can happen if a user has already received multiple marketing messages from any business on the same day. | Increase the time between sending marketing messages. Activating a "Smart Sending" feature can help manage this automatically. |
2.2 Account and Configuration Issues
Sometimes, the problem isn't with a single message but with the overall health and configuration of your account.
Payment Problems:
If there are outstanding invoices on your WhatsApp Business account or your BusinessChat subscription, you will be blocked from launching new campaigns. Ensure all accounts are in good financial standing before sending.
Exceeding Daily Sending Limits:
WhatsApp imposes tiered daily limits on the number of unique customers a business can message within a 24-hour period (e.g., 1,000, 10,000, 100,000). If a campaign targets a list of customers larger than your current daily limit, all messages sent after the limit is reached will fail.
Poor WhatsApp Number Quality:
WhatsApp rates your number's quality as Green (High), Yellow (Medium), or Red (Low) based on customer feedback like blocks and reports. A 'Low' quality rating can lead to a 'Suspended' or 'Restricted' status, which prevents you from sending messages and causes campaign failures.
2.3 Content and Template Violations
The content of your messages and the structure of your templates are critical. Violating WhatsApp's policies in this area is a common source of failure.
Low-Quality Template:
If a template consistently receives negative feedback from customers (reports or blocks), WhatsApp may first pause it (Error 132015). If the negative feedback continues, the template can be permanently disabled (Error 132016), causing any campaign that relies on it to fail. In this case, some of the contacts will receive the campaign message, but once the template gets paused, the rest of the contacts won’t receive the message.
Solutions based on the data you get from the reports
All failed messages due to an issue with the recipient’s phone number are not solvable, as you have no control over the contacts’ phone numbers or devices. So there’s no need to resend the campaign to them.
All failed messages due to the contact’s phone number being part of an experiment have no solution, as Meta has blocked these numbers from receiving marketing messages for an undetermined time. So there’s no need to resend the campaign to them.
All messages that failed due to a WhatsApp payment or Tier limit threshold have a solution. You need to filter those contacts, upload them again to the BusinessChat account, and send the campaign to them after you’ve confirmed you've paid the WhatsApp payment and that you have enough funds on the card for the new campaign. However, if the issue is the tier limit, you need to wait 24 hours for it to reopen, then you can resend the campaign.
All failed messages due to the Meta error "maintain a healthy ecosystem" are solvable. Filter those contacts and send them the campaign after at least 24 hours. However, note that there will always be a failure rate, as this specific error counts all marketing messages from other stores, not just yours.