移轉
如果您具備現有的 WhatsApp Business API 用戶端（包含資料庫），並希望同時將用戶端和資料庫移轉到使用相同電話號碼的新設定，本文件將示範如何識別需要進行的變更及必要的相關操作。
準備工作
- 備份是移轉最重要的步驟。
- 移轉後，您無需重新註冊電話號碼。移轉完成後，即可開始傳送訊息。
- 新設定的分片數量必須與舊設定相同，在移轉期間不能增加或減少。如果您的舊設定採用 X 個主節點數和 Y 個核心應用程式數，新設定也必須具備完全相同數量的主節點和核心應用程式。如果移轉前後的主節點和核心應用程式數量不符，移轉將會失敗。
- 移轉生產帳號前，請先嘗試移轉測試帳號。
- 系統將會發生停機時間，時間長短取決於移轉選項，但每個移轉都會有停機時間。
移轉選項
移轉有數個選項，視您想要移轉的資料量而定。請選擇最符合您需求的選項。
每個移轉選項保留的資料
| 選項 1 | 選項 2 | 選項 3 | |
|---|---|---|---|
設定 | |||
應用程式設定 | ✔ | ✔ | ✔ |
註冊 | ✔ | ✔ | ✔ |
加密金鑰 | ✔ | ✔ | ✔ |
訊息 | |||
訊息 | ✔ | ✔ | |
回呼 | ✔ | ✔ | |
聯絡人 | ✔ | ✔ | |
驗證權杖 | |||
API 用戶資料 | ✔ | ||
API 驗證權杖 | ✔ |
每個移轉選項的典型使用案例和停機時間
下表說明每個移轉選項的典型使用案例和相關停機時間。這些只是典型的使用案例，您可以根據自己的需求，選擇移轉選項的類型。
| 一般使用案例 | 停機時間 | |
|---|---|---|
選項 1 | 解決方案供應商將最終用戶端移至您的平台，您希望只保留設定資料 | 相較於其他選項，此選項的停機時間最短，因為需要在電腦之間傳輸的資料量最小。 |
選項 2 | 解決方案供應商將最終用戶端移至您的平台，您希望同時保留設定和訊息資料 | 此選項的停機時間較選項 1 長，因為必須在電腦之間同時傳輸訊息和設定資料。這些資料量可能會變得相當大，視企業而定。 |
選項 3 | 由您自行管理 WhatsApp Business API 用戶端的 WhatsApp 直接用戶端，並將 WhatsApp Business API 用戶端和資料移至不同電腦 | 相較於其他選項，此選項的停機時間最長，因為必須在電腦之間傳輸完整的用戶端資料。這些資料量可能會變得相當大，視企業而定。 |
選項 1：只有設定
在「只有設定」移轉中，系統只備份和還原設定資訊，不會移轉訊息和驗證權杖資料。
步驟 1：安裝新設定
使用「安裝」文件，設定新的 WhatsApp Business API 用戶端。
步驟 2：獲得新設定的新驗證權杖
目前的驗證權杖在新環境中無效，請登入新設定以獲得新驗證權杖。
步驟 3：清除
- [選用] 停用雙重驗證。當您忘記雙重驗證碼且必須重新註冊時，這麼做很有用。雖然順利的移轉不需要重新註冊，但若因某些不明原因造成備份和還原失敗，系統可能會強制您重新註冊。請按照說明操作來停用雙重驗證碼。
注意：如果您確信雙重驗證碼是正確的，此為選用步驟。
步驟 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 天且訊息傳遞運作良好。
選項 2：設定和訊息
在「設定和訊息」移轉中，系統會同時備份和還原設定資訊及訊息，不會移轉驗證權杖資訊。
請注意需要傳輸到不同電腦的資料量。由於需要備份和還原的資料較多，相較於選項 1，其停機時間相對較長。總停機時間將因傳輸的資料量和網路延遲而有所不同。
步驟 1：清除
- [選用] 停用雙重驗證。當您忘記雙重驗證碼且必須重新註冊時，這麼做很有用。雖然順利的移轉不需要重新註冊，但若因某些不明原因造成備份和還原失敗，系統可能會強制您重新註冊。請按照說明操作來停用雙重驗證碼。
注意：如果您確信雙重驗證碼是正確的，此為選用步驟。
步驟 2：解除安裝目前的設定
這麼做會導致傳遞訊息時發生停機時間。若要讓停機時間縮減至最短，請確保 WhatsApp Business API 用戶端已準備好在新位置執行。如需操作說明，請參閱個別安裝指南的「解除安裝」部分內容。請確定只解除安裝 WhatsApp Business API 用戶端；不要刪除資料庫。
步驟 3：備份資料庫
從目前的 WhatsApp Business API 用戶端使用 mysqldump 或 pg_dump 等公用程式，備份所有資料庫（waweb 除外），其中包含使用者／驗證資料。
注意：如果您是在自己的平台對企業執行移轉的解決方案供應商，備份資料庫時切勿包含 waweb。您可能不希望轉交或送出目前儲存的驗證權杖和使用者資料。
步驟 4：還原資料庫
使用 mysqldump 或 pg_dump 等公用程式，將資料庫還原至新的 WhatsApp Business API 用戶端。
步驟 5：安裝新設定
使用「安裝」文件，設定新的 WhatsApp Business API 用戶端。務必將資料庫指向步驟 4 中的還原位置。
步驟 6：獲得新設定的新驗證權杖
目前的驗證權杖在新環境中無效，請登入新設定以獲得新驗證權杖。
執行新的 WhatsApp Business API 用戶端時，應該使用所有必要的資訊，並準備好傳遞訊息。請記住最重要的一點，如果已正確備份和還原資料庫，則不需要重新註冊 WhatsApp 帳號。
步驟 7：執行系統健康檢查
執行系統健康檢查並傳送測試訊息，以驗證 WhatsApp Business API 用戶端是否正常運作。
步驟 8：[選用] 啟用雙因素驗證
如果您在步驟 1 中停用了雙因素驗證，請立即重新啟用。這麼做可為 WhatsApp 帳號提供額外的安全性。
步驟 9：設定 Webhooks
設定 Webhooks 以啟用入站通知。
步驟 10：丟棄舊資料庫
舊資料庫包含舊設定、舊訊息和舊驗證權杖的資料。如果您想要在將來恢復上述資料，請不要丟棄舊資料庫。一旦您決定丟棄資料庫，刪除前請確定 WhatsApp Business API 用戶端已執行至少 14 天且訊息傳遞運作良好。
選項 3：完整移轉
在完整移轉中，系統會備份和還原所有設定、訊息和驗證權杖。
此選項看起來可能是最好的，但請注意需要傳輸到不同電腦的資料量。由於需要備份和還原的資料較多，相較於選項 1 和選項 2，其停機時間相對較長。
步驟 1：清除
- [選用] 停用雙重驗證。當您忘記雙重驗證碼且必須重新註冊時，這麼做很有用。雖然順利的移轉不需要重新註冊，但若因某些不明原因造成備份和還原失敗，系統可能會強制您重新註冊。請按照說明操作來停用雙重驗證碼。
注意：如果您確信雙重驗證碼是正確的，此為選用步驟。
步驟 2：備份目前的驗證權杖
權杖的最長有效期為 7 天，請確認權杖有足夠的時間供您執行移轉。
步驟 3：解除安裝目前的設定
這麼做會導致傳遞訊息時發生停機時間。若要讓停機時間縮減至最短，請確保 WhatsApp Business API 用戶端已準備好在新位置執行。如需操作說明，請參閱個別安裝指南的「解除安裝」部分內容。請確定只解除安裝 WhatsApp Business API 用戶端；不要刪除資料庫。
步驟 4：[選用] 備份資料庫
使用 mysqldump 或 pg_dump 等公用程式備份資料庫，以擷取設定、訊息和驗證權杖資料。
注意：如果只移轉 WhatsApp Business API 用戶端，但不移轉資料庫，此為選用步驟。
步驟 5：還原資料庫
使用 mysqldump 或 pg_dump 等公用程式，將資料庫還原至新的 WhatsApp Business API 用戶端。
步驟 6：安裝新設定
使用「安裝」文件，設定新的 WhatsApp Business API 用戶端。務必將資料庫指向步驟 5 中的還原位置。
執行新的 WhatsApp Business API 用戶端時，應該使用所有必要的資訊，並準備好傳遞訊息。請記住最重要的一點，如果已正確備份和還原資料，則不需要重新註冊 WhatsApp 帳號。
步驟 7：執行系統健康檢查
執行系統健康檢查並傳送測試訊息，以驗證 WhatsApp Business API 用戶端是否正常運作。
步驟 8：[選用] 啟用雙因素驗證
如果您在步驟 1 中停用了雙因素驗證，請立即重新啟用。這麼做可為 WhatsApp 帳號提供額外的安全性。
步驟 9：設定 Webhooks
設定 Webhooks 以啟用入站通知。
步驟 10：丟棄舊資料庫
舊資料庫包含舊設定、舊訊息和舊驗證權杖的資料。如果您想要在將來恢復上述資料，請不要丟棄舊資料庫。一旦您決定丟棄資料庫，刪除前請確定 WhatsApp Business API 用戶端已執行至少 14 天且訊息傳遞運作良好。