# 🚫 Error: Message Undeliverable

<figure><img src="/files/pdO0y1q2uMtNrMyr1z4q" alt=""><figcaption></figcaption></figure>

This means that Meta (WhatsApp) rejected the message before delivery — it was **never delivered to the recipient’s WhatsApp account**.

### ❓**What Does “Message Undeliverable” Mean?**

WhatsApp returns this error (error code 131026) when the platform is **unable to route the message to the destination number**. This is *not a QuickReply.ai failure* — the block originates from WhatsApp itself.

### 🔍 **Why This Error Happens — As per Meta**

The official Meta error code related to this is:

| Error Code | Description from Meta    | Reason                       |
| ---------- | ------------------------ | ---------------------------- |
| 131026     | *Message Undeliverable.* | *Unable to deliver message.* |

Meta lists the following possible causes for **undeliverable messages**:

| Reason                                                                                                                                 | Explanation                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| <p><mark style="color:red;background-color:$warning;"><code>Primary reason</code></mark> </p><p>📱 Number is not a WhatsApp number</p> | The phone number doesn’t exist on WhatsApp                             |
| ⚠️ User has not accepted latest Terms & Privacy Policy                                                                                 | The recipient must accept the updated Terms inside WhatsApp            |
| ⏳ Old WhatsApp version                                                                                                                 | The recipient is using an outdated WhatsApp app and must update        |
| ❌ Temporary WhatsApp account restriction                                                                                               | In rare cases, recipient account may be flagged or temporarily limited |

{% hint style="info" %}
Read full details on this error on Meta's documentation here <https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes>
{% endhint %}

***

### 🛠️ How to Fix It

This issue can only be resolved **by the recipient**. \ <mark style="background-color:yellow;">QuickReply.ai or your team cannot fix it from the dashboard.</mark>

* If the number is *not* on WhatsApp
  * Ask the user to:

    * Share their **correct WhatsApp number**, OR
    * **Install WhatsApp on their existing phone number** and activate it

    Messages will start working once the number is registered on WhatsApp.
* If the version is outdated
  * Ask the user to update WhatsApp to the **latest version** from Play Store / App Store
* If Terms of Service / Privacy Policy are not accepted
  * Ask the user to to accept the latest Terms of Service or Privacy Policy

***

### 🔔 Final Note

This is not a technical fault from QuickReply.ai — the message is **successfully sent from our side to WhatsApp**, but **WhatsApp rejects the delivery** due to the recipient’s account status.

Once the recipient resolves the issue from their side, all messages will begin delivering normally.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.quickreply.ai/overview/messaging-channels/whatsapp/errors/error-message-undeliverable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.