> For the complete documentation index, see [llms.txt](https://help.firstline.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.firstline.cc/feature/channels/shi-yong-embedded-signup-zheng-he/xun-xi-cuo-wu-ma-yu-pai-cha.md).

# 訊息錯誤碼與排查

整理 WhatsApp 常見訊息發送錯誤碼、可能原因與建議處理方式，協助快速判斷問題發生位置。

當 WhatsApp 訊息發送失敗時，Meta 可能會回傳錯誤碼。錯誤碼通常可以協助判斷問題屬於收件者狀態、訊息頻率、範本、帳號限制、授權權限或 Meta 服務異常。

建議先從 FIRST LINE 的訊息發送失敗紀錄確認錯誤碼，再依下表處理。

{% hint style="info" %}
錯誤碼與限制規則可能由 Meta 調整。若同一錯誤持續發生，建議同時確認 [WhatsApp Manager](https://business.facebook.com/wa/manage/home) 的電話號碼與帳號狀態，以及 [Meta Status](https://metastatus.com/) 是否有服務異常。
{% endhint %}

## 常見錯誤碼

| 錯誤碼                | 代表情況                         | 建議處理方式                                                                               |
| ------------------ | ---------------------------- | ------------------------------------------------------------------------------------ |
| `131026`           | 訊息無法送達                       | 確認收件者電話號碼確實有使用 WhatsApp；請收件者更新 WhatsApp 至最新版本，並確認可以主動傳訊息給企業號碼。                       |
| `131049`           | Meta 基於訊息互動品質或行銷訊息限制，未傳送此訊息  | 不要立即重複發送相同範本。建議至少隔一段時間後再嘗試，並檢查是否屬於 Meta 對單一使用者的行銷訊息限制。                               |
| `130472`           | 收件者正在 Meta 的特定實驗範圍內，因此訊息未送出  | 這通常不是 FIRST LINE 設定問題。可稍後再嘗試，或改以其他適用方式聯繫。                                            |
| `131050`           | 收件者已停止接收企業的行銷訊息              | 不要持續重送行銷範本。該使用者已選擇停止接收這類訊息。                                                          |
| `131048`           | 發送頻率或垃圾訊息限制                  | 到 WhatsApp Manager 檢查電話號碼與範本品質。若近期有大量訊息被封鎖、檢舉或降低品質，Meta 可能暫時限制發送量。                   |
| `130497`           | 此 WhatsApp 官方帳號受到國家或地區的訊息限制  | 確認企業類型與收件者所在地是否符合 Meta 的 WhatsApp Business Messaging Policy。                         |
| `131056`           | 同一企業電話號碼短時間內對同一收件者發送過多訊息     | 暫停對該收件者發送並稍後重試；通常仍可傳送給其他收件者。                                                         |
| `131000`           | Meta 發生未明錯誤                  | 先重新嘗試一次。若持續發生，確認 Meta Status 後，再記錄發生時間、電話號碼與錯誤內容提供 FIRST LINE 支援。                    |
| `131008`           | 缺少必要參數                       | 常見於範本內容、變數或其他必要資料未完整提供。請確認範本中的所有變數都有實際值。                                             |
| `131009`           | 參數內容不正確                      | 檢查範本變數、電話號碼、按鈕網址或其他送出內容是否符合 Meta 要求的格式。                                              |
| `131016`           | Meta 服務暫時無法使用                | 先查看 Meta Status。若 Meta 服務異常，通常需要等待服務恢復後再重新發送。                                        |
| `131021`           | 發送者與收件者是同一個電話號碼              | 請改用另一個 WhatsApp 帳號進行測試，不能由企業號碼傳訊息給自己。                                                |
| `131037`           | Meta 提供的電話號碼尚未通過顯示名稱核准       | 到 WhatsApp Manager 檢查該電話號碼的顯示名稱狀態，並依 Meta 要求完成設定或審核。                                 |
| `131047`           | 已超過 24 小時客服對話期間              | 顧客超過 24 小時沒有回覆時，不能直接發送一般自由格式訊息；請改用已核准的 WhatsApp 訊息範本重新開啟對話。                          |
| `132015`           | 訊息範本已暫停                      | 到 WhatsApp Manager 查看該範本品質與狀態。範本恢復為可用狀態後才能再次發送。                                      |
| `132016`           | 訊息範本已停用                      | 此範本已無法繼續使用，通常需要重新建立內容不同的新範本並等待 Meta 核准。                                              |
| `132000`           | 範本參數數量不符                     | 檢查 FIRST LINE 送出的範本變數數量是否與 Meta 核准的範本一致。                                             |
| `132012`           | 範本參數格式不符                     | 檢查範本變數型態與內容格式，例如文字、圖片、網址或其他欄位是否符合該範本定義。                                              |
| `368`              | WhatsApp 官方帳號因政策問題暫時受到限制     | 到 WhatsApp Manager 或 Meta Business Support 查看帳號品質與政策違規通知，依 Meta 指示處理後再嘗試。            |
| `100`              | 傳送參數不正確                      | 通常代表送出的欄位不符合 Meta API 要求。若是透過 FIRST LINE 正常操作仍持續出現，請保留錯誤內容提供 FIRST LINE 支援排查。        |
| `130429` / `80007` | 發送頻率或系統速率限制                  | 暫停大量或重複發送，稍後再試，並確認 WhatsApp 官方帳號目前的發送限制與品質狀態。                                        |
| `190`              | 授權已失效、被撤銷或無法繼續存取 WhatsApp 資產 | 請由原授權人員，或具有相同管理權限的人員，重新完成 WhatsApp 授權。若近期有變更 Meta 帳號密碼、企業權限或安全設定，也請一併確認。             |
| `200`              | 缺少代表目前 WhatsApp 帳號發送訊息所需的權限  | 確認目前 Meta 帳號仍具有 Business Portfolio 與 WhatsApp 官方帳號的管理權限；若權限曾調整、移除或更換服務商，請重新完成授權後再測試。 |

## 發送失敗時，先檢查這幾項

### 1. 確認電話號碼與 WhatsApp 帳號狀態

前往 [WhatsApp Manager](https://business.facebook.com/wa/manage/home)，確認：

* 使用中的電話號碼仍存在且狀態正常。
* 電話號碼已完成必要的驗證或註冊。
* WhatsApp 官方帳號沒有受到限制。
* 發送量與品質狀態沒有異常。

### 2. 確認是否超過 24 小時

如果顧客超過 24 小時沒有主動傳送訊息給企業，FIRST LINE 不能直接使用一般文字重新聯繫，必須使用 Meta 已核准的 **WhatsApp 訊息範本**。

常見相關錯誤碼：`131047`。

### 3. 確認訊息範本仍可使用

到 WhatsApp Manager 檢查範本狀態。如果範本被暫停、停用或內容格式與送出參數不同，訊息可能無法送出。

常見相關錯誤碼：`132015`、`132016`、`132000`、`132012`、`131008`、`131009`。

### 4. 確認範本變數都有內容

如果範本包含顧客姓名、網址、圖片或其他動態資料，請確認實際送出時每個必要欄位都有值。

例如範本預期帶入顧客姓名，但該聯絡人沒有姓名資料，就可能造成訊息發送失敗。

### 5. 確認授權與管理權限仍有效

如果出現 `190` 或 `200`，通常不是訊息內容本身的問題，而是 Meta 授權或企業資產權限已失效或不足。

請確認：

* 原授權人員仍具有公司 Business Portfolio 的管理權限。
* 該 Meta 帳號仍可管理目前使用的 WhatsApp 官方帳號與電話號碼。
* 近期是否曾修改 Meta 帳號密碼、企業權限或 WhatsApp 資產設定。
* 若曾更換 WhatsApp 服務商或重新設定帳號，是否需要重新完成 FIRST LINE 授權。

無法確認時，建議由原授權人員或具有相同管理權限的人員重新完成授權，再進行訊息測試。

### 6. 確認不是 Meta 暫時性問題

如果大量顧客同時發送失敗，或錯誤碼為 `131000`、`131016`，可先查看 [Meta Status](https://metastatus.com/) 是否正在發生 WhatsApp Business Platform 服務異常。

## 仍然無法判斷？

如果依錯誤碼與上述方式仍無法解決，請保留以下資訊提供 FIRST LINE 支援：

* 發生問題的時間。
* 使用的 WhatsApp 電話號碼。
* 收件者電話號碼。
* FIRST LINE 顯示的錯誤碼與錯誤訊息。
* 使用一般訊息或哪一個 WhatsApp 訊息範本。
* 問題是單一收件者發生，還是多位收件者同時發生。

這些資訊可以協助更快判斷問題是在 FIRST LINE、WhatsApp 帳號設定、訊息內容，或 Meta 平台端。