經由內嵌註冊在 WhatsApp Business 帳號之間轉移電話號碼

本文件說明如何經由內嵌註冊將商家電話號碼從一個 WhatsApp Business 帳號(WABA)轉移至另一個帳號。

顧客可以在 WhatsApp Business 帳號(WABA)之間轉移他們的商家電話號碼,並保留其顯示名稱、品質評分、範本訊息傳遞限制、官方商業帳號狀態,以及經核准的高品質範本。通常只有在顧客希望將其商家電話號碼從一個解決方案合作夥伴移動至另一個解決方案合作夥伴時,才會執行轉移。

為顧客執行轉移的選擇有兩種:經由內嵌註冊進行轉移,或以程式設計進行轉移。

經由內嵌註冊進行轉移較簡單,是首選解決方案,因其可由顧客發起、自動產生並授予所有必要資產的所有權、授予應用程式存取這些資產的權限,且需要的 API 呼叫次數較少。

程式設計轉移必須由您發起,且涉及更多 API 呼叫,因為您必須驗證依賴資產是否配置正確、必須自行產生所有新的必要資產,且必須將其與其他資產建立關聯。因此,只有在您準備使用代理者模式與顧客合作時,才建議進行程式設計轉移(即您將建立並擁有目的地 WABA 及其資產,並與顧客分享這些資產)。

如果您想以程式設計轉移顧客電話號碼,請參閱以程式設計在 WhatsApp Business 帳號之間轉移電話號碼文件。

運作方式

顧客可以實作內嵌註冊(第 2 版)來啟動移轉程序。內嵌註冊將提示顧客輸入其商家電話號碼和新的目的地 WhatsApp Business 帳號(WABA)。

當顧客完成流程後,內嵌註冊會產生成新的 WABA、將其與 Meta 商業帳號建立關聯、授予應用程式存取 WABA 的權限,然後傳回新建的 WABA 編號和商家電話號碼編號。

您必須擷取這些編號並將其搭配 API 使用,以分享您的帳號額度、訂閱 Webhooks 並註冊該號碼以搭配雲端 API 使用。當您完成最後一步(註冊)後,商家電話號碼將與目的地 WABA 重新建立關聯,然後您就可以使用該號碼再次傳送和接收訊息。

由於顧客的商家電話號碼不會變更,因此其顯示名稱、品質評分、訊息傳遞限制和官方商業帳號狀態都將保留。

此外,所有符合資格的範本都會在目的地 WABA 中自動複製,並被授予與其來源對應範本相同的狀態,且可以繼續使用上傳在顧客商家電話號碼上的所有多媒體。

WhatsApp Business 帳號

內嵌註冊會自動產生顧客的新 WABA、將其與顧客的 Meta 商業帳號建立關聯,並授予應用程式存取 WABA 的權限。

範本

範本會在目的地 WABA 中自動複製,並被授予與來源對應範本相同的品質評分和狀態。

只有同時滿足 statusAPPROVEDquality_scoreGREEN 條件的範本才符合複製的資格。如果目的地 WABA 無法容納所有新範本,我們會盡量複製更多範本,直到達到目的地 WABA 的範本限制。如果目的地 WABA 需要使用未被複製的範本,則必須重新建立並提交該範本進行審核。

帳單

轉移完成前傳送的訊息將向舊解決方案合作夥伴收費。轉移完成前傳送的未送達訊息將向舊解決方案合作夥伴收費(如果這些訊息是在轉移完成後送達)。

轉移完成後傳送的訊息將向新解決方案合作夥伴收費。

停機時間

停機時間會在您執行最後一步(註冊)之後才開始。在此之前,商家電話號碼可用於傳送和接收訊息而不被打斷。

當您執行最後的註冊步驟之後,停機時間將開始並持續到我們完成範本複製

完成後,商家電話號碼可再次用於傳送和接收訊息,這些訊息將與顧客的新 WABA 建立關聯。

速率限制

轉移程序中自動觸發的範本複製不計入速率限制,但是您執行的 API 呼叫則會確實計入限制。

限制

  • 由 WhatsApp 發出的測試商家電話號碼無法轉移。
  • 轉移的商家電話號碼只能註冊與雲端 API 搭配使用。
  • 如果來源 WABA 位於內部部署 API 上,系統將不會轉移訊息記錄和上傳的多媒體。
  • 商家電話號碼必須擁有已核准的顯示名稱(name_statusAPPROVED)。
  • 商家電話號碼不能有任何相關聯的處理中顯示名稱變更要求。

必備條件

顧客

要求擁有商家電話號碼的顧客確認是否符合以下必備條件。如果他們擁有自己的 WABA,可以使用 Meta 企業管理平台進行確認,方法是前往 WhatsApp 帳號 >(顧客的 WABA 名稱)> 設定。如果顧客沒有自己的 WABA,則必須要求他們的 BSP 確認。

  • 顧客的 Meta 商業帳號狀態必須為已驗證
  • 顧客現有的 WABA 狀態必須為已核准
  • 顧客現有的 WABA 必須附加有效的付款方式(在付款設定中)。
  • 顧客的商家電話號碼必須停用雙步驟驗證。擁有 WABA 的顧客可以使用 WhatsApp 管理工具停用號碼的雙步驟驗證,否則必須要求解決方案供應商為他們停用雙步驟驗證。

解決方案供應商

必須至少有一個應用程式已訂閱目的地 WABA 上的 Webhooks(請參閱 Webhooks),且您必須使用已開啟連線階段記錄的內嵌註冊第 2 版。

轉移步驟

步驟 1:指示顧客停用雙步驟驗證

如果您尚未執行停用,請指示您的顧客使用 WhatsApp 管理工具在其商家電話號碼上停用雙步驟驗證(或要求顧客現有的解決方案供應商為他們停用雙步驟驗證)。

您必須先停用雙步驟驗證,才能完成其餘步驟。

步驟 2:顯示內嵌註冊

指示顧客存取您的內嵌註冊(第 2 版)實作,並於流程中出現提示時提供商家電話號碼及顯示名稱。

步驟 3:擷取資產編號

當顧客完成流程後,擷取裝載中傳回的商家電話號碼編號和新 WABA。

步驟 4:分享帳號額度

與 WABA 分享您的帳號額度,就像您通常會在經由內嵌註冊加入顧客後進行的操作一樣。

步驟 5:訂閱 Webhooks

在顧客的新 WABA 上為應用程式訂閱 Webhooks

步驟 6:註冊雲端 API 的電話號碼

註冊商家電話號碼以搭配雲端 API 使用(您無法註冊搭配內部部署 API 使用的已轉移商家電話號碼)。