> 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 遷移應用程式實作指南》是 IT 管理員的完整資源，提供將 Slack 工作區轉移到 Zoom Chat 的逐步說明。它涵蓋遷移公開頻道、私人頻道和直接訊息的必要流程，同時維持資料完整性與使用者通訊歷史。
此 [Zoom Chat 遷移應用程式](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) 採用雙引擎架構，將 Slack 工作區資料轉移至 Zoom Chat 環境。系統管理員可使用多種遷移路徑。
### 遷移概覽
您可以使用 Zoom Chat 遷移應用程式以多種方式遷移 Slack 資料，視組織規模、Slack 方案與安全性需求而定。
此外，您必須符合某些 Slack 與 Zoom 的前置條件、制定遷移計畫，並整併您的 Slack 工作區。本節將概述這些前置條件與考量。
{% embed url="" %}
#### 遷移選項
下表詳細說明最常見的遷移方式：
| 遷移方式 | 說明 | 最適合 | 需求 | 優點 |
| -------------------- | ----------------------------------------------- | ------------------------------------- | --------------------------------------- | ------------------------------ |
| **API 遷移（以應用程式為基礎）** | 使用遷移應用程式直接連線至 Slack API 並傳輸資料。支援公開頻道、私人頻道與 DMs。 | 較小型的組織，或可行取得使用者授權的情況 | 使用者必須授權存取其私人聊天與 DMs 資料 | 可完全自動化，並直接從 Slack 無縫傳輸資料 |
| **匯入工具遷移（以檔案為基礎）** | 使用 Slack 匯出檔案，透過 Zoom 的匯入工具遷移資料 | 使用 Slack Plus 或 Enterprise Grid 方案的組織 | 管理員必須從 Slack 管理員儀表板匯出 Slack 資料 | 不需要使用者授權；非常適合大量遷移，尤其是私人聊天 |
| **混合方式（API + 匯入）** | 結合 API 與匯入方式：公開頻道透過 API；私人頻道與 DMs 透過匯入工具。 | 中大型組織，希望避免使用者授權複雜性的情況 | 同時具備 Slack 匯出與以應用程式為基礎的 API 遷移設定之管理員存取權 | 在維持公開頻道遷移自動化的同時，避免私人聊天的使用者授權阻礙 |
**系統限制**
遷移流程受以下特定限制約束：
* **單一工作上限**：12 個月的歷史資料
* **遷移總時間範圍**：60 個月（5 年）
* **工作並行**：一次只能執行一個工作
此技術架構可在維持安全協定與資料完整性的同時，有系統地遷移企業通訊資料。
#### Slack 到 Zoom 資料對應
下表中的對應詳細資訊可協助您在遷移前了解 Slack 與 Zoom Chat 之間的關聯：
| Slack 功能 | Zoom Chat 對應項目 | 備註 |
| ---------------- | -------------- | ------------------------- |
| 公開頻道 | 公開頻道 | 自動遷移 |
| 私人頻道 | 私人頻道 | 需要使用者核准 |
| 直接訊息（DMs） | 1 對 1 聊天 | 需要使用者核准 |
| 群組 DMs | 群組聊天 | 需要使用者核准 |
| 串聯討論串 | 內嵌回覆 | 不會像 Slack 那樣完整串線，但會保留回覆順序 |
| @ 提及 | @ 提及 | 行為相同 |
| 回應 | 表情符號回應 | 行為相同 |
| 檔案 | 已共享檔案 | 需要啟用雲端儲存 |
| 釘選訊息 | 加星標訊息 | 釘選訊息會變成加星標 |
| Slack 機器人／應用程式訊息 | 僅文字（無卡片） | 豐富應用程式卡片不會遷移 |
#### 帳戶與權限前置條件
在繼續之前，您必須確認 Slack 與 Zoom 帳戶層級及管理員權限。
* A **Pro、Business、Enterprise 或 Education** 需要 Zoom 帳戶。
* Slack 與 Zoom **管理員權限** 才能授權遷移。
{% hint style="info" %}
在網頁入口網站中安裝 Zoom Marketplace 應用程式的管理員必須存取角色管理。他們必須確保已指派正確的聊天管理權限—— **編輯** 必須勾選 **聊天頻道** 與 **聊天訊息** 角色。否則，由於權限不足，他們將無法授權 Zoom Slack Migration 應用程式。
{% 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 應用程式範圍：
* `chat_message:write:admin`
* `imchat:bot`
* `chat_channel:write:admin`
* `user:write:admin`
Zoom XMPP 包含一個欄位，內含 Slack 訊息 ID，用於驗證真實性與歷史追蹤。
由 Zoom 建置的 Slack 應用程式會在管理員透過遷移工具連線至工作區時，自動安裝到 Slack 租戶中。Slack 應用程式使用[ OAuth2 驗證](https://api.slack.com/authentication/oauth-v2) 與 Zoom 連線，並提供資料遷移的授權權杖。使用者必須授權私人對話（DMs、群組聊天與私人頻道）的遷移。
您也必須將以下選項設為 **僅允許來自 Slack 目錄的應用程式** 轉換為 **關閉**，這樣 Slack 應用程式才能在建立工作區連線後安裝。以下 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 工作區（一個或多個）
2. 選擇要遷移的資料：
1. 公開頻道（自動遷移）
2. 私人頻道與直接訊息（DMs）（需要使用者授權）
3. 機器人與／或應用程式訊息
3. 決定最符合您需求的遷移方式
4. 設定遷移時程（每個工作最多可達一年）
5. 與使用者溝通私人訊息核准事宜
**Slack 工作區整併**
對於使用多個 Slack 工作區的組織，例如 Enterprise Grid 使用者，遷移至 Zoom Chat 會將所有工作區整併為單一帳戶。
為了區分各工作區，Zoom 會在頻道名稱與聊天名稱後附加原始工作區名稱。例如：
* 原始 Slack 頻道：
* **#engineering** （工作區為「US Team」）
* 遷移後的 Zoom 頻道：
* **#engineering: US Team**
此整併可確保所有資料遷移至單一 Zoom Chat 帳戶，同時保留原始工作區脈絡。共享空間可為特定團隊或部門提供額外結構，讓內容更容易整理與存取。
**聊天資料整併**
超過 100 名使用者的工作區，可能會有數以萬計從未封存或刪除的私人群組聊天與 DMs，即使使用者已離開公司也一樣。這會使私人遷移工作的耗時顯著長於公開工作的遷移。
管理員應透過手動封存這些舊對話，或更新 Slack 保留期限以自動刪除它們，來清理舊資料。
Zoom 建議您確認哪些資料需要在 Zoom Chat 中保留為活動資料，哪些資料可為未來的法律、合規、風險緩解、人力資源或其他用途而封存。
{% hint style="success" %}
雖然您可以將更多 Slack 資料複製到 Zoom Chat，但 Zoom 建議 **僅複製一（1）年的活動資料，其餘封存**。大多數使用者幾乎不需要搜尋超過一年的資料即可執行工作與溝通。Zoom 建議將遷移工作分成較小的三到六個月批次，以成功完成資料遷移。
{% 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) 可在帳戶與群組層級為使用者設定。
* 管理員可視需要為個別頻道設定特定保留時間。
* 管理員可為 DMs 或群組聊天指定一項保留政策，並為聊天頻道設定另一項政策。
* 若要進行聊天歷史報表，Zoom 建議儲存已編輯訊息的修訂版與刪除記錄。
請參閱 Zoom 支援文章 [儲存 Zoom Chat 訊息歷史](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) 以深入了解聊天歷史保留。
### 最佳做法
#### 遷移前的最佳做法
請遵循以下建議，以便讓遷移前流程更順利：
* 確保使用者已在 Zoom 建立帳戶，且至少已驗證一次。
* 管理員已將 Slack Migration 應用程式加入其 Zoom 帳戶。
* 執行遷移的管理員必須同時具備兩個平台（Slack 與 Zoom Chat）的權限，且其 Zoom 與 Slack 帳戶中的電子郵件必須相符。
* 管理員必須使用 Zoom Chat Migration 應用程式設定遷移工作，以執行並將資料從 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 應用程式加入其 Zoom 帳戶。
3. 執行遷移的管理員必須在兩個平台上擁有適當權限，且其 Zoom 與 Slack 帳戶的電子郵件地址必須一致。
4. 管理員必須在 Slack 中安裝私人應用程式，以連線至 Zoom 並執行 OAuth 驗證。
5. 管理員使用 Zoom Chat Migration 應用程式設定遷移工作，以將資料從 Slack 移至 Zoom Chat。這至少需要 2 個工作——一個用於私人對話，另一個用於公開頻道。
遷移時，請遵循以下建議步驟：
1. 透過選取 Select Public Channels 對話類型並選擇特定頻道，從一個頻道遷移資料。從一些最舊的頻道中選取一週的資料量。
2. 建立工作以傳輸一年以前的所有公開頻道，然後驗證所有頻道是否已隨使用者一同建立。
3. 在確認應用程式如預期運作後，請建立並執行較少的工作，但使用較大的時間範圍，而不是建立較多工作且時間範圍較小。每個工作都包含相同數量的遷移步驟。
4. （選用）對私人工作遷移重複這些步驟。
資料遷移後，您的資料會如下所示：
* 公開／私人頻道與群組聊天名稱會顯示為：#channel-name: workspace-name
* 由具有有效 Zoom 帳戶的 Slack 使用者傳送的訊息，將會正常顯示，如同由那些 Zoom 使用者傳送一般
* 由沒有有效 Zoom 帳戶的 Slack 使用者傳送的訊息，將會顯示為由一個已停用的 Zoom 使用者傳送，名稱為 Slack 訊息傳送者的名稱
* 系統訊息也會遷移（例如：「@Some User 已加入頻道」）
* 所有訊息都會以已讀狀態遷移，不論它們在 Slack 中的狀態如何
* 完成後，每個公開與私人頻道都會收到一則遷移完成通知，顯示為「訊息由 Chat Migration App 傳送，日期 時間」
#### 刪除遷移應用程式
遷移應用程式會在遷移後維持 Slack 與 Zoom 對話之間的一對一對應。
{% hint style="warning" %}
從您的 Zoom 帳戶移除此應用程式將刪除這些對應，若您重新安裝並再次遷移，將會產生重複的頻道與聊天。只有在確定不再需要任何後續遷移時，才應刪除 Chat Migration 應用程式。
{% endhint %}
### 安裝
{% embed url="" %}
若要安裝應用程式：
1. 登入 Zoom App Marketplace。
2. 搜尋 Chat Migration，然後按一下 **新增**.
3. 檢閱並核准必要權限。
請參閱 Zoom 支援文章 [使用 Chat Migration 應用程式（Slack Migration 工具）](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) 以取得更詳細的安裝說明。
{% hint style="info" %}
管理員必須授權 Slack 工作區帳戶或組織安裝並授權私人應用程式， **Message Retriever**。管理員必須一般性地核准在 Slack 工作區中使用應用程式，並授權所有成員使用該應用程式。
{% endhint %}
管理員必須授權在其 Zoom 帳戶中安裝 Chat Migration 應用程式，並在管理員角色中提供兩個 Chat Management 權限。
以下選項： **僅允許來自 Slack App Directory 的應用程式** 設定必須是 **預設為停用**.
{% hint style="info" %}
使用該應用程式的管理員必須擁有 [帳戶管理員角色](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 支援網站。
{% endhint %}
#### 為 API 遷移工作連線您的 Slack 工作區
如果您未使用檔案匯入方式，這些說明將協助您連線以進行 API 遷移。
若要連線工作區：
1. 在 Zoom 中開啟 Chat Migration App。
2. 按一下 **建立連線 > 登入 Slack** 並授權。
3. 在 Zoom 儀表板中確認工作區連線。
#### 執行使用者同步工作
使用者同步工作會擷取您 Slack 工作區中的所有完整有效成員，並透過其電子郵件地址建立與對應 Zoom 帳戶的一對一對應。
如果在 Zoom 端找不到某位有效 Slack 使用者的電子郵件地址，Zoom 會為該電子郵件地址建立一個新的已停用使用者。
如果某位有效 Slack 使用者的電子郵件地址已在其他 Zoom 帳戶中找到，例如個人帳戶，則該使用者將會對應到「dummy user」設定檔。在您的 Zoom 帳戶中，此使用者將命名為 **TeamChatMigration AppUser** ，並會存在以確保您工作區的所有訊息資料都能遷移。
{% hint style="warning" %}
請勿刪除 **TeamChatMigration AppUser** 使用者。
{% endhint %}
### 執行遷移工作
以下章節將協助您啟動遷移所需的工作。
#### 建立匯入遷移工作
若要建立新的遷移工作：
1. 按一下 **上傳檔案**，選取您的 Slack 匯出檔案，然後按一下 **上傳**.
2. 等待您的檔案上傳至 Zoom。
1. 注意：請勿離開或重新整理頁面，否則會使檔案上傳停滯，且工作會卡在「上傳中」狀態。如果發生這種情況，您可以刪除「上傳中」工作並重新開始此流程
3. 初始檔案上傳完成後， **遷移詳細資訊視窗** 會在遷移應用程式準備檔案以進行遷移時彈出。此時，您可以關閉、離開或重新整理頁面，等待工作準備好執行。
4. 工具完成準備檔案以進行遷移後，您就可以選擇要遷移的對話類型。
5. 選擇對話類型後，按一下 **執行** 以開始遷移工作。
{% embed url="" %}
#### 建立 API 遷移工作
若要建立新的遷移工作：
1. 按一下 **新遷移工作** ，然後選擇 Slack 工作區。
2. 選擇 **資料範圍**:
* 公開頻道（自動遷移）。
* 私人頻道與 DMs（需要使用者授權）。
* 訊息的特定日期範圍。
3. 在選取資料範圍與區間，並取得使用者授權後，請選擇 **執行** 以開始遷移工作。
{% hint style="warning" %}
處理私人頻道與 DMs 的私人資料授權請求：
* **私人頻道與 DMs 需要使用者核准** 後才能遷移。
* 遷移工作建立後，Zoom 會自動傳送核准電子郵件請求。
* 管理員可以追蹤哪些使用者已核准／尚未核准。若要遷移私人聊天，只需要一位使用者的授權即可遷移整段對話歷史。
* 授權請求電子郵件只會寄給尚未提供核准的使用者。
* 為了獲得最佳遷移成功率，目標應取得約 60–70% 使用者的授權。
{% endhint %}
{% embed url="" %}
{% embed url="" %}
#### 執行與監控遷移工作
**啟動新的遷移工作**
若要啟動遷移工作，請執行：
1. 按一下 **執行遷移** 以開始流程。
2. 遷移時間會有所不同（大型工作區可能需要 **12 小時以上**).
3. 請在 **遷移儀表板**.
**遷移工作疑難排解**
有時，遷移工作可能無法產生預期結果。下表提供遷移期間可能遇到問題的解決方案：
{% tabs %}
{% tab title="遷移疑難排解" %}
| 問題 | 解決方案 |
| ------------------------------------ | ------------------------------- |
| | |
| | 遷移應用程式會自動重試 |
| | 確認他們在 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 中已正確建立已移轉的使用者
- 在 Chat History 管理員入口網站中驗證訊息／對話可見性
|
| **如果移轉失敗** | - 記錄具體的錯誤訊息
- 針對檔案移轉失敗，記錄有問題的檔案名稱
- 記錄失敗後所採取的使用者動作（重新嘗試工作、建立新工作等）
|
---
# 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.