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

此文件說明如何使用內嵌註冊在不同 WhatsApp Business 帳戶之間轉移商家電話號碼。

顧客可以在不同 WhatsApp Business 帳戶之間轉移商家電話號碼,同時保留自己的顯示名稱、品質評分、範本訊息收發限制、官方商業帳戶狀態,以及已獲批准的優質範本。通常只有當顧客想將自己的商家電話號碼從某個解決方案合作夥伴轉移至另一個時,才會轉移號碼。

轉移顧客號碼的方法有兩種:經由內嵌註冊轉移,或程序化轉移。

經由內嵌註冊轉移較為簡單,也是比較推薦的解決方案,因為此程序可由顧客自行發起,而且可自動產生全部所需資產並就此授予所有權,同時向您的應用程式授予此類資產的存取權,所需的 API 呼叫數量也比較少。

程序化轉移必須由您自己發起,而且需要執行更多 API 呼叫,因為您必須驗證依賴資產的配置是否正確,也必須自行產生所有要求的新資產並將其連結至其他資產。因此,我們建議只有當您以「代理」模式與顧客合作時,亦即由您建立並擁有目標 WhatsApp Business 帳戶及其資產,再與顧客共用的情況下,才使用程序化轉移。

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

運作方式

顧客可以使用您執行的內嵌註冊(版本 2)轉移號碼。內嵌註冊會提示顧客輸入其商家電話號碼及新的目標 WhatsApp Business 帳戶。

顧客完成此流程後,內嵌註冊便會產生新的 WhatsApp Business 帳戶,再將之與顧客的 Meta 商家資產管理組合連結,接著向您的應用程式授予此 WhatsApp Business 帳戶的存取權,並傳回新建立的 WhatsApp Business 帳戶編號及商家電話號碼編號。

您必須擷取這兩個編號並將之用於 API 以共用您的信用額度、訂閱 Webhooks,以及註冊電話號碼以用於雲端 API。完成最終步驟(註冊程序)之後,商家電話號碼便會重新連結至目標 WhatsApp Business 帳戶,此號碼屆時便可以再次收發訊息。

由於顧客的商家電話號碼並沒有變更,因此其顯示名稱、品質評分、訊息收發限制及官方商業帳戶狀態都會得到保留。

此外,所有合資格範本都會自動經複製至目標 WhatsApp Business 帳戶,並獲得與原範本一樣的狀態;而所有上載至顧客商家電話號碼中的媒體亦可以繼續使用。

WhatsApp Business 帳戶

內嵌註冊會自動產生顧客的新 WhatsApp Business 帳戶並將其連結至顧客的 Meta 商業帳戶,亦會向您的應用程式授予此 WhatsApp Business 帳戶的存取權。

範本

Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.

Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.

Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.

帳單

Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.

Messages sent after migration is complete are charged to the new Solution Partner.

範本停用狀況

商家電話號碼登記程序即時開始,因此您可繼續收發訊息,不受任何干擾。

不過,範本複製需要一定時間,因此在轉移完成前,您無法使用受影響的範本。

為免出現此停用狀況,您可以先開始轉移範本,再註冊手機號碼。

速率上限

在轉移程序中自動觸發的範本複製操作不會計入限速額度。不過,您執行的 API 呼叫會計入此限制額。

限制

  • 無法轉移由 WhatsApp 發佈的測試商家電話號碼。
  • 已轉移的電話號碼只能經註冊以用於雲端 API。
  • 如果來源 WhatsApp Business 帳戶是使用內部部署 API,則無法轉移訊息記錄和已上載的媒體。
  • 商家電話號碼必須擁有經過核准的顯示名稱,即 name_statusAPPROVED
  • 商家電話號碼不能有任何關聯的顯示名稱變更待處理要求。
  • 範本的品質評分會轉移。所有已轉移範本一開始的評分都是 UNKNOWN。此評分會在頭 24 小時保持不變,其後如果有充足的可用資料,系統便會產生新的評分。

要求

顧客

請擁有商家電話號碼的顧客確認自己是否符合以下要求。如果顧客的 WhatsApp Business 帳戶由自己擁有,可以前往 WhatsApp 帳戶 > (其 WhatsApp Business 帳戶) > 設定,在 Meta 企業管理平台上加以確認。如果顧客的 WhatsApp Business 帳戶不是由自己擁有,則必須請其商業解決方案供應商確認。

  • 其 Meta 商業帳戶的狀態必須為已驗證
  • 其現有 WhatsApp Business 帳戶的狀態必須為已核准
  • 其現有 WhatsApp Business 帳戶必須在付款設定附有有效的付款方式。
  • 其商家電話號碼必須停用雙重認證。由自己擁有 WhatsApp Business 帳戶的顧客可以使用 WhatsApp 管理工具來停用電話號碼的雙重認證,否則必須請解決方案供應商為其停用雙重認證。

解決方案供應商

必須至少有一個應用程式就目標 WhatsApp Business 帳戶訂閱了 Webhooks(詳見 Webhooks),而且必須使用已啟用連線階段記錄功能的內嵌註冊版本 2。

轉移步驟

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

如果您還未指示顧客使用 WhatsApp 管理工具來停用其商家電話號碼的雙重認證,或請其目前的解決方案供應商代為停用,請先指示顧客如此操作。

必須先停用雙重認證,才能完成餘下步驟。

步驟 2:顯示內嵌註冊

引導顧客存取您執行的內嵌註冊(版本 2),並依照流程提示提供自己的商家電話號碼及顯示名稱。

步驟 3:擷取資產編號

顧客完成流程之後,擷取訊息事件中傳回的商家電話號碼編號和新 WhatsApp Business 帳戶。

步驟 4:共用您的信用額度

與 WhatsApp Business 帳戶共用信用額度,正如您平常經由內嵌註冊加入顧客後所做的那樣。

步驟 5:訂閱 Webhooks

讓您的應用程式訂閱顧客新 WhatsApp Business 帳戶的 Webhooks

步驟 6:註冊電話號碼以使用雲端 API

註冊商家電話號碼,以使用雲端 API。您不能註冊已轉移的商家電話號碼來使用內部部署 API。

疑難排解

如果範本轉移程序失敗,請參閱以下指示文件,了解如何手動觸發範本轉移:範本轉移