官方網站最新消息

從 On-Premise 轉移至 Cloud API 指南

Meta 已正式宣布，將在 2025 年逐步停止支援 On-Premise WhatsApp Business API。這代表目前仍透過 On-Premise 環境運行的帳號，將無法再獲得功能更新、安全維護與官方技術支援。為了確保您的業務不中斷，並能持續使用最新的 WhatsApp 功能，您需要將現有的電話號碼遷移至 WhatsApp Cloud API。

如果您過去是在其他平台透過 On-Premise API 使用 WhatsApp Business，本文件將提供您完整的操作方式，協助您順利完成遷移。

遷移現有的 Whatapp 電話號碼

適用對象：

目前使用其他平台（BSP / On-Premise API）管理 WhatsApp Business 號碼，欲轉移至本平台並使用 Cloud API。

A 方式：解除現有 On-Premise 改成 Cloud API

一、重要注意事項

  1. 號碼所有權：電話號碼歸屬於您的 WhatsApp Business Account (WABA)，不屬於任何 BSP。

  2. 歷史訊息：轉移後，過去訊息紀錄不會自動搬移。如需保留，請在遷移前備份。

  3. 停機時間：轉移過程中，該號碼將暫時無法收發訊息，通常持續數分鐘至數十分鐘。

  4. 不可回退：一旦號碼綁定 Cloud API，不可再回到 On-Premise API。

二、轉移前準備

  • 確認您擁有 Meta Business Manager 的管理員權限。

  • 確認號碼能接收 OTP（簡訊或語音電話）。

  • 通知相關團隊轉移時間，以避免影響業務運作。

三、轉移流程

Step 1. 釋放號碼（在舊平台操作）

  1. 登入您目前使用的 BSP 或 On-Premise API 平台。

  2. 找到該電話號碼設定，並 解除綁定 / 停用 API 連線。

  3. 確認號碼已釋放，不再顯示為佔用狀態。

Step 2. 參考整合文章綁定

  1. 重新嘗試透過 WhatsApp WhatsApp (Cloud API) 方式整合。

B 方式：刪除並重新建立號碼的方式

在某些情況下，如果您無法透過官方的 號碼遷移 (Number Migration) 流程，仍可選擇將現有的 WhatsApp Business API 號碼 刪除並重新建立。

然而，採用此方式會帶來以下影響：

  • 所有既有資產將會遺失，包括 顯示名稱 (Display Name)、已批准的訊息範本 (Message Templates)、品質評分 (Quality Rating) 與 發送限制 (Messaging Limits)。

  • 在刪除與重新註冊的過程中，號碼將有一段不可避免的 停機時間，期間無法收發訊息。

操作步驟

  1. 登入 Meta Business Manager

    • 前往 Meta Business Manager。

    • 使用擁有管理權限的帳號登入。

  2. 進入 WhatsApp 帳號管理

    • 在左側選單找到 業務設定 (Business Settings)。

    • 點選 Accounts > WhatsApp Accounts (WhatsApp 帳號)。

  3. 選擇目標號碼

    • 找到您要刪除的 WhatsApp Business 號碼。

    • 點選 Phone Numbers (電話號碼)。

  4. 刪除號碼

    • 在該號碼設定中，選擇 刪除 (Remove / Delete)。

    • 系統會提示確認，完成後該號碼會從 WABA 中移除。

  5. 重新建立並綁定 Cloud API

如何停用 WhatsApp Business 電話號碼的兩步驗證 (2FA)

如果您的號碼是透過 WhatsApp Business 解決方案供應商 (BSP) 連接的，您需要聯繫該供應商來協助停用該號碼的 2FA。您將無法自行執行以下操作。

  1. 依照前述步驟登入您的 WhatsApp Business Manager。

  2. 在左側面板，前往 Account Tools（帳號工具） > Phone Numbers（電話號碼）。

  3. 在您想要停用 2FA 的號碼上，點擊 Settings（設定）。

  4. 前往 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。

常見問題 (FAQ)

  1. 轉移後訊息不見了？

    • 這是正常現象，Cloud API 不會帶入舊訊息。

  2. 收不到 OTP 驗證碼？

    • 請確認號碼可正常收發 SMS 或語音電話。

    • 建議在非高峰時段重新嘗試。

  3. 能否回到 On-Premise？

    • 不行。一旦號碼轉到 Cloud API，就無法回退。

  4. 收費會改變嗎？

    • 會。Cloud API 採用 Meta 官方對話收費標準，可能和原來的費用不同。

Previous疑難雜症NextWhatsApp (Twilio)

Last updated