遷移到 WhatsApp Cloud API 的好處
WhatsApp Cloud API 是一個新平台，它為企業提供與 WhatsApp'基礎設施的直接連接，與透過 WhatsApp 合作夥伴 (BSP) 相比，它是一種自助服務選項。 使用 WhatsApp Cloud API 的一些好處包括：
更具成本效益的選擇。
與平台的連接更加可靠且穩定。
能夠建立適合您特定業務需求的客製化整合。
適用於各種規模企業的精神且可擴展的解決方案。
在此處以了解有關 WhatsApp Cloud API 的更多資訊。
哪些內容會被遷移？
請注意，以下元素可以從 WhatsApp BSP 遷移到 WhatsApp Cloud API。
可以遷移
無法遷移
遷移前需求：遷移設定需要準備什麼
請注意本文檔中經常使用的短語：
-Source WABA：我們正在從中遷移的 WhatsApp BSP。
-目的地 WABA：我們正在遷移到的 WhatsApp Cloud API。
遷移前要求清單：
現有的 Meta 開發者應用程式： 如果您尚未建立開發者應用程序， 請按一下此處在 Meta Business Manager (MBM) 中建立您的應用程式並開始使用 WhatsApp Cloud API。 此應用程式必須在與來源 WABA 相同的商業帳戶（商業 ID）下建立。
業務 ID： 來源和目標 WABA 必須與相同的 MBM 關聯或具有相同的業務 ID。
業務驗證： 必須驗證業務 ID。 如果您的企業尚未驗證， 請依照以下步驟進行驗證。
WABA 審核狀態：源和目標 WABA 的審核狀態必須獲得批准。
付款 方法： 必須為來源和目標 WABA 配置付款方式。 確保在來源地和目的地都設定了付款方式。
兩步驟驗證：必須在要遷移的電話號碼上停用兩步驟驗證。
當以上所有檢查完成後，遷移過程就可以繼續。
設定電話號碼和 WABA ID
Meta 將 WABA ID 設計為不可遷移。 由於某些限制，已實施一種解決方法。 要進行電話號碼遷移，來源和目標 WABA ID 必須位於同一個 Meta 業務經理帳戶下。 這意味著遷移電話號碼只會導致該號碼在 WABA 之間轉移，而不會允許任何其他變更。 若要成功移轉電話號碼，必須執行下列步驟：
為目標 WABA 增加一個新號碼：這將為您希望遷移到的號碼產生一個新的 WABA ID。 如果您現有的 WABA 號碼不再使用，則可以跳過此步驟。
從目標 WABA 中刪除新號碼：這將騰出一個位置，用於將號碼新增至目標 WABA。 或者，如果您有一個未使用的號碼，您可以刪除該號碼。
刪除號碼後，繼續將客戶'的當前號碼移轉到新的 WhatsApp 業務。
遷移過程的 API 文檔
值得注意的是，目前，API 文件中概述的這些遷移步驟只能由開發人員或具有類似技術背景的人員執行。 然而，我們知道這對某些人來說可能是一個限制，我們正在努力在未來開發出更用戶友好和易於訪問的解決方案。 需要幫助嗎？ 聯絡我們這裡！
步驟 1：開始電話號碼遷移
回呼網址：
發布 <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>
姓名 | 在 | 必需的 | 類型 | 描述 |
|---|---|---|---|---|
版本 | 小路 | 真的 | 細繩 | API 版本。 |
瓦巴伊德 | 小路 | 真的 | 細繩 | WhatsApp 雲端 API WABA ID。 |
前往 業務管理器 > 業務設定 > 帳戶 > WhatsApp 業務帳戶 尋找 WhatsApp 業務帳戶的 ID。 選擇您要使用的帳戶。 將出現一個包含帳戶資訊（包括 ID）的面板。
參數
標題
授權：持有人 {Access Token}
系統使用者在 Business Manager 的 WhatsApp Business Accounts 標籤中產生您的存取權杖。 閱讀 本指南 了解如何存取系統使用者並建立或複製系統使用者。
身體
姓名 | 類型 | 描述 |
|---|---|---|
副本 | 數量 | 正在註冊的電話號碼的數位國家代碼。注意：國家代碼不需要加號 (+)。 |
電話號碼 | 數量 | 正在遷移的電話號碼，不含國家代碼或加號 (+)。 |
遷移電話號碼 | 布林值 | 設定為 true 以遷移電話號碼。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回覆
{
"id": "phoneNumberId"
}
步驟 2：請求代碼 (PIN) 來驗證手機所有權
回調URL
發布 <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>
姓名 | 在 | 必需的 | 類型 | 描述 |
|---|---|---|---|---|
版本 | 小路 | 真的 | 細繩 | API 版本。 |
電話號碼 | 小路 | 真的 | 細繩 | 這是在步驟 1 中傳回的回應。 在此步驟中，將號碼複製並貼上到回呼 URL 中。 |
參數
標題
授權：持有人 {Access Token}
身體
姓名 | 類型 | 描述 |
|---|---|---|
程式碼方法 | 列舉 | 接收註冊碼的方法。 支援的值：SMS 和 Voice。 |
語言 | 列舉 | 您希望接收註冊碼的語言。 參見語言代碼。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回覆
{
"success": true
}
代碼已透過所選方法（簡訊或語音）傳送至正在遷移的電話號碼。
步驟3：驗證程式碼
回調URL
發文： <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>
步驟 2 中透過電話號碼收到的代碼（6 位密碼）將用於驗證所有權。
參數
標題
授權：持有人 {Access Token}
身體
姓名 | 類型 | 描述 |
|---|---|---|
程式碼 | 數量 | 完成第2步後收到6位數註冊碼。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回覆
{
"success": true
}
確認手機所有權已驗證。
步驟4：註冊電話號碼
回調URL
發布 <https://graph.facebook.com/{version}/{phoneNumberId}/register>
參數
標題
授權：持有人 {Access Token}
身體
姓名 | 類型 | 描述 |
|---|---|---|
訊息傳遞產品 | 列舉 | 使用的訊息服務。 在這種情況下，請使用 "whatsapp"。 |
別針 | 數量 | 步驟 2 之後收到的 6 位數註冊碼。 |
地位
姓名 | 描述 |
|---|---|
200 正常 | 成功。 |
回覆
{
"success": true
}
該電話號碼已成功註冊至 WhatsApp Cloud API WABA。 現在您可以向目的地 WABA 發送訊息。
WABA ID 未遷移。 新移轉的號碼將與先前刪除的號碼的 WABA ID 相關聯。
步驟 5：在 Meta Developer App 中檢查已移轉的電話號碼
可以透過 Meta Developer App 驗證遷移是否成功。 為此，請按照下列步驟操作：
導覽至 WhatsApp > 入門
在電話號碼下拉清單中，確認號碼存在且準確反映。
