> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh-tw/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md).
# Zoom Chat 遷移應用程式指南
### 簡介
Zoom Chat Migration App 使用指南是一份為 IT 管理員提供的完整資源，提供將 Slack 工作空間轉移至 Zoom Chat 的逐步說明。它涵蓋在維持資料完整性與使用者通訊歷史的同時，遷移公開頻道、私人頻道與直接訊息的關鍵流程。
這項 [Zoom Chat Migration App](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) 採用雙引擎架構，將 Slack 工作空間資料轉移至 Zoom Chat 環境。系統管理員可使用多種遷移途徑。
### 遷移概覽
使用 Zoom Chat Migration App 遷移 Slack 資料有多種方式，取決於您組織的規模、Slack 方案與安全需求。
此外，您必須符合某些 Slack 與 Zoom 的先決條件、制定遷移計畫，並整合您的 Slack 工作空間。本節提供這些先決條件與考量事項的概覽。
{% embed url="" %}
#### 遷移選項
下表詳細列出最常見的遷移方式：
| 遷移方法 | 說明 | 最適合 | 需求 | 優點 |
| --------------------- | ----------------------------------------------- | ------------------------------------- | ------------------------------------------ | ------------------------------ |
| **API 遷移（以 App 為基礎）** | 使用遷移 app 直接連線至 Slack API 並傳輸資料。支援公開頻道、私人頻道與 DM。 | 較小型組織，或可行使用者授權取得的情況 | 使用者必須授權存取其私人聊天與 DM 的資料 | 可完全自動化，並直接從 Slack 無縫傳輸資料 |
| **匯入工具遷移（以檔案為基礎）** | 使用 Slack 匯出檔，透過 Zoom 的匯入工具進行資料遷移 | 使用 Slack Plus 或 Enterprise Grid 方案的組織 | 管理員必須從 Slack 管理員儀表板匯出 Slack 資料 | 不需要使用者授權；非常適合大量遷移，尤其是私人聊天 |
| **混合方式（API + 匯入）** | 結合 API 與匯入方式：公開頻道透過 API；私人頻道與 DM 透過匯入工具 | 中大型組織，希望避免使用者授權的複雜性 | 需要同時具備 Slack 匯出與以 App 為基礎的 API 遷移設定的管理員存取權 | 在維持公開頻道遷移自動化的同時，避免私人聊天的使用者授權摩擦 |
**系統限制**
遷移流程受以下特定限制約束：
* **單一工作上限**：12 個月的歷史資料
* **總遷移期間**：60 個月（5 年）
* **工作並行數**：一次只能執行一個工作
此技術架構可在維持安全協定與資料完整性的同時，系統化遷移企業通訊資料。
#### Slack 至 Zoom 資料對應
下列對應細節表可幫助您在遷移前了解 Slack 與 Zoom Chat 之間的關聯：
| Slack 功能 | Zoom Chat 對應項目 | 備註 |
| ---------------- | -------------- | ------------------------ |
| 公開頻道 | 公開頻道 | 自動遷移 |
| 私人頻道 | 私人頻道 | 需要使用者核准 |
| 直接訊息（DM） | 一對一聊天 | 需要使用者核准 |
| 群組 DM | 群組聊天 | 需要使用者核准 |
| 串狀討論 | 內嵌回覆 | 不像 Slack 那樣完整串接，但會保留回覆順序 |
| @ 提及 | @ 提及 | 相同行為 |
| 回應 | 表情符號回應 | 相同行為 |
| 檔案 | 已分享的檔案 | 需要啟用雲端儲存 |
| 釘選訊息 | 加星號訊息 | 釘選訊息會變成加星號訊息 |
| Slack 機器人/App 訊息 | 僅文字（無卡片） | 豐富的 app 卡片不會遷移 |
#### 帳戶與權限先決條件
在開始之前，您必須同時檢查 Slack 與 Zoom 的帳戶層級和管理員權限。
* 一個 **Pro、Business、Enterprise 或 Education** 需要 Zoom 帳戶。
* Slack 與 Zoom **管理員權限** 才能授權遷移。
{% hint style="info" %}
安裝 Zoom Marketplace app 的管理員必須在網頁入口網站中存取角色管理。他們必須確保自己被指派正確的聊天管理權限——必須勾選 **編輯** 核取方塊，適用於 **聊天頻道** 與 **聊天訊息** 角色。否則，由於權限不足，他們將無法授權 Zoom Slack Migration app。
{% endhint %}
* 必須為 **訊息/檔案保留**.
**Slack API：範圍、權限與速率限制**
Slack API 用於擷取您的 Slack 使用者、頻道與訊息資料。這些資料類型有速率限制，對單一 Slack 工作空間每分鐘只允許一定數量的請求。這在規劃遷移時程時是一項重要考量。
**Slack 遷移工作效能基準**
下列表格提供 Slack 遷移的估計值。
{% tabs %}
{% tab title="依遷移實作方式的效能比較分析" %}
| 遷移方法 | 資料範圍 | 每個頻道的處理時間 | 預估遷移時間\* |
| ------------ | ----- | --------- | ------------------- |
| 匯入遷移 | 約 2 週 | 5–10 秒 | 每個頻道 45 秒至 1 分 15 秒 |
| 以 API 為基礎的遷移 | 約 2 週 | 20–30 秒 | 每個頻道 3–5 分鐘 |
*\*以具有一年歷史資料的中型 Slack 工作空間為基礎*
{% endtab %}
{% endtabs %}
遷移工作會遇到兩個會直接影響實作時程與資源規劃的根本瓶頸。檔案傳輸處理限制會同時影響匯入與以 API 為基礎的遷移方式，造成在部署規劃期間需要足夠頻寬配置與傳輸最佳化策略的效能限制。以 API 為基礎的遷移工作還會因 Slack 原生 API 的速率限制機制而面臨額外的效能限制。這些限制不會影響匯入遷移，但會顯著影響以 API 為基礎的實作，需要更長的處理窗口與謹慎的工作排程，才能在遵守平台限制的同時最佳化吞吐量。
雖然您的 Slack 工作空間可能包含數百或數千個頻道，但頻道活動分布會遵循可預測的模式，這會直接影響遷移效能與資源配置需求。高活動頻道若具有大量訊息歷史、檔案附件與使用者互動，將需要上述完整的基準處理時間。不過，工作空間中的多數頻道通常活動較少——僅包含簡短對話、公告或已封存討論，因此遷移速度會比基準估計快得多。
**所需管理員權限與範圍**
Zoom App Marketplace 需要您的 Zoom 租戶中具備以下管理員權限與範圍：
* **聊天管理 > 聊天頻道 = 編輯**
* **聊天訊息 = 編輯**
Zoom 遷移工具使用內部 API，並需要以下 Zoom App 範圍：
* `chat_message:write:admin`
* `imchat:bot`
* `chat_channel:write:admin`
* `user:write:admin`
Zoom XMPP 包含一個欄位，其中含有 Slack 訊息 ID，以供驗證與歷史追蹤。
當管理員透過遷移工具連接到工作空間時，Zoom 建立的 Slack app 將自動安裝到 Slack 租戶中。該 Slack app 使用[ OAuth2 驗證](https://api.slack.com/authentication/oauth-v2) 連線至 Zoom，並提供資料遷移的授權權杖。使用者必須授權私人對話（DM、群組聊天與私人頻道）的遷移。
您也必須將 **只允許來自 Slack 目錄的 app** 設定為 **關閉**，這樣在建立工作空間連線後即可安裝 Slack app。還需要以下 Slack 範圍：
* `files:read`
* `channels:history`
* `channels:read`
* `groups:history`
* `groups:read`
* `im:history`
* `im:read`
* `mpim:history`
* `mpim:read`
* `pins:read`
* `stars:read`
* `users:read`
* `users:read.email`
#### 遷移考量事項
事先考慮遷移策略可節省精力，並確保平台之間順利轉換。以下為 Zoom 提供的高層次策略大綱：
1. 決定要遷移哪些 Slack 工作空間（1 個或多個）
2. 選擇要遷移哪些資料：
1. 公開頻道（自動遷移）
2. 私人頻道與直接訊息（DM）（需要使用者授權）
3. 機器人和/或 app 訊息
3. 決定最符合您需求的遷移方法
4. 設定遷移時間表（每個工作最多一年）
5. 與使用者溝通私人訊息核准事宜
**Slack 工作空間整合**
對於使用多個 Slack 工作空間的組織，例如 Enterprise Grid 使用者，遷移到 Zoom Chat 會將所有工作空間整合到單一帳戶中。
為了區分不同工作空間，Zoom 會將原始工作空間名稱附加到頻道與聊天名稱後方。例如：
* 原始 Slack 頻道：
* **#engineering** （工作空間為「US Team」）
* 遷移後的 Zoom 頻道：
* **#engineering: US Team**
此整合可確保所有資料遷移至單一 Zoom Chat 帳戶，同時保留原始工作空間的脈絡。共享空間可為特定團隊或部門提供額外結構，讓內容更容易整理與存取。
**聊天資料整合**
擁有超過 100 名使用者的工作空間，可能會有數萬個從未封存或刪除的私人群組聊天與 DM，即使使用者已離開公司也是如此。這會使私人遷移工作比公開工作花費顯著更長時間。
管理員應透過手動封存這些舊對話，或更新 Slack 保留期間以自動刪除它們，來清理舊資料。
Zoom 建議先確認哪些資料需要在 Zoom Chat 中保留為主動資料，以及哪些資料可封存以供未來法律、法遵、風險降低、人資或其他用途。
{% hint style="success" %}
雖然您可以將更多 Slack 資料複製到 Zoom Chat，Zoom 建議 **只複製 1 年的主動資料，並將其餘資料封存**。大多數使用者很少需要搜尋超過一年的資料來執行工作與溝通。Zoom 建議以較小的 3 到 6 個月批次建立遷移工作，以成功完成資料遷移。
{% endhint %}
另外，也應考量目前資料是存在於 Slack，還是整合到第三方服務中用於 DLP、電子蒐證或封存。
**聊天歷史保留**
從 Slack 遷移到 Zoom 時，會有數項與保留相關的考量，因為 Slack 完全基於雲端，而 Zoom 提供更細緻的保留選項：
* Zoom 同時提供本機裝置與雲端儲存。 [本機裝置儲存](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063423) 可介於 1 天到 7 年。 [雲端儲存](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0067567) 可停用或設定為 7 年保留期。
* [保留政策](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) 可在帳戶層級與群組層級為使用者設定。
* 管理員可視需要為個別頻道設定特定保留時間。
* 管理員可為 DM 或群組聊天指定一個保留政策，並為聊天頻道設定另一個政策。
* 針對聊天歷史報表，Zoom 建議儲存已編輯訊息的修訂與刪除紀錄。
請參閱 Zoom Support 文章 [儲存 Zoom Chat 訊息歷史記錄](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) 以了解更多聊天歷史保留資訊。
### 最佳做法
#### 遷移前最佳做法
請遵循以下建議，以讓遷移前流程更順利：
* 確保使用者已在 Zoom 建立帳戶，且至少已認證一次。
* 管理員已將 Slack Migration app 新增至其 Zoom 帳戶。
* 執行遷移的管理員必須同時具備兩個平台（Slack 與 Zoom Chat）的權限，且其 Zoom 與 Slack 帳戶中的電子郵件必須一致。
* 管理員必須使用 Zoom Chat Migration app 設定遷移工作，以從 Slack 執行並將資料移至 Zoom Chat。注意：此流程至少需要 2 個工作，因為至少有 1 個工作會移動私人對話，另 1 個工作會移動公開頻道。
* 管理員應封存或刪除任何不必要、且不想遷移至 Chat 的 Slack 資料，以協助加快遷移速度。
* 如果您使用 API 遷移工作來遷移私人資料，請確保使用者知道何時以及如何授權 Slack 將其資料移至 Chat。
* 如果計畫使用匯入遷移工作，請遵循 [Slack 將工作空間聊天資料匯出為 .zip 檔案的說明](https://slack.com/help/articles/201658943-Export-your-workspace-data).
* 檔案需求：
* .zip 檔案名稱不得從原始 Slack 匯出格式更改
* .zip 檔案大小不得超過 10 GB
#### 遷移最佳做法
以下流程提供遷移的高層次概覽：
1. 在遷移前，請確保使用者已在 Zoom 建立帳戶，並至少已認證一次。
2. 管理員應準備並將 Slack Migration app 新增至其 Zoom 帳戶。
3. 執行遷移的管理員必須對兩個平台擁有適當權限，且其 Zoom 與 Slack 帳戶的電子郵件地址必須一致。
4. 管理員必須在 Slack 中安裝私人 app，以連線至 Zoom 並執行 OAuth 驗證。
5. 管理員使用 Zoom Chat Migration app 設定遷移工作，將資料從 Slack 移至 Zoom Chat。這至少需要 2 個工作——一個用於私人對話，另一個用於公開頻道。
遷移時，請遵循以下建議步驟：
1. 選擇 Select Public Channels Conversation Type 並選取特定頻道，將一個頻道中的資料遷移。從您最舊的一些頻道中選取一週份的資料。
2. 建立工作以傳輸一年前之前的所有公開頻道，然後確認所有頻道都已與使用者一起建立。
3. 在確認 app 如預期運作後，建立並執行較少但時間範圍較大的工作，而不是建立較多但時間範圍較小的工作。每個工作包含相同數量的遷移步驟。
4. （選用）對私人工作遷移重複這些步驟。
資料遷移後，您的資料將如下所示：
* 公開/私人頻道與群組聊天名稱將顯示為：#channel-name: workspace-name
* 由具有有效 Zoom 帳戶的 Slack 使用者傳送的訊息，將正常顯示，就像是由那些 Zoom 使用者傳送的一樣
* 由沒有有效 Zoom 帳戶的 Slack 使用者傳送的訊息，將顯示為由已停用的 Zoom 使用者傳送，並使用 Slack 訊息傳送者的名稱
* 系統訊息將會遷移（例如：「@Some User 已加入頻道」）
* 無論其在 Slack 中的狀態如何，所有訊息都將以已讀狀態遷移
* 遷移完成通知將在完成時傳送到每個公開與私人頻道，顯示為「Message is sent from Chat Migration App, Day Date Time」
#### 刪除遷移 app
遷移 app 會在遷移後維持 Slack 與 Zoom 對話之間的 1:1 對應。
{% hint style="warning" %}
若將此 app 從您的 Zoom 帳戶移除，這些對應將會刪除，若您重新安裝並再次遷移，將會產生重複的頻道與聊天。只有在確定不再需要任何遷移時，才刪除 Chat Migration app。
{% endhint %}
### 安裝
{% embed url="" %}
若要安裝 app：
1. 登入 Zoom App Marketplace。
2. 搜尋 Chat Migration，然後按一下 **新增**.
3. 審閱並核准所需權限。
請參閱 Zoom Support 文章 [使用 Chat Migration app（Slack Migration 工具）](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) 以取得更詳細的安裝說明。
{% hint style="info" %}
管理員必須授權 Slack 工作空間帳戶或組織，以安裝並授權私人應用程式， **Message Retriever**。管理員一般也必須核准在 Slack 工作空間中使用 app，並授與所有成員使用該 app 的權限。
{% endhint %}
管理員必須授權在其 Zoom 帳戶中安裝 Chat Migration app，並在管理員角色中授與兩個 Chat Management 權限。
選項 **只允許來自 Slack App Directory 的 app** 設定必須為 **已停用**.
{% hint style="info" %}
使用此 app 的管理員必須具有 [帳戶 Admin 角色](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684#h_01FCBKK69SJNA90M1J07SSJ1YB) 才能遷移對話。他們不能是自訂管理員類型。深入了解 [識別帳戶類型、角色與授權](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060684) 與 [角色管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983) 請參閱 Zoom Support 網站。
{% endhint %}
#### 將您的 Slack 工作空間連線至 API 遷移工作
如果您未使用檔案匯入方式，這些說明將協助您連線以進行 API 遷移。
若要連線工作空間：
1. 在 Zoom 中開啟 Chat Migration App。
2. 按一下 **建立連線 > 登入 Slack** 並授權。
3. 在 Zoom 儀表板中確認工作空間連線。
#### 執行使用者同步工作
使用者同步工作會擷取 Slack 工作空間中的所有完整、啟用中的成員，並使用其電子郵件地址為其對應的 Zoom 帳戶建立 1:1 對應。
如果在 Zoom 端找不到有效 Slack 使用者的電子郵件地址，Zoom 會為該電子郵件地址建立一個新的、已停用的使用者。
如果在其他 Zoom 帳戶中找到了有效 Slack 使用者的電子郵件地址，例如個人帳戶，則該使用者將對應至一個「dummy user」設定檔。在您的 Zoom 帳戶中，此使用者將命名為 **TeamChatMigration AppUser** ，並會存在以確保您的工作空間的所有訊息資料都能遷移。
{% hint style="warning" %}
請勿刪除 **TeamChatMigration AppUser** 使用者。
{% endhint %}
### 執行遷移工作
以下章節將協助您啟動遷移所需的工作。
#### 建立匯入遷移工作
若要建立新的遷移工作：
1. 按一下 **上傳檔案**，選取您的 Slack 匯出檔，然後按一下 **上傳**.
2. 等待您的檔案上傳至 Zoom。
1. 注意：請勿離開或重新整理頁面，因為這會使檔案上傳中斷，且工作將停留在「上傳中」狀態。若發生此情況，您可以刪除「上傳中」工作並重新開始此流程
3. 當初始檔案上傳完成後， **遷移詳細資訊視窗** 將會在遷移 app 準備檔案以進行遷移時彈出。此時，您可以在等待工作可執行時關閉、離開或重新整理頁面。
4. 在工具完成準備遷移檔案後，您將能夠選取要遷移的對話類型。
5. 選取對話類型後，按一下 **執行** 以開始遷移工作。
{% embed url="" %}
#### 建立 API 遷移工作
若要建立新的遷移工作：
1. 按一下 **新遷移工作** 並選取 Slack 工作空間。
2. 選擇 **資料範圍**:
* 公開頻道（自動遷移）。
* 私人頻道與 DM（需要使用者授權）。
* 訊息的特定日期範圍。
3. 選取資料範圍與區間，且已取得使用者授權後，請選取 **執行** 以開始遷移工作。
{% hint style="warning" %}
處理私人頻道與 DM 的私人資料授權請求：
* **私人頻道與 DM 需要使用者核准** 後才能遷移。
* 一旦建立遷移工作，Zoom 會自動傳送核准電子郵件請求。
* 管理員可以追蹤哪些使用者已/尚未核准。對於私人聊天遷移，只需要一位使用者的授權即可遷移整段對話歷史。
* 授權請求電子郵件只會寄給尚未提供核准的使用者。
* 為達到最佳遷移成功率，建議約取得 60–70% 使用者的授權。
{% endhint %}
{% embed url="" %}
{% embed url="" %}
#### 執行與監控遷移工作
**啟動新的遷移工作**
若要啟動遷移工作，請執行：
1. 按一下 **執行遷移** 以開始流程。
2. 遷移時間會有所不同（大型工作空間可能需要 **12 小時以上**).
3. 在 **遷移儀表板**.
**疑難排解遷移工作**
偶爾，遷移工作可能無法回傳預期結果。下表提供遷移期間可能遇到問題的解決方案：
{% tabs %}
{% tab title="遷移疑難排解" %}
| 問題 | 解決方案 |
| ---------------------------------- | -------------------------------- |
| | |
| | 遷移 app 會自動重試 |
| | 確保他們在 Zoom 中使用相同電子郵件存在，並重新執行任何遷移 |
| {% endtab %} | |
| {% endtabs %} | |
{% embed url="" %}
### 遷移事後檢討
完成遷移後，Zoom 建議進行徹底的事後檢討，並確認您的 Slack 內容已如預期移轉至 Chat。
下表提供建議的工作，以驗證您的聊天遷移：
| 步驟 | 動作 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **驗證遷移** | - 登入 Zoom Chat，並確認頻道、訊息與檔案顯示正確。
- 登出並重新登入以重新整理聊天歷史。
|
| **修正任何缺少的資料** | - 重新傳送授權請求給尚未核准私人資料存取的使用者。
- 檢查遷移工作是否有錯誤，並重試任何失敗的工作。
|
| **（選填）停用 Slack** | - 在確認資料遷移完成後，您可以封存或移除 Slack 工作區。
|
| **一般疑難排解** | - 如果訊息遺失，請嘗試登出並重新登入 Zoom。
- 如果找不到使用者，請確認 Slack 與 Zoom 之間的電子郵件地址是否相符。
- 如果遷移失敗，請檢查記錄中的錯誤詳細資訊，並重試該流程。
|
#### 其他疑難排解檢查清單
如果您在遷移後發現其他問題，此檢查清單可提供額外步驟與可執行的驗證動作。
{% hint style="info" %}
在繼續之前，您必須取得 **來自網路呼叫的 Zoom 追蹤 ID** 並取得以下兩者 **帳戶 ID** 與 **使用者 ID**.
{% endhint %}
| 類別 | 問題描述 |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zoom 帳戶設定** | - 確認所有層級都已啟用團隊聊天功能
- 驗證所有層級皆已啟用檔案分享設定，並記錄任何檔案限制
- 驗證「允許使用者建立公開 + 私人頻道」已在所有層級啟用
|
| **Zoom 使用者問題** | - 驗證該使用者的管理員狀態
- 確認工具操作員的電子郵件在 Zoom 與 Slack 之間一致
- 驗證在 Zoom 與 Slack 中正在遷移的使用者電子郵件地址是否相符
|
| **遷移工作問題** | - 檢查工作完成狀態（通過/失敗）
- 判斷該工作是否涉及公開頻道或私人頻道／對話
|
| **如果遷移已通過，但訊息／對話不可見** | - 確認 GMT 時間範圍可正確涵蓋預期的 Slack 訊息範圍（遷移日期在 GMT 凌晨 12 點開始/結束（PST +7））
- 驗證頻道已正確建立
- 確保使用者在遷移後已登出並重新登入用戶端
- 確認遷移後的使用者已在 Zoom 中正確建立
- 驗證訊息／對話是否可在聊天記錄管理入口網站中檢視
|
| **如果遷移失敗** | - 記錄具體的錯誤訊息
- 若檔案遷移失敗，請記錄有問題的檔案名稱
- 記錄失敗後使用者採取的動作（工作重試、新建工作等）
|
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://library.zoom.com/technical-library/zh-tw/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.