連接後號碼顯示 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 讀取即時狀態。
Meta 規定,商業電話號碼必須處於 connected 狀態,才能透過 API 收發訊息。
Meta 電話號碼 API 所列的連接狀態,包括 CONNECTED、DISCONNECTED、FLAGGED、RESTRICTED 與 RATE_LIMITED。
當 platform_type 為 CLOUD_API 時,Meta 會測試號碼能否同時與 Cloud API 及 WhatsApp Business 應用程式運作。
Meta 建議平台略過 Coexistence 號碼的電話號碼註冊,因為該號碼已完成註冊。
Cloud API 在號碼已附加至帳戶但從未註冊時所回傳的錯誤。
當號碼未能通過一項或多項訊息傳送要求時,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 時電郵通知帳戶擁有人。
{
"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 的狀態。兩者來自不同的檢查,應以即時欄位為準。
號碼會留在 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,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期