轉移

如果您的 WhatsApp Business API 用戶端有一組現有設定，而您想轉移至新的設定但保留相同的手機號碼，請參閱本文件的指示，了解如何分辨您需要作出的變更及需要採取的相關動作。

準備工作

• 備份是轉移動作中最重要的步驟。
• 您無需在轉移後重新註冊手機號碼。轉移完成後，您便可立即開始傳送訊息。
• 新舊設定的分片數量必須相同。您無法在轉移期間擴充或縮減分片數量。如果您為舊設定配置了 X 個主節點和 Y 個核心應用程式，則新設定必須擁有完全相同的主節點與核心應用程式數量。如果轉移前後的主節點與核心應用程式數量有所不同，轉移便告失敗。
• 請先嘗試轉移測試帳戶，然後再轉移正式版帳戶。
• 準備好停機應對措施，在轉移期間不要傳送訊息。無論選擇哪種轉移方式，都會出現停機時間。您必須等待轉移完成，才能再次開始傳送訊息。

設定轉移

轉移 WhatsApp Business 用戶端設定可保留應用程式設定、註冊程序資訊和加密密鑰。系統不會轉移訊息和驗證憑證資料。

由於需要在裝置之間轉移的資料數量極少，因此只會有一小段停機時間。

第 1 步：安裝新設定

參考安裝文件來設定新的 WhatsApp Business API 用戶端。

第 2 步：為新設定獲取新的驗證憑證

目前的驗證憑證在新環境中將不再有效。登入新設定，以獲取新的驗證憑證。

第 3 步：清除

• [可選] 停用雙重驗證。如果您忘記雙重驗證代碼而需要重新註冊，此步驟便十分實用。雖然您無需重新註冊亦可順利轉移，但如果備份和還原動作因未知的原因而失敗，則您可能必須重新註冊。按照停用雙重驗證代碼的指示操作。
  備註：如果您肯定雙重驗證代碼正確無誤，則可選是否進行此步驟。
• [可選] 重設任何 Webhooks。如果 Webhooks 已設為接收傳入的通知，而且您有在轉移期間更改 Webhooks 伺服器，則請在應用程式設定中停用舊版 Webhooks 伺服器。
  備註：如果您不打算在轉移後更改 Webhook 伺服器，則此為可選步驟。

第 4 步：備份目前設定中的設定資料

使用目前的驗證憑證，以備份目前 WhatsApp Business API 用戶端中的設定資料。

第 5 步：解除安裝目前設定

這會導致訊息傳送功能停機。為了儘可能縮短停機時間，請確保 WhatsApp Business API 用戶端已準備好在新環境中運行。請參閱相應安裝指南的解除安裝部分，以獲取相關指示。請確保您只解除安裝 WhatsApp Business API 用戶端，當中包括核心應用程式、網頁應用程式和主節點的 Docker 容器；請勿刪除資料庫。

第 6 步：在新設定中還原設定

如果您未準備好使用新的驗證憑證，請登入並在新設定中執行還原動作。
您的新 WhatsApp Business API 用戶端應能使用全部所需資訊運行，並已準備好傳送訊息。請務必緊記，如果您有妥善備份和還原設定，則無需重新註冊 WhatsApp 帳戶。

第 7 步：執行系統健康檢查

執行系統健康檢查，並傳送測試訊息，以驗證 WhatsApp Business API 用戶端能否正常運行。

第 8 步：[可選] 啟用雙重認證

如果您在第 3 步停用了雙重認證，則現在請重新啟用。此功能可為您的 WhatsApp 帳戶提供額外保障。

第 9 步：建立 Webhooks

設定 Webhooks，以啟用傳入通知。

第 10 步：捨棄舊資料庫

舊資料庫內存有您的舊設定、舊訊息及舊驗證憑證的資料。如果您想在日後恢復任何這些資料，則請勿捨棄舊資料庫。一旦您決定捨棄舊資料庫，請確保 WhatsApp Business API 用戶端已運行最少 14 天，而且通訊功能可正常運作，然後才刪除舊資料庫。