登入開始免費試用
Meta Tech Provider

錯誤 131060:Coexistence 號碼上的不受支援訊息

錯誤 131060 會以 messages Webhook 中 type 為 unsupported 的訊息送達,其標題為「此訊息目前無法使用。」,Meta 表示這在 Coexistence 號碼上屬預期情況:多發生於用戶首次向商家發訊息時,常見於點擊 Click-to-WhatsApp 廣告之後,通常數秒內便會恢復。該訊息本身仍可在手機的 WhatsApp Business 應用程式中閱讀。

easyCoexistence 會把不受支援的訊息排除在自動化之外,因此你的 AI 絕不會回覆它無法讀取的訊息;設定轉發網址時,仍會將 Meta 的載荷轉發給你的系統。

131060

Meta 為收到的、目前無法使用的訊息所定的代碼,標題為「此訊息目前無法使用。」

Seconds

Meta 表示,該錯誤通常在數秒內解決,之後 WhatsApp 便會正常送達訊息。

First contact

Meta 指出的主要情況:WhatsApp 用戶首次向商家發訊息,常見於點擊 Click-to-WhatsApp 廣告之後。

131051

同一 Webhook 中另有不同代碼:Cloud API 完全不支援該訊息類型。

Skipped

easyCoexistence 的自動化不會在不受支援的訊息上運行;同一聊天中下一則可讀訊息才會觸發。

131060 的 Webhook 包含什麼?

這是一個普通的 messages Webhook,其訊息的 type 為 unsupported,並包含 errors 陣列。錯誤項目的代碼為 131060,標題為「此訊息目前無法使用。」,其描述文字與標題相同。unsupported 物件會列明 Meta 無法轉發的內容類型;Meta 列出的值包括 image、interactive、reaction 和 poll_creation。由於沒有文字內容,也沒有媒體 ID,載荷中無法得知客戶寫了什麼。發送方號碼、訊息 ID 和時間戳照常存在。

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "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 參考資料對各代碼的說明。

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

常見錯誤

  • 對單一 131060 事件發出警報。Meta 表示在 Coexistence 號碼上屬預期情況;應改為監察發生率。
  • 讓 AI 回覆空白訊息。載荷沒有文字,回覆內容必然是捏造的。
  • 以錯誤狀態回應 Webhook。Meta 會重新發送失敗的 Webhook,因此一則不受支援的訊息會變成多次送達。
  • 以為訊息已遺失。訊息仍在 WhatsApp Business 應用程式中,只是 API 副本無法使用。
使用 EasyCoexistence 完成這項設定

號碼仍保留在手機的應用程式中,原始訊息可在那裡閱讀。每個號碼每月 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,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期