Meta error codes
When WhatsApp refuses or can't deliver a message, Meta sends back a reason. KiliChat shows Meta's own words, for example "Message undeliverable", or "Parameter value is not valid (code 131009)". This page explains the common ones.
Use your browser's find (Ctrl+F, or Cmd+F on a Mac) to search for the code or a word from the message.
Delivery problems
| Code | Meta's message (roughly) | What it means | What to do |
|---|---|---|---|
| 131047 | Re-engagement message | More than 24 hours since the customer last wrote, so only templates are allowed. | Send an approved template. KiliChat normally stops this before sending. |
| 470 | Message failed to send because more than 24 hours have passed… | Older code for the same thing as 131047. | Send an approved template. |
| 131026 | Message undeliverable | The number isn't on WhatsApp, is wrong, uses an old WhatsApp, hasn't accepted WhatsApp's terms, or blocked you. | Check the number and country code (91…). If correct, nothing more can be done. |
| 131049 | This message was not delivered to maintain healthy ecosystem engagement | Meta limited the marketing messages this person gets. | Wait a day or two. Not charged. Send fewer marketing messages. |
| 131050 | …recipient has chosen to stop receiving marketing messages… | The person turned off marketing from you in WhatsApp. | Send them only utility messages. |
| 131021 | Recipient cannot be sender | You tried to message your own business number. | Use a different number. |
| 131051 | Unsupported message type | The message type isn't supported. | Tell us what you sent; we'll check. |
| 131053 | Media upload error | WhatsApp couldn't fetch or use the file. | Check the file type and size (images under 5 MB, videos under 16 MB, MP4 and JPG/PNG/PDF) and try again. |
| 131052 | Media download error | A file the customer sent couldn't be downloaded. | Ask the customer to send it again. |
Limits
| Code | Meta's message (roughly) | What it means | What to do |
|---|---|---|---|
| 131048 | Spam rate limit hit | Too many of your messages were blocked or reported, so Meta is limiting you. | Pause marketing, send only to interested people, improve quality. See Limits and pacing. |
| 131056 | (Business, consumer) pair rate limit hit | Too many messages to the same person in a short time. | Wait a few minutes before messaging that person again. |
| 130429 | Rate limit hit | You're sending faster than Meta allows for your number. | Wait and try again; split big broadcasts. |
| 4, 80007 | Too many calls / rate limit | Too many requests to Meta in a short time. | Wait and try again. |
| (varies) | Messaging limit reached | You've reached your daily limit of people you can message with templates. | Wait 24 hours, or split your list over several days. See Limits and pacing. |
Template problems
| Code | Meta's message (roughly) | What it means | What to do |
|---|---|---|---|
| 132000 | Number of parameters does not match the expected number of params | The values sent don't match the template's {{1}}, {{2}}… | Fill in every Value for {{n}}. Through the API, send one value per variable. |
| 132001 | Template name does not exist in the translation | Meta can't find the template in that language. It may have been deleted in Meta, or the language code is different. | Click Sync from Meta on the Templates page and pick the template again. |
| 132005 | Translated text too long | After filling in the values, the message is too long. | Use shorter values. |
| 132007 | Template format character policy violated | A value has characters Meta doesn't allow, like line breaks, tabs or more than 4 spaces in a row. | Remove new lines and extra spaces from the values. |
| 132012 | Parameter format does not match format in the created template | A required part is missing or the wrong type, often the header picture, link ending or coupon code. | Check Sending values. In flows, use simple templates. |
| 132015 | Template is paused | Meta paused it for low quality. | Wait for it to come back, or use another template. See Quality. |
| 132016 | Template is disabled | Meta disabled it permanently. | Make a new, improved template. |
| 131008 | Required parameter is missing | Something needed is empty, often a variable that came out blank (like {{name}} for a contact with no name). | Make sure every value has text. |
| 131009 | Parameter value is not valid | A value is in the wrong format, for example a bad link or phone number. | Check the values you filled in. |
| 100 | Invalid parameter | Meta didn't accept part of the request. Meta's message says which part. | Read the message; fix that part. |
Account and connection problems
| Code | Meta's message (roughly) | What it means | What to do |
|---|---|---|---|
| 190 | Error validating access token / session has expired | The number's Meta token expired or was revoked. Nothing can be sent. | See Token expired. |
| 200, 10 | Permission denied / Application does not have permission | The token is missing a permission, or the system user isn't assigned to this WhatsApp account. | See Token expired. |
| 131005 | Access denied | Similar permission problem. | As above. |
| 131042 | Business eligibility payment issue | Meta can't charge your payment method. | Fix the payment method in Meta Business Settings → WhatsApp accounts → Payment settings. |
| 131031 | Business account has been locked | Meta locked the account, often for a policy issue. | Check Meta Business Support; contact us. |
| 368 | Temporarily blocked for policies violations | Meta restricted your account for breaking its rules. | Check your account in WhatsApp Manager; contact us. |
| 133010 | Phone number not registered | The number isn't registered on the WhatsApp Cloud API. | Contact us to re-register it. |
| 131057 | Account in maintenance mode | Meta is doing work on the account. | Wait a while and try again. |
Temporary problems
| Code | Meta's message (roughly) | What to do |
|---|---|---|
| 131000 | Something went wrong | Try again. Broadcasts with retries on try again after 30 minutes. |
| 131016 | Service unavailable | Meta is having problems. Try again later. |
| 1, 2 | Unknown / service error | Try again later. |
Messages from KiliChat itself
Some errors come from KiliChat, not Meta, and have no code:
| Message | Meaning |
|---|---|
| The 24-hour window is closed. Only an approved template can be sent to this contact. | Send a template. |
| This contact has opted out | They unsubscribed. |
| This contact is blocked. Unblock them to send messages. | Unblock them first. |
| This number has no access token | The number was never connected properly. Contact us. |
| Interrupted by a restart | The server restarted mid-send; it wasn't sent twice. |
I don't see my error here
Send us a screenshot of the error on WhatsApp or to info@kilichat.com, with roughly when it happened. See Contact support.