> For the complete documentation index, see [llms.txt](https://docs.quickreply.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quickreply.ai/overview/messaging-channels/whatsapp/errors/error-message-undeliverable.md).

# 🚫 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.