重新連接 Meta 因 14 天未開啟而斷開的號碼(PRIMARY_INACTIVITY)
當主要手機上的 WhatsApp Business 應用程式約 14 天未被開啟,Meta 會結束 Coexistence 號碼的 Cloud API 部分,並回報原因為 PRIMARY_INACTIVITY。要恢復連接,請在該手機上開啟應用程式並讓它同步,然後用同一個號碼再次執行 Embedded Signup 流程。應用程式、其中的對話以及號碼本身都不會受影響。
easyCoexistence 會在 Meta 回報斷開的一刻,立即電郵通知擁有人,號碼頁面亦會說明原因:「Meta 斷開了此號碼,因為手機上的 WhatsApp Business 應用程式約 14 天未被開啟」,旁邊附有「重新連接此號碼」按鈕。
PRIMARY_INACTIVITY 斷開原因背後是主要裝置不活躍。
Meta 範例 PARTNER_REMOVED 負載中,PRIMARY_INACTIVITY 的 initiated_by 值表示由平台結束,而非由人操作。
商家於停用後重新接入同一合作夥伴時,Meta 發出的 account_update 事件。
每次接入後,用於同步聯絡人與對話歷史的時間窗口,每次接入只可用一次。
控制台建議在主要手機上開啟應用程式的間隔,比 Meta 規則短,留有餘裕。
PRIMARY_INACTIVITY 是什麼意思?
這是 Meta 在主要裝置無活動時,移除 Coexistence 號碼 API 所給出的原因。Meta 會發出 account_update Webhook,事件為 PARTNER_REMOVED,而 disconnection_info 內的原因為 PRIMARY_INACTIVITY,文件說明為主要裝置約 14 天無活動。在 Meta 的範例負載中,initiated_by 為 SYSTEM。
主要裝置是在 WhatsApp Business 應用程式內持有該號碼的手機。它本身沒有任何改變:客戶照常發訊息,團隊照常回覆,對話也保留原處。停止運作的是 API 部分。透過 Cloud API 的發送會失敗,Webhook 不再送達,自動化、AI 回覆及相連系統在該號碼上全部靜默,直至重新連接為止。
為什麼沒有人察覺斷開?
因為最接近號碼的人仍在用手機,而手機仍然運作正常。API 部分結束時,應用程式並不會顯示提示,因此店舖可能連續數天以為自動化仍在回覆,而客戶只能在有人拿起手機時才收到回覆。
常見情況是:商家已連接號碼,並為其系統設定 AI 回覆或 Webhook,之後團隊改用 WhatsApp Web 或第二部裝置工作,主要手機則被放進抽屜。已連結裝置不會令主要手機保持活躍。WhatsApp 亦表示,主要裝置長時間不活躍,會令帳戶登出其配套裝置,因此那部放在抽屜的手機,最終連同這些裝置一併失效。
重新連接後需要重做什麼?
重新連接即是透過 Embedded Signup 進行全新接入,因此以下幾項會作為新的決定重新出現,而非自動沿用。
- Webhook 目的地。Meta 將其儲存為服務提供者應用程式訂閱的覆寫設定,而
PARTNER_REMOVED會將其與應用程式一併移除。必須重新設定。 - 對話歷史。應用程式會再次詢問是否分享,並開啟新的 24 小時窗口,以同步聯絡人與歷史記錄。
- 舊連接發出的存取權杖可能已失效,重新連接後請重新取得憑證。
- Meta 保留 Coexistence 現有的帳戶 ID,因此 WhatsApp Business 帳戶與之前相同。
斷開期間發出的訊息怎麼辦?
這些訊息如常送到手機上的 WhatsApp Business 應用程式,因此商家並沒有損失任何訊息。不過,你的系統在該段期間沒有收到任何內容,因為服務提供者的應用程式已從帳戶中移除。自動化無法回覆那些對話,AI 代理也從未看見它們。
重新連接後,請在應用程式內查看斷開期間到達的對話,並回覆仍在等候的訊息。若你的系統需要這些訊息,隨新接入提供的歷史同步是唯一的取回方式:當商家同意分享,且在重新連接後 24 小時內儲存直接 Webhook 目的地時,可匯入最多六個月的一對一對話。已開啟自動化的號碼無法匯入。
如何防止再次發生?
定期在主要手機上開啟 WhatsApp Business 應用程式,並保持手機在線,讓它同步。Meta 的規則以主要裝置為準,而根據我們的監察,透過 API 發送或接收的訊息不會計作該裝置的活動。Meta 公布的是約 14 天,並非確切時數,因此每週一次的習慣可留有足夠餘裕。
商家常見的做法包括:為負責手機的人設定定期的日曆提醒;把主要手機放在櫃檯,而不是抽屜;至少從手機回覆部分對話,而非只用 WhatsApp Web。能於當日報告斷開的監察,可把一週的靜默,縮短至數分鐘的停機。
與其他斷開有何不同?
原因欄位能區分手機長時間無人使用,與號碼真正失效,兩者各有不同的解決方法。
PRIMARY_INACTIVITY:應用程式約 14 天未開啟。請開啟應用程式,然後重新連接同一號碼。COMPANION_INACTIVITY:已連結裝置約 30 天未使用。請在手機上開啟應用程式,然後重新連接。USER_RE_REGISTERED:號碼已在新裝置上註冊。請從現時持有該號碼的手機重新連接。CHANGE_NUMBER或BUSINESS_DOWNGRADE:換用了另一個號碼,或已改回消費者版應用程式。需要新建連接。- 限制屬於執法決定,並非斷開連接。重新連接不會解除限制。
設定方法
- Open the app on the primary phoneOpen WhatsApp Business on the phone that holds the number, with mobile data or Wi-Fi on, and wait until the chats finish syncing.
- Start the connect flow againOn the number's page in the dashboard, click "Reconnect this number", or start Embedded Signup from your provider, and log in with a Meta account that administers the business portfolio.
- Choose the same portfolio and numberPick the same business portfolio and WhatsApp Business Account. In our experience Meta recognizes the number and offers, pre-checked, to restore what it had before.
- Confirm on the phoneScan Meta's QR code from inside the WhatsApp Business app, confirm the connection and decide whether to share chat history.
- Check delivery end to endConfirm the webhook destination is set, send a test message from a customer phone, and check that your automation or system answered it.
常見錯誤
- 手機仍離線或應用程式未開啟時便執行連接流程。請先開啟應用程式並讓它同步,否則重新連接可能在手機步驟失敗。
- 以為 Webhook 目的地會隨連接一併恢復。Meta 會隨應用程式將其移除,因此在重新設定之前,你的系統將保持靜默。
- 把 PARTNER_REMOVED 及 PRIMARY_INACTIVITY 視為客戶已離開。這是最容易恢復的斷開情況。
- 依賴 WhatsApp Web 的活動來保持號碼運作。該規則監察的是主要手機,而閒置的主要手機同樣會令其配套裝置登出。
重新連接後,已儲存的訊息目的地會自動恢復,自動化亦會再次回覆。每個號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
是否精確為 14 天?
Meta 記載為主要裝置約 14 天無活動,並未公布確切時數。至少每 10 天開啟一次應用程式,或每週一次,即可避開邊界。
客戶會察覺斷開嗎?
不會直接察覺。他們的訊息照常送到手機上的應用程式。他們所察覺的,是在號碼重新連接前,自動回覆會停止。
我的代理商或開發人員可以代我重新連接嗎?
他們可以用管理 Business Portfolio 的 Meta 登入,完成瀏覽器部分的操作,但確認步驟需在 WhatsApp Business 應用程式內完成,因此必須由持有手機的人參與。
號碼斷開期間我會被收費嗎?
使用 easyCoexistence 時,號碼在斷開期間仍保留在你的方案內,因為偵測此類斷開正是監察的用途,重新連接也不會增加收費。如要停止收費,請移除該號碼。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期