easyCoexistence
登入開始免費試用
Meta Tech Provider

號碼停止運作:如何找出原因

當已連接號碼停止運作,原因幾乎從來不是程式碼。請按常見程度依次排查:過期的存取權杖、重新連接後遺失的 Webhook 覆寫、14 天閒置斷開、品質下降,最後是帳戶限制。

5

幾乎涵蓋所有無聲故障的原因。

190

過期存取權杖返回的錯誤,看起來就像號碼消失。

PARTNER_REMOVED

權威地回報斷開的事件。

為甚麼手機看起來一切正常?

因為 WhatsApp Business 應用程式與 API 是同一號碼上的兩個獨立介面,而幾乎每項故障只會影響其中一個。

存取權杖過期,應用程式不受影響。Webhook 覆寫被移除,應用程式不受影響。品質下降,應用程式仍不受影響。無論是哪種情況,企業仍可正常回覆客戶,看到正常行為,也沒有理由報告任何問題。

這正是應採用監察,而不是依靠有人查看控制台的原因。故障是真實的、無聲的,而最接近該號碼的人反而最不容易察覺。

應按甚麼次序檢查?

先檢查存取權杖,因為這是最常見且修復成本最低的原因。過期或失效的憑證會令每個請求以完全相同的方式失敗,看起來就像號碼已被移除。在同一帳戶保留第二個憑證,便可分辨這兩種情況。

接着檢查 Webhook 覆寫。如果曾經重新連接,目的地會隨應用程式一併被移除,因此傳送及監察仍然運作,但傳送至您的伺服器會在沒有提示的情況下失敗。

然後檢查斷開事件:account_update 事件會帶有 PARTNER_REMOVED 及原因,而 PRIMARY_INACTIVITY 表示應用程式約 14 天沒有被開啟,重新連接即可修復。

之後檢查品質。品質是透過輪詢取得,而不是主動推送。最後檢查限制,這是帳戶層級的執行措施,任何供應商都無法解除。

甚麼幾乎從來不是原因?

如果程式碼昨天仍然正常運作,而期間沒有部署,原因幾乎不會是您的程式碼。

Cloud API 穩定,其請求格式不會在您不知情的情況下改變。運作了數月的整合突然停止時,最可能是憑證、路由變更或帳戶層級事件,這些情況都可以在沒有人接觸程式碼庫的情況下發生。

值得注意的例外是範本曾被編輯。更改範本中的變數數量,會無聲地改變所有傳送者所依據的契約。這看起來像程式碼故障,但實際上是其他人在 WhatsApp Manager 中作出的內容變更。

常見錯誤

  • 先重新連接號碼。如果存取權杖已過期,這會要求企業擁有人進行根本不需要的操作。
  • 假設是程式碼出現故障。穩定的 API 加上沒有部署,表示原因在其他地方。
  • 查看手機尋找症狀。應用程式幾乎會在所有這些故障期間繼續運作。
使用 EasyCoexistence 完成這項設定

EasyCoexistence 會持續檢查全部 5 項,並在連接時間線記錄每項事件,讓排查從有日期的事件開始,而不是靠猜測。

常見問題

號碼在手機上正常運作,但甚麼都傳送不出去。我應從哪裡開始?

先檢查存取權杖。這是最常見的原因,也最像號碼已被移除。

我重新連接後,訊息仍然無法到達我的伺服器。

Webhook 覆寫已隨應用程式一併被移除,必須重新套用。我們會自動處理。

如何知道是否因為 14 天規則?

斷開時,account_update 事件會帶有原因 PRIMARY_INACTIVITY。

範本編輯會令我的訊息無法傳送嗎?

會,而且這是最像程式碼故障的原因。更改變數數量會改變所有傳送者所依據的契約。

繼續閱讀

準備開始嗎?

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

開始免費試用

驗證日期

連接故障排查