號碼停止運作:如何找出原因
當已連接號碼停止運作,原因幾乎從來不是程式碼。請按常見程度依次排查:過期的存取權杖、重新連接後遺失的 Webhook 覆寫、14 天閒置斷開、品質下降,最後是帳戶限制。
為甚麼手機看起來一切正常?
因為 WhatsApp Business 應用程式與 API 是同一號碼上的兩個獨立介面,而幾乎每項故障只會影響其中一個。
存取權杖過期,應用程式不受影響。Webhook 覆寫被移除,應用程式不受影響。品質下降,應用程式仍不受影響。無論是哪種情況,企業仍可正常回覆客戶,看到正常行為,也沒有理由報告任何問題。
這正是應採用監察,而不是依靠有人查看控制台的原因。故障是真實的、無聲的,而最接近該號碼的人反而最不容易察覺。
應按甚麼次序檢查?
先檢查存取權杖,因為這是最常見且修復成本最低的原因。過期或失效的憑證會令每個請求以完全相同的方式失敗,看起來就像號碼已被移除。在同一帳戶保留第二個憑證,便可分辨這兩種情況。
接着檢查 Webhook 覆寫。如果曾經重新連接,目的地會隨應用程式一併被移除,因此傳送及監察仍然運作,但傳送至您的伺服器會在沒有提示的情況下失敗。
然後檢查斷開事件:account_update 事件會帶有 PARTNER_REMOVED 及原因,而 PRIMARY_INACTIVITY 表示應用程式約 14 天沒有被開啟,重新連接即可修復。
之後檢查品質。品質是透過輪詢取得,而不是主動推送。最後檢查限制,這是帳戶層級的執行措施,任何供應商都無法解除。
甚麼幾乎從來不是原因?
如果程式碼昨天仍然正常運作,而期間沒有部署,原因幾乎不會是您的程式碼。
Cloud API 穩定,其請求格式不會在您不知情的情況下改變。運作了數月的整合突然停止時,最可能是憑證、路由變更或帳戶層級事件,這些情況都可以在沒有人接觸程式碼庫的情況下發生。
值得注意的例外是範本曾被編輯。更改範本中的變數數量,會無聲地改變所有傳送者所依據的契約。這看起來像程式碼故障,但實際上是其他人在 WhatsApp Manager 中作出的內容變更。
常見錯誤
- 先重新連接號碼。如果存取權杖已過期,這會要求企業擁有人進行根本不需要的操作。
- 假設是程式碼出現故障。穩定的 API 加上沒有部署,表示原因在其他地方。
- 查看手機尋找症狀。應用程式幾乎會在所有這些故障期間繼續運作。
EasyCoexistence 會持續檢查全部 5 項,並在連接時間線記錄每項事件,讓排查從有日期的事件開始,而不是靠猜測。
常見問題
號碼在手機上正常運作,但甚麼都傳送不出去。我應從哪裡開始?
先檢查存取權杖。這是最常見的原因,也最像號碼已被移除。
我重新連接後,訊息仍然無法到達我的伺服器。
Webhook 覆寫已隨應用程式一併被移除,必須重新套用。我們會自動處理。
如何知道是否因為 14 天規則?
斷開時,account_update 事件會帶有原因 PRIMARY_INACTIVITY。
範本編輯會令我的訊息無法傳送嗎?
會,而且這是最像程式碼故障的原因。更改變數數量會改變所有傳送者所依據的契約。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期