錯誤 131060:Coexistence 號碼上的不受支援訊息
錯誤 131060 會以 messages Webhook 中 type 為 unsupported 的訊息送達,其標題為「此訊息目前無法使用。」,Meta 表示這在 Coexistence 號碼上屬預期情況:多發生於用戶首次向商家發訊息時,常見於點擊 Click-to-WhatsApp 廣告之後,通常數秒內便會恢復。該訊息本身仍可在手機的 WhatsApp Business 應用程式中閱讀。
easyCoexistence 會把不受支援的訊息排除在自動化之外,因此你的 AI 絕不會回覆它無法讀取的訊息;設定轉發網址時,仍會將 Meta 的載荷轉發給你的系統。
Meta 為收到的、目前無法使用的訊息所定的代碼,標題為「此訊息目前無法使用。」
Meta 表示,該錯誤通常在數秒內解決,之後 WhatsApp 便會正常送達訊息。
Meta 指出的主要情況:WhatsApp 用戶首次向商家發訊息,常見於點擊 Click-to-WhatsApp 廣告之後。
同一 Webhook 中另有不同代碼:Cloud API 完全不支援該訊息類型。
easyCoexistence 的自動化不會在不受支援的訊息上運行;同一聊天中下一則可讀訊息才會觸發。
131060 的 Webhook 包含什麼?
這是一個普通的 messages Webhook,其訊息的 type 為 unsupported,並包含 errors 陣列。錯誤項目的代碼為 131060,標題為「此訊息目前無法使用。」,其描述文字與標題相同。unsupported 物件會列明 Meta 無法轉發的內容類型;Meta 列出的值包括 image、interactive、reaction 和 poll_creation。由於沒有文字內容,也沒有媒體 ID,載荷中無法得知客戶寫了什麼。發送方號碼、訊息 ID 和時間戳照常存在。
{
"object": "whatsapp_business_account",
"entry": [{
"id": "<WABA_ID>",
"changes": [{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "<BUSINESS_NUMBER>",
"phone_number_id": "<PHONE_NUMBER_ID>"
},
"contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
"messages": [{
"from": "5511999998888",
"id": "wamid.HBgN...",
"timestamp": "1762876800",
"type": "unsupported",
"errors": [{
"code": 131060,
"title": "This message is currently unavailable.",
"message": "This message is currently unavailable."
}],
"unsupported": { "type": "<UNSUPPORTED_TYPE>" }
}]
}
}]
}]
}為什麼會出現在 Coexistence 號碼上?
Meta 的 Coexistence 指南稱,合作夥伴「可能會收到附帶錯誤代碼 131060 的不受支援訊息 Webhook」,並表示這屬預期情況。指南列出兩種情況。
第一種是 WhatsApp 用戶首次向商家發訊息,Meta 表示,當用戶點擊 Click-to-WhatsApp 廣告並隨即發送訊息時尤為常見。第二種是 WhatsApp 用戶在不受支援的附屬裝置上,向商家發送或從商家接收訊息。
Meta 沒有解釋其機制。但其所述更為重要:該錯誤通常在數秒內解決,之後 WhatsApp 便會正常送達訊息。
收到此訊息時,商家應怎樣做?
在應用程式中閱讀。Meta 給平台的指示是,要告知商家在 WhatsApp Business 應用程式中查看該訊息,因為即使 API 副本無法使用,手機上的應用程式仍有該訊息。
實際操作:在手機上打開該聊天,閱讀客戶的內容並從手機回覆;或等待客戶的下一則訊息,該訊息通常會透過 API 正常送達,不會出現此錯誤。從手機回覆也會讓自動化得知有人員正在處理該聊天。對於廣告活動,在新對話開始時出現少量此類訊息屬正常,並非故障。
你的軟件和 AI 應如何處理?
應視之為已知事件,而非故障。與處理任何送達的 Webhook 一樣,以 200 回應,以免 Meta 重新發送。記錄訊息 ID 和發送者,以便之後將其與隨後的對話連結。切勿把空白訊息當作文字交給 AI,因為沒有內容,任何回覆都只是猜測。另外,應對 131060 事件的發生率設定警報,而非單一事件。
- 盡快回覆 200,並以訊息 ID 去重,與任何 Webhook 相同。
- 對 type 為 unsupported 的訊息,跳過 AI 回覆和關鍵字比對。
- 讓團隊知道有一則訊息正在手機上的應用程式中等候處理。
- 在控制台中將 131060 與真正的故障分開計算。
自動化會在不受支援的訊息上運行嗎?
在 easyCoexistence 上,不會。自動化讀取文字、按鈕和清單回覆、媒體說明文字,以及「[語音訊息]」之類的佔位符;type 為 unsupported 的訊息沒有這些內容,因此沒有任何自動化會回覆它,也不會產生執行記錄。若已設定轉發網址,你的系統仍會收到 Meta 的原始載荷,包括錯誤。在直接模式下,Meta 會將其直接傳送到你的伺服器。
該用戶之後的下一則可讀訊息會照常觸發自動化。由於該聊天尚未儲存任何內容,「首次訊息」自動化(例如歡迎回覆)會回覆那則下一則訊息。
131060 與 131051 有何不同?
兩者在同一 messages Webhook 中都以 type 為 unsupported 送達,因此在日誌中容易混淆。它們對規劃的意義截然相反:一個是會自行修復的短暫中斷,另一個是 API 對該內容的永久限制。處理程序中應讀取 errors[0].code,而非 type,以區分兩者。下表概括了 Meta 參考資料對各代碼的說明。
| 131060 | 131051 | |
|---|---|---|
| Title | This message is currently unavailable. | Message type unknown |
| Meaning | The message cannot be passed on right now | The Cloud API does not support that type |
| Typical cause | First contact on a Coexistence number, often after an ad tap | Content the API never delivers |
| How long | Usually clears within seconds | Permanent for that content |
| What to do | Read it in the WhatsApp Business app | Ask the customer for text, or read it in the app |
常見錯誤
- 對單一 131060 事件發出警報。Meta 表示在 Coexistence 號碼上屬預期情況;應改為監察發生率。
- 讓 AI 回覆空白訊息。載荷沒有文字,回覆內容必然是捏造的。
- 以錯誤狀態回應 Webhook。Meta 會重新發送失敗的 Webhook,因此一則不受支援的訊息會變成多次送達。
- 以為訊息已遺失。訊息仍在 WhatsApp Business 應用程式中,只是 API 副本無法使用。
號碼仍保留在手機的應用程式中,原始訊息可在那裡閱讀。每個號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,前 3 天免費試用。
常見問題
可以透過 API 取得原始內容嗎?
Meta 對 131060 的指引是查看 WhatsApp Business 應用程式。其 Webhook 參考資料並未說明之後可透過任何方式取回內容。
131060 代表號碼已損壞嗎?
不是。如果一般聯絡人的訊息持續數小時都以 131060 送達,可請你的 AI 執行 get_number_health,或檢查連接;但首次接觸時的一陣集中出現屬正常情況。
只使用 Cloud API 的號碼也會出現嗎?
Meta 在其針對以 WhatsApp Business 應用程式完成接入的號碼指南中,描述了首次接觸的模式,而 Coexistence 正是此類情況。該代碼本身載於 Meta 的一般 Webhook 參考資料中,因此在任何號碼上都應以相同方式處理。
此情況會被收費嗎?
這是一則接收的訊息。Meta 會就其發出的訊息按每則計費,並按類別和國家計算,記入你自己的 WhatsApp Business 帳戶。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期