從 On-Premise 轉移至 Cloud API 指南
Last updated
Meta 已正式宣布，將在 2025 年逐步停止支援 On-Premise WhatsApp Business API。這代表目前仍透過 On-Premise 環境運行的帳號，將無法再獲得功能更新、安全維護與官方技術支援。為了確保您的業務不中斷，並能持續使用最新的 WhatsApp 功能，您需要將現有的電話號碼遷移至 WhatsApp Cloud API。
如果您過去是在其他平台透過 On-Premise API 使用 WhatsApp Business，本文件將提供您完整的操作方式，協助您順利完成遷移。
目前使用其他平台（BSP / On-Premise API）管理 WhatsApp Business 號碼，欲轉移至本平台並使用 Cloud API。
號碼所有權：電話號碼歸屬於您的 WhatsApp Business Account (WABA)，不屬於任何 BSP。
歷史訊息：轉移後，過去訊息紀錄不會自動搬移。如需保留，請在遷移前備份。
停機時間：轉移過程中，該號碼將暫時無法收發訊息，通常持續數分鐘至數十分鐘。
不可回退：一旦號碼綁定 Cloud API，不可再回到 On-Premise API。
確認您擁有 Meta Business Manager 的管理員權限。
確認號碼能接收 OTP（簡訊或語音電話）。
通知相關團隊轉移時間，以避免影響業務運作。
登入您目前使用的 BSP 或 On-Premise API 平台。
找到該電話號碼設定，並 解除綁定 / 停用 API 連線。
確認號碼已釋放，不再顯示為佔用狀態。
重新嘗試透過 WhatsApp WhatsApp (Cloud API) 方式整合。
在某些情況下，如果您無法透過官方的 號碼遷移 (Number Migration) 流程，仍可選擇將現有的 WhatsApp Business API 號碼 刪除並重新建立。
然而，採用此方式會帶來以下影響：
所有既有資產將會遺失，包括 顯示名稱 (Display Name)、已批准的訊息範本 (Message Templates)、品質評分 (Quality Rating) 與 發送限制 (Messaging Limits)。
在刪除與重新註冊的過程中，號碼將有一段不可避免的 停機時間，期間無法收發訊息。
操作步驟
登入 Meta Business Manager
前往 Meta Business Manager。
使用擁有管理權限的帳號登入。
進入 WhatsApp 帳號管理
在左側選單找到 業務設定 (Business Settings)。
點選 Accounts > WhatsApp Accounts (WhatsApp 帳號)。
選擇目標號碼
找到您要刪除的 WhatsApp Business 號碼。
點選 Phone Numbers (電話號碼)。
刪除號碼
在該號碼設定中，選擇 刪除 (Remove / Delete)。
系統會提示確認，完成後該號碼會從 WABA 中移除。
重新建立並綁定 Cloud API
重新嘗試透過 WhatsApp WhatsApp (Cloud API) 方式整合。
如果您的號碼是透過 WhatsApp Business 解決方案供應商 (BSP) 連接的，您需要聯繫該供應商來協助停用該號碼的 2FA。您將無法自行執行以下操作。
依照前述步驟登入您的 WhatsApp Business Manager。
在左側面板，前往 Account Tools（帳號工具） > Phone Numbers（電話號碼）。
在您想要停用 2FA 的號碼上，點擊 Settings（設定）。
前往 Two-step Verification（兩步驗證），然後選擇 Turn off two-step verification（停用兩步驗證）。
如果您沒有看到這些選項，就需要聯繫您目前的服務供應商，請他們為您停用 WhatsApp 號碼的 2FA。更多資訊可參考 Facebook 官方文件 https://developers.facebook.com/docs/whatsapp/on-premises/reference/settings/two-step-verification#disable。
轉移後訊息不見了？
這是正常現象，Cloud API 不會帶入舊訊息。
收不到 OTP 驗證碼？
請確認號碼可正常收發 SMS 或語音電話。
建議在非高峰時段重新嘗試。
能否回到 On-Premise？
不行。一旦號碼轉到 Cloud API，就無法回退。
收費會改變嗎？
會。Cloud API 採用 Meta 官方對話收費標準，可能和原來的費用不同。
Last updated