account_update Webhook 與所有斷線原因
account_update 是 Meta 用來回報連接狀態變更的方式。其 event 欄位說明發生的事件；如屬移除，disconnection_info.reason 會指出原因。這個原因決定號碼會否恢復，還是已經永久失效。
account_update 會攜帶哪些事件？
應用程式從 WhatsApp Business 帳戶解除安裝時，會傳送 PARTNER_REMOVED。這是權威的斷線訊號，也是值得用來建立處理邏輯的訊號，不應透過欄位變為 false 來推斷斷線。
號碼完全解除接入時，會傳送 ACCOUNT_OFFBOARDED。先前移除的連接恢復時，會傳送 ACCOUNT_RECONNECTED。至於執法事件，則包括 ACCOUNT_RESTRICTION 和 ACCOUNT_VIOLATION，以及名稱包含 DISABLED 或 BAN 的事件。
驗證及核准結果也會在這裡傳送，事件名稱包含 VERIFIED 或 APPROVED。處理程式應根據事件名稱分流，並將任何未識別事件視為資訊，而不是因而失敗，因為 Meta 可能在未有通知下新增事件。
斷線原因有哪些？
共有 6 個，代表的情況截然不同。
PRIMARY_INACTIVITY 是約 14 天的規則：主要裝置沒有開啟 WhatsApp Business 應用程式。這種情況可以恢復，而且最常見。
COMPANION_INACTIVITY 是伴隨裝置的不活動，原理相同，但時限較長，約為 30 天。
BUSINESS_DOWNGRADE 表示號碼已切換回一般 WhatsApp 應用程式，因此 Coexistence 結束，因為 Coexistence 需要 WhatsApp Business 應用程式。
CHANGE_NUMBER 表示電話號碼本身已變更。USER_RE_REGISTERED 表示號碼已在新裝置重新註冊。ACCOUNT_DISCONNECTED 表示客戶主動中斷連接，或由執法措施中斷。
原因也會與 disconnection_info.initiated_by 一併傳送，用來說明是由人士還是系統執行該操作。
為何原因比事件更重要？
因為單靠 PARTNER_REMOVED，無法告訴您應採取甚麼行動。
因 PRIMARY_INACTIVITY 而移除的號碼會恢復：商戶開啟應用程式、重新連接後，一切便會恢復。若將這種情況當作客戶離開，就會向仍然是客戶的人士發出取消電郵。
因 BUSINESS_DOWNGRADE 或 ACCOUNT_DISCONNECTED 而移除的號碼，情況則不同。若將其當作暫時中斷，連接便可能永遠停留在未決狀態。
移除事件完全沒有原因時，initiated_by 是後備訊號：由人士執行的移除可視為有意操作，而無法解釋的系統移除則不能如此判定。這項區分應在程式碼中處理，而不是留待日後透過支援對話處理。
常見錯誤
- 將所有 PARTNER_REMOVED 視為相同。原因可區分短暫 14 天沉寂與已離開的客戶。
- 欄位變為 false 時便推斷斷線，而不是根據這個事件判斷。這會造成錯誤警報。
- 遇到未識別事件名稱便失敗。Meta 會新增事件，處理程式應略過不認識的事件。
EasyCoexistence 會按名稱處理所有這些事件，在連接時間線記錄原因，並區分可恢復的不活動移除與真正失效的號碼。
常見問題
PARTNER_REMOVED 是永久性的嗎？
通常不是。大部分事件都帶有 PRIMARY_INACTIVITY，表示應用程式沒有被開啟；重新連接後一切便會恢復。
重新連接會恢復我的 Webhook 目的地嗎？
不會，這正是容易忽略的地方。目的地是應用程式訂閱上的 override，並會隨應用程式一併解除安裝，因此必須重新套用。
COMPANION_INACTIVITY 是甚麼？
這是伴隨裝置而非主要裝置的不活動情況，原理相同，但時限較長，約為 30 天。
事件可以沒有原因嗎？
可以。發生這種情況時，disconnection_info.initiated_by 是唯一可用來判斷是否有意操作的訊號。
繼續閱讀
準備開始嗎？
幾分鐘內設定 WhatsApp Coexistence，而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期