> 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/zoom-workplace/zoom-chat/zoom-team-chat-migration-app-field-guide.md).
# Zoom 聊天迁移应用指南
### 简介
Zoom 聊天迁移应用现场指南是面向 IT 管理员的综合资源，提供将 Slack 工作区转移至 Zoom 聊天的分步说明。其涵盖迁移公开频道、私密频道和私信的关键流程，同时保持数据完整性和用户通信历史记录。
该 [Zoom 聊天迁移应用](https://marketplace.zoom.us/apps/5ZXfqVPZSfqBYeCR9VLsBg) 采用双引擎架构，将 Slack 工作区数据转移到 Zoom 聊天环境。系统管理员可访问多种迁移路径。
### 迁移概述
您可以使用 Zoom 聊天迁移应用通过多种方式迁移 Slack 数据，具体取决于您所在组织的规模、Slack 套餐和安全要求。
此外，您必须满足某些 Slack 和 Zoom 先决条件，制定迁移计划，并合并您的 Slack 工作区。本节概述这些先决条件和注意事项。
{% embed url="" %}
#### 迁移选项
下表详细说明最常见的迁移方法：
| 迁移方法 | 描述 | 最适合 | 要求 | 优势 |
| ------------------ | ------------------------------------------- | ----------------------------- | ------------------------------------ | ---------------------------- |
| **API 迁移（基于应用）** | 使用迁移应用直接连接到 Slack API 并传输数据。支持公开频道、私密频道和私信。 | 较小的组织，或可行获取用户授权的情况 | 对于私密聊天和私信，用户必须授权访问其数据 | 直接从 Slack 完全自动化、无缝地传输数据 |
| **导入工具迁移（基于文件）** | 使用 Slack 导出文件通过 Zoom 的导入工具迁移数据 | 采用 Slack Plus 或企业版 Grid 套餐的组织 | 管理员必须从 Slack 管理员仪表板导出 Slack 数据 | 无需用户授权；非常适合批量迁移，尤其是私密聊天 |
| **混合方法（API + 导入）** | 结合 API 和导入方法：通过 API 迁移公开频道；通过导入工具迁移私密频道和私信 | 希望避免用户授权复杂性的中大型组织 | 同时具备 Slack 导出和基于应用的 API 迁移设置的管理员访问权限 | 避免私密聊天的用户授权阻碍，同时保持公开频道迁移的自动化 |
**系统限制**
迁移过程受特定限制：
* **单个作业最大容量**：12 个月的历史数据
* **总迁移窗口**：60 个月（5 年）
* **作业并发性**：一次只能运行一个作业
这种技术架构可在保持安全协议和数据完整性的同时，系统化地迁移企业版通信数据。
#### Slack 到 Zoom 的数据映射
以下映射详细信息表可帮助您在迁移前了解 Slack 与 Zoom 聊天之间的关联：
| Slack 功能/特性 | Zoom 聊天对应项 | 备注 |
| -------------- | ---------- | ----------------------------- |
| 公开频道 | 公开频道 | 自动迁移 |
| 私密频道 | 私密频道 | 需要用户批准 |
| 私信（DM） | 一对一聊天 | 需要用户批准 |
| 群组私信 | 群组聊天 | 需要用户批准 |
| 线程 | 内嵌回复 | 不像 Slack 那样完全采用线程式结构，但会保留回复顺序 |
| @ 提及 | @ 提及 | 行为相同 |
| 反应 | 表情反应 | 行为相同 |
| 文件 | 共享文件 | 需要启用云存储 |
| 已置顶/已固定消息 | 加星标消息 | 已置顶/已固定消息会变为加星标 |
| Slack 机器人/应用消息 | 仅文本（无卡片） | 富应用卡片将不会迁移 |
#### 账户和权限先决条件
在继续之前，您必须检查您的 Slack 和 Zoom 账户级别以及管理员权限。
* 一个 **专业版、商业版、企业版或教育** 需要 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，这些 API 需要以下 Zoom 应用权限范围：
* `聊天_消息:写入:管理员`
* `即时聊天:机器人`
* `聊天_频道:写入:管理员`
* `用户:写入:管理员`
由 Zoom 构建的 Slack 应用将在管理员通过迁移工具连接到工作区时自动安装到 Slack 租户中。Slack 应用使用
OAuth2 身份验证[ 以连接 Zoom，并为数据迁移提供授权令牌。用户必须授权迁移私密对话（DM、群组聊天和私有频道）。](https://api.slack.com/authentication/oauth-v2) 以连接 Zoom，并为数据迁移提供授权令牌。用户必须授权迁移私密对话（DM、群组聊天和私有频道）。
你还必须为此设置选项 **仅允许来自 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.电子邮件`
#### 迁移注意事项
提前考虑迁移策略将节省精力，并确保平台之间平稳过渡。作为一个高层示例，Zoom提供了以下策略概述：
1. 决定要迁移哪些 Slack 工作区（一个或多个）
2. 选择要迁移的数据：
1. 公开频道（自动迁移）
2. 私密频道和直接消息（DM）（需要用户授权）
3. 机器人和/或应用消息
3. 确定最适合你需求的迁移方式
4. 为迁移设置时间范围（每个任务最长可达一年）
5. 与用户沟通私密消息审批事宜
**Slack 工作区整合**
对于使用多个 Slack 工作区的组织，例如企业版 Grid 用户，迁移到 Zoom 聊天会将所有工作区整合到一个账户中。
为区分不同的工作区，Zoom 会将原始工作区名称附加到频道和聊天名称中。例如：
* 原始 Slack 频道：
* **#工程** （具有名为“US Team”的工作区）
* 已迁移的 Zoom 频道：
* **#工程：美国团队**
此整合可确保所有数据迁移到单个 Zoom 聊天账户，同时保留原始工作区上下文。共享空间可为特定团队或部门提供额外结构，使组织和访问内容更加容易。
**聊天数据整合**
拥有超过 100 名用户的工作区可能包含数以万计从未归档或删除的私密群组聊天和私信，即使这些用户已被移出公司也是如此。这会导致私有迁移任务比公共任务耗时显著更长。
管理员应通过手动归档这些旧对话，或更新其 Slack 保留期限以自动删除它们，来清理旧数据。
Zoom 建议验证哪些数据需要作为有效数据保留在 Zoom 聊天中，以及哪些数据可为任何未来的法律、合规性、风险缓解、人力资源或其他目的进行归档。
{% hint style="success" %}
虽然您可以将更多 Slack 数据复制到 Zoom 聊天中，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) 可在用户的账户和群组级别进行配置。
* 管理员可根据需要为各个频道设置特定的保留时间。
* 管理员可为私信或群组聊天指定一项保留策略，并为聊天频道设置另一项策略。
* 对于聊天历史记录报告，Zoom 建议存储已编辑消息的修订版本和删除记录。
请参阅 Zoom 支持文章 [存储 Zoom 聊天消息历史记录](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060329) 以了解更多有关聊天历史记录保留的信息。
### 最佳实践
#### 迁移前的最佳实践
请遵循以下建议，以简化迁移前流程：
* 确保用户已在 Zoom 上创建账户，并且至少完成过一次身份验证。
* 管理员已将 Slack Migration 应用添加到其 Zoom 账户。
* 执行迁移的管理员必须同时拥有两个平台（Slack 和 Zoom 聊天）的权限，并且其 Zoom 和 Slack 账户中的电子邮件必须一致。
* 管理员必须使用 Zoom 聊天迁移应用来配置迁移作业，以运行并将数据从 Slack 移至 Zoom 聊天。注意：此过程至少需要 2 个作业，因为至少 1 个作业将迁移私密对话，另 1 个作业将迁移公开频道。
* 管理员应归档或删除不希望迁移到聊天中的任何不必要 Slack 数据，以帮助加快迁移速度。
* 如果您使用 API 迁移作业迁移私密数据，请确保用户知悉他们何时以及如何授权 Slack 将其数据移至聊天。
* 如果计划使用导入迁移作业，请遵循 [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 聊天迁移应用来配置迁移作业，以便将数据从 Slack 移至 Zoom 聊天。这至少需要 2 个作业：一个用于私密对话，另一个用于公开频道。
迁移时，请遵循以下推荐步骤：
1. 通过选择“选择公开频道会话类型”并选择特定频道，从一个频道迁移数据。从一些最早的频道中选择一周的数据。
2. 创建作业以传输一年以前的所有公开频道，然后验证所有频道均已连同用户创建。
3. 验证应用按预期运行后，应创建并运行较少但时间范围较大的作业，而不是创建较多但时间范围较小的作业。每个作业包含相同数量的迁移步骤。
4. （可选）对私密作业迁移重复这些步骤。
数据迁移后，您的数据将如下显示：
* 公开/私密频道和群组聊天名称将显示为：#频道名称：工作区名称
* 由拥有有效 Zoom 账户的 Slack 用户发送的消息将正常显示，如同由这些 Zoom 用户发送。
* 由没有有效 Zoom 账户的 Slack 用户发送的消息将显示为由已停用的 Zoom 用户发送，其名称为 Slack 消息发送者的名称。
* 系统消息将会迁移（例如，“@某位用户已加入该频道”）
* 无论消息在 Slack 中的状态如何，所有消息都将以已读状态迁移
* 完成后，将向每个公共和私有频道发送一条迁移完成通知，显示为“消息来自聊天迁移应用，星期 日期 时间”
#### 正在删除迁移应用
迁移应用会在迁移后保持 Slack 和 Zoom 会话之间的一对一映射。
{% hint style="warning" %}
将此应用从您的 Zoom 账户中移除将删除这些映射，如果您重新安装并再次迁移，则会导致重复的频道和聊天。只有在您确定不再需要进一步迁移时，才删除聊天迁移应用。
{% endhint %}
### 安装
{% embed url="" %}
要安装应用：
1. 登录到 Zoom App Marketplace。
2. 搜索“聊天迁移”并点击 **添加**.
3. 审核并批准所需的权限。
请参阅 Zoom 支持文章 [使用聊天迁移应用（Slack 迁移工具）](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0058132) 以获取更详细的安装说明。
{% hint style="info" %}
管理员必须向 Slack 工作区账户或组织授予权限，以安装并授权该私有应用程序， **消息检索器**。通常，管理员必须批准在 Slack 工作区中使用应用，并且还必须授予所有成员使用该应用的权限。
{% endhint %}
管理员必须授予在其 Zoom 账户中安装聊天迁移应用的权限，并在管理员角色中授予两项聊天管理权限。
以下项的选项 **仅允许来自 Slack 应用目录的应用** 设置必须 **已禁用**.
{% 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 中打开聊天迁移应用。
2. 点击 **创建连接 > 登录 Slack** 并授权。
3. 在 Zoom 仪表板中确认工作区连接。
#### 执行用户同步任务
用户同步任务会获取您的 Slack 工作区中的所有完整、活跃成员，并使用其电子邮件地址创建与相应 Zoom 账户的一对一映射。
如果在 Zoom 端找不到活跃 Slack 用户的电子邮件地址，Zoom 中将为该电子邮件地址创建一个新的已停用用户。
如果在其他 Zoom 账户（例如个人账户）下找到了活跃 Slack 用户的电子邮件地址，则该用户将被映射到“虚拟用户”配置文件。在您的 Zoom 账户中，该用户将被命名为 **TeamChatMigration AppUser** 并将显示，以确保您的工作区中的所有消息数据都已迁移。
{% hint style="warning" %}
请勿删除该 **TeamChatMigration AppUser** 用户。
{% endhint %}
### 正在执行迁移作业
以下部分将帮助你启动迁移所需的作业。
#### 创建导入迁移作业
要创建新的迁移作业：
1. 点击 **上传文件**，选择你的 Slack 导出文件，然后点击 **上传**.
2. 等待你的文件上传到 Zoom。
1. 注意：请不要退出或刷新页面，因为这会使文件上传停滞，作业将卡在“上传中”状态。如果发生这种情况，你可以删除“上传中”作业并重新开始此过程
3. 一旦初始文件上传完成， **迁移详情窗口** 当迁移应用准备迁移文件时，将会弹出。此时，你可以关闭、退出或刷新页面，同时等待任务准备好运行。
4. 工具完成迁移文件准备后，你将可以选择要迁移的会话类型。
5. 一旦你选择了会话类型，请点击 **运行** 以开始迁移任务。
{% embed url="" %}
#### 创建 API 迁移任务
要创建新的迁移作业：
1. 点击 **新建迁移任务** 并选择 Slack 工作区。
2. 选择 **数据范围**:
* 公开频道（自动迁移）。
* 私有频道和私信（需要用户授权）。
* 消息的特定日期范围。
3. 一旦你选择了数据范围和时间范围，并且已从你的用户那里获得授权，请选择 **运行** 以开始迁移任务。
{% hint style="warning" %}
处理私有频道和私信的私有数据授权请求：
* **私有频道和私信需要用户批准** 后才能迁移。
* 一旦创建迁移任务，Zoom 将自动发送电子邮件批准请求。
* 管理员可以跟踪哪些用户已批准或未批准。对于私聊迁移，只需要一名用户的授权即可迁移整个会话历史。
* 授权请求电子邮件只会发送给尚未提供批准的用户。
* 为了获得最佳迁移成功率，目标是从大约 60-70% 的用户那里获取授权。
{% endhint %}
{% embed url="" %}
{% embed url="" %}
#### 运行和监控迁移任务
**启动新的迁移任务**
要启动迁移任务，请运行：
1. 点击 **运行迁移** 以开始该流程。
2. 迁移时间各不相同（大型工作区可能需要 **12 小时以上**).
3. 在 **迁移仪表板**.
**迁移任务故障排查**
有时，迁移任务可能不会返回预期结果。下表提供了迁移过程中可能遇到问题的解决方案：
{% tabs %}
{% tab title="迁移故障排查" %}
| 问题 | 解决方案 |
| --------------------------------- | --------------------------------- |
| | |
| | 迁移应用将自动重试 |
| | 确保他们在 Zoom 中使用相同的电子邮件存在，并重新运行任何迁移 |
| {% endtab %} | |
| {% endtabs %} | |
{% embed url="" %}
### 迁移复盘
完成迁移后，Zoom 建议进行全面复盘，并验证你的 Slack 内容是否已按预期迁移到聊天。
下表提供了用于验证你的聊天迁移的推荐任务：
| 步骤 | 操作 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **验证迁移** | - 登录 Zoom 聊天，并验证频道、消息和文件是否正确显示。
- 退出登录并重新登录以刷新聊天记录。
|
| **修复任何缺失的数据** | - 向尚未批准私有数据访问的用户重新发送授权请求。
- 检查迁移任务中的错误，并重试任何失败的任务。
|
| **（可选）停用 Slack** | - 在确认数据迁移完成后，您可以归档或移除 Slack 工作区。
|
| **常规故障排查** | - 如果消息缺失，请尝试退出登录并重新登录 Zoom。
- 如果找不到用户，请验证 Slack 和 Zoom 之间的电子邮件地址是否匹配。
- 如果迁移失败，请检查日志中的错误详情并重试该过程。
|
#### 额外故障排查清单
如果您在迁移后发现其他问题，此清单可提供用于验证的其他步骤和操作。
{% hint style="info" %}
在继续之前，您必须获取 **来自网页呼叫的 Zoom 跟踪 ID** 并获取以下两项 **账户 ID** 和 **用户 ID**.
{% endhint %}
| 类别 | 问题描述 |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zoom 账户设置** | - 确认所有级别都已启用团队聊天功能
- 验证所有文件共享设置在各级别均已启用，并记录任何文件限制
- 验证“允许用户创建公开 + 私有频道”在所有级别均已启用
|
| **Zoom 用户问题** | - 验证该用户的管理员状态
- 确认工具操作员的电子邮件在 Zoom 和 Slack 中一致
- 验证在 Zoom 和 Slack 中正在迁移的用户的电子邮件地址是否匹配
|
| **迁移任务问题** | - 检查任务完成状态（通过/失败）
- 确定该任务是否涉及公开频道或私有频道/对话
|
| **如果迁移已通过，但消息/对话不可见** | - 确认 GMT 时间范围正确涵盖预期的 Slack 消息范围（迁移日期在 GMT 凌晨 12:00 开始/结束（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/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.