# 從 On-Premise 轉移至 Cloud API 指南

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

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

## 遷移現有的 Whatapp 電話號碼 <a href="#id-1-migrate-an-existing-whatapp-phone-number" id="id-1-migrate-an-existing-whatapp-phone-number"></a>

#### **適用對象：**

目前使用其他平台（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 [](https://help.firstline.cc/feature/channels/whatsapp-cloud-api "mention") 方式整合。

***

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

{% hint style="warning" %}
在某些情況下，如果您無法透過官方的 **號碼遷移 (Number Migration)** 流程，仍可選擇將現有的 WhatsApp Business API 號碼 **刪除並重新建立**。<br>

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

* 所有既有資產將會遺失，包括 **顯示名稱 (Display Name)**、**已批准的訊息範本 (Message Templates)**、**品質評分 (Quality Rating)** 與 **發送限制 (Messaging Limits)**。
* 在刪除與重新註冊的過程中，號碼將有一段不可避免的 **停機時間**，期間無法收發訊息。
  {% endhint %}

**操作步驟**

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 [](https://help.firstline.cc/feature/channels/whatsapp-cloud-api "mention") 方式整合。

***

## 如何停用 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 官方對話收費標準，可能和原來的費用不同。