Why a message was not delivered: WhatsApp statuses and error codes
Everything you need to check on your own whether a message reached the customer, and what to do if it did not. Delivery failure reasons come from WhatsApp itself, and the dashboard shows them in plain language.
Sent does not mean delivered
When a message or template is sent, it means WhatsApp has accepted it. Whether it reaches the customer is up to WhatsApp. For example, the customer may be offline: the message will arrive later, once the phone is back online. Or WhatsApp may reject the message under its own rules, and then the reason appears in the dashboard.
How to read the message status
| Icon | Meaning |
|---|---|
| One grey tick | WhatsApp accepted the message, the customer's phone has not received it yet |
| Two grey ticks | Delivered to the customer's phone |
| Two blue ticks | The customer has read the message |
| Red icon | Not delivered, the reason is shown under the message |
Statuses update automatically, no need to reload the page. This works the same way in dashboard chats and in the WazzaBee chat inside Bitrix24 and amoCRM. If the customer has turned off read receipts, the ticks will not turn blue even after they read the message.
Where to find the failure reason
- In the chat. A red "Not delivered" note with the reason appears under the message.
- In the broadcast report. Go to "Broadcasts" and open the broadcast. At the bottom there is a table for every number: status, sent, delivered and read time, and an "Error" column with the reason.
- In the broadcast export. Use the export button in the broadcast report. The file opens in Excel and has the columns "Phone", "Name", "Status", "Sent", "Delivered", "Read", "Error" and "What to do". You can export delivered, read and failed recipients separately, numbers without WhatsApp, and those worth resending.
The 24-hour window
A regular message (text, photo, file) can only be sent if the customer has written to you within the last 24 hours. If the window is closed, message the customer with a template: the window does not apply to templates. Once the customer replies, the window opens again for 24 hours.
Marketing and utility templates
WhatsApp is stricter with marketing templates. It limits how many promotional messages one person can receive, and does not show promotional templates to some users at all. Utility templates are not subject to these limits, so they are delivered more reliably. A utility template fits when the message relates to the customer's own action: a reply to a request they left, a confirmation, a booking or class reminder, an order status. A utility template must not contain ads or discounts, otherwise WhatsApp will move it to the marketing category.
Error codes and what to do
| Code | Reason | What to do |
|---|---|---|
| 131047 | The customer has not written for more than 24 hours, regular messages are blocked | Send a template |
| 131049 | WhatsApp limited delivery: frequency of promotional messages or the customer rarely replies | Wait at least 24 hours or until the customer replies. For service messages use a utility template |
| 130472 | The number is part of a Meta experiment: promotional templates are not delivered to it | Resending the same template will not help. Send a utility template or contact the customer another way |
| 131026 | The recipient has no WhatsApp or the number is wrong | Check the number. No need to resend |
| 131021 | The recipient's number is the same as the line number | You cannot message yourself, choose another number |
| 131052, 131053 | WhatsApp could not download or did not accept the file | Send it again. Image JPG or PNG up to 5 MB, video MP4 up to 16 MB, document up to 100 MB |
| 131009, 132012 | Variable values do not match the template | Check what the variables are filled with |
| 132000 | The number of variables does not match the template | Fill in all template variables |
| 132001 | The template does not exist or is not approved in the selected language | Check the template in the "Templates" section |
| 132005 | The template text changed after approval | Update the template and send again |
| 132007 | The template violates Meta formatting requirements | Fix the text and submit it for review |
| 132015 | The template was paused by Meta due to low quality | Use another template |
| 132016 | The template was disabled by Meta | Create a new template |
| 131051 | WhatsApp does not support this message type | Send it in a different format |
| 130429, 131048 | Too many messages in a short time | Send later; in a broadcast, increase the delay between messages |
| 131000, 131016 | Temporary failure on the WhatsApp side | Send again |
| 131031 | The WhatsApp account was blocked by Meta | Contact WazzaBee support |
| 131042 | Meta restricted sending due to an account payment issue | Contact WazzaBee support |
| 131008 | The message was sent with incomplete data | Contact WazzaBee support |
If the reason shows a different code, contact WazzaBee support and we will explain what it means.
"What to do" in the broadcast export
- Can be resent later: a temporary failure or too many messages at once.
- Do not resend: Meta will block it: Meta experiment, promotional message limit, number without WhatsApp.
- Fix the template or data first: errors in the template, variables or file.
