登入開始免費試用
Meta Tech Provider

連接後號碼顯示 Pending 或 Offline

在 WhatsApp Manager 中,Offline 是 WhatsApp Business 應用程式號碼加入 Cloud API 前的正常狀態,並不代表是否符合資格。完成 Coexistence 連接後,Meta 的檢查標準是 is_on_biz_app 為 true 且 platform_type 為 CLOUD_API,而只有狀態為 connected 才能收發訊息。若號碼仍顯示 Pending 或 Offline,請先檢查這些欄位,再重新連接。

easyCoexistence 全天候監控每個已連接號碼,在時間線上記錄 Meta 的斷線原因,並讓你自己的 AI 透過 get_number_health 讀取即時狀態。

connected

Meta 規定,商業電話號碼必須處於 connected 狀態,才能透過 API 收發訊息。

PENDING

Meta 電話號碼 API 所列的連接狀態,包括 CONNECTED、DISCONNECTED、FLAGGED、RESTRICTED 與 RATE_LIMITED。

is_on_biz_app

當 platform_type 為 CLOUD_API 時,Meta 會測試號碼能否同時與 Cloud API 及 WhatsApp Business 應用程式運作。

Skip

Meta 建議平台略過 Coexistence 號碼的電話號碼註冊,因為該號碼已完成註冊。

133010

Cloud API 在號碼已附加至帳戶但從未註冊時所回傳的錯誤。

BLOCKED

當號碼未能通過一項或多項訊息傳送要求時,Meta 健康狀態所回傳的 can_send_message 值。

Pending 和 Offline 在哪裡顯示?

它們是 Meta 的標籤,顯示在 WhatsApp Manager > 號碼 中,並反映在 Meta API 為該號碼回傳的狀態中。它們並非 easyCoexistence 的標籤。我們的控制台有自己的標籤:Connected、Degraded、Disconnected、Banned / restricted、Suspended 及 Unknown,由我們對品質、斷線事件和封鎖的監控來設定。

兩個視圖回答的是不同問題,因此可能暫時出現不一致。WhatsApp Manager 顯示 Meta 此刻如何分類該號碼;我們的控制台則顯示連接是否正常運作,並在號碼的時間線上記錄每次變化。兩者不一致時,以下述的即時欄位為準。

連接前顯示 Offline 是否正常?

是的。只存在於 WhatsApp Business 應用程式的號碼尚未加入 Cloud API,因此即使 WhatsApp Manager 有列出,也可能顯示 Offline 或 Offline / Unverified。此狀態不會阻止 Coexistence,也不代表是否符合資格;只有 Meta 的連接步驟才能決定這點。

請勿嘗試在 WhatsApp Manager 中透過註冊或要求發送驗證碼來讓號碼上線。那是遷移路徑,會將號碼移出 WhatsApp Business 應用程式。Coexistence 是透過 Meta 的註冊視窗、在應用程式中掃描 QR code 來連接號碼,而 Meta 建議平台略過該號碼的註冊。

完成連接後應顯示什麼?

Meta 提供一項精確的測試,手機也會以清晰的文字確認。若連接後數分鐘,WhatsApp Manager 仍顯示舊標籤,請先重新載入頁面再採取行動;下列欄位才是可靠的檢查方法。

  • 號碼上的 Meta 欄位:is_on_biz_app 為 true,且 platform_type 為 CLOUD_API。
  • Meta 狀態:connected,這是透過 API 收發訊息的必要條件。
  • 手機上:WhatsApp Business 應用程式顯示該號碼已連接至 API。
  • 應用程式中:設定 > 帳戶 > Business Platform 會列出服務提供者。

如果欄位顯示號碼已離開商業應用程式,怎麼辦?

這表示該號碼很可能是以 SMS 或語音驗證碼而非 QR code 完成驗證。那是遷移路徑,而非 Coexistence:號碼會離開 WhatsApp Business 應用程式(is_on_biz_app 為 false),在未註冊的情況下留在 Cloud API 上,而首次傳送會失敗並回傳錯誤 133010。我們已於 2026 年 10 月 19 日驗證過一個真實個案。

之後便無法再以 Coexistence 完成連接。有兩個出路,兩者都需要服務提供者的團隊協助:讓號碼只留在 API 上並完成註冊,或將號碼退回應用程式,再以 QR code 重新連接。在 Coexistence 連接期間,切勿在 Meta 的視窗中要求發送驗證碼。

數星期後顯示 Offline 或 Disconnected

曾經運作、其後中斷的號碼,情況有所不同。若手機上的 WhatsApp Business 應用程式約 14 天未被開啟,Meta 便會斷開 Coexistence 號碼,並在 account_update Webhook 中以 PRIMARY_INACTIVITY 回報。Meta 所回報的其他原因包括:已連結的裝置約 30 天未被使用、手機更換了號碼,以及該號碼在另一部裝置上重新註冊。

在 easyCoexistence 上,控制台會以 Disconnected 顯示該號碼,並附上 Meta 的原因,帳戶擁有人亦會收到電郵。因不活動而斷線的修復方法,是在該手機上開啟應用程式,讓其同步,然後重新連接。透過 API 傳送的訊息不會計算為開啟應用程式。

你或你的 AI 如何檢查即時狀態?

請讓你的 AI 執行 get_number_health,或以淺白的語言要求它檢查你的 WhatsApp 號碼健康狀態。該工具會讀取 Meta 對號碼的即時快照(status、platform_type、is_on_biz_app 及 quality),並回傳其監控時間線的最近 15 項事件。coexistence_link_ok 欄位總結號碼是否仍與應用程式連結。此外,easyCoexistence 會讀取 Meta 的健康狀態,並在傳送狀態變為 BLOCKED 時電郵通知帳戶擁有人。

Part of a get_number_health result for a healthy Coexistence number (illustrative)
{
  "live_snapshot": {
    "status": "CONNECTED",
    "platform_type": "CLOUD_API",
    "is_on_biz_app": true,
    "quality_rating": "GREEN"
  },
  "coexistence_link_ok": true
}

常見錯誤

  • 連接前在 WhatsApp Manager 中註冊號碼,以清除 Offline。那是遷移路徑,會將號碼移出商業應用程式。
  • 在 Meta 的視窗中要求發送 SMS 或語音驗證碼。Coexistence 連接使用的是在應用程式中掃描的 QR code。
  • 一見到 Pending 便移除並重新連接,卻未先檢查 is_on_biz_app 與 platform_type。
  • 把控制台的標籤當作 Meta 的狀態。兩者來自不同的檢查,應以即時欄位為準。
使用 EasyCoexistence 完成這項設定

號碼會留在 WhatsApp Business 應用程式中,而你的自動化會透過 Meta 官方 API 在該號碼上運作。每個號碼每月 US$ 9 起,號碼越多單價越低,最低降至 US$ 0.75,前 3 天免費。

常見問題

可以在顯示 Pending 時傳送訊息嗎?

Meta 規定號碼須處於 connected 狀態才能透過 API 收發訊息,因此在此之前 API 傳送會失敗。手機上的應用程式仍會正常運作。

Offline 是否代表手機已關機?

本身並非如此。API 不需要應用程式在每個時刻都開啟;Meta 強制的是每 14 天至少在該手機上開啟應用程式一次。

為什麼控制台顯示 Connected,WhatsApp Manager 卻顯示 Pending?

當 Meta 完成註冊後,控制台便會將號碼標記為 Connected,之後再依品質、斷線及封鎖情況更新。get_number_health 則直接讀取 Meta 的即時狀態。

客戶的訊息仍會送達手機嗎?

會。無論 API 顯示何種狀態,WhatsApp Business 應用程式仍會在手機上接收及傳送訊息。

繼續閱讀

準備開始嗎?

幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期