> 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） | 1:1 聊天 | 需要用户批准 |
| 群组私信 | 群组聊天 | 需要用户批准 |
| 线程 | 内联回复 | 不像 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 迁移工具使用需要以下 Zoom 应用权限的内部 API：
* `聊天消息:写入:管理员`
* `即时聊天:机器人`
* `聊天频道:写入:管理员`
* `用户:写入:管理员`
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.电子邮件`
#### 迁移注意事项
提前考虑迁移策略将节省精力，并确保平台之间平稳过渡。作为一个高层示例，Zoom 提供以下策略概述：
1. 决定要迁移哪些 Slack 工作区（一个或多个）
2. 选择要迁移哪些数据：
1. 公共频道（自动迁移）
2. 私有频道和直接消息（DM）（需要用户授权）
3. 机器人和/或应用消息
3. 确定哪种迁移方式最适合您的需求
4. 为迁移设置时间范围（每个任务最长不超过一年）
5. 与用户沟通私信审批事宜
**Slack 工作区整合**
对于使用多个 Slack 工作区的组织，例如 企业版 Grid 用户，迁移到 Zoom 聊天会将所有工作区整合到一个账户中。
为区分不同工作区，Zoom 会将原始工作区名称追加到频道和聊天名称中。例如：
* 原始 Slack 频道：
* **#engineering** （工作区为“US Team”）
* 已迁移的 Zoom 频道：
* **#engineering：US Team**
这种整合可确保所有数据迁移到单个 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 个用于私密对话，1 个用于公开频道。
迁移时，请遵循以下建议步骤：
1. 通过选择“公开频道会话类型”并选择特定频道，从一个频道迁移数据。请选择某些最早频道中的一周数据。
2. 创建任务，将一年前的所有公开频道迁移过去，然后验证所有频道是否已与用户一并创建。
3. 在确认应用按预期运行后，创建并运行较少、时间范围更大的任务，而不是更多、时间范围更小的任务。每个任务包含相同数量的迁移步骤。
4. （可选）对私密任务迁移重复这些步骤。
数据迁移后，您的数据将显示如下：
* 公开/私有频道和群组聊天名称将显示为：#频道名称：工作区名称
* 由拥有有效 Zoom 账户的 Slack 用户发送的消息将正常显示，仿佛是由这些 Zoom 用户发送的
* 由没有有效 Zoom 账户的 Slack 用户发送的消息将显示为由一个已停用的 Zoom 用户发送，名称为 Slack 消息发送者的姓名
* 系统消息将会迁移（例如，“@某用户已加入该频道”）
* 无论其在 Slack 中的状态如何，所有消息在迁移后都将显示为已读
* 完成后，将向每个公开和私人频道发送一条迁移完成通知，显示为“Message is sent from 聊天迁移应用, Day Date Time”
#### 删除迁移应用
迁移应用在迁移后保持 Slack 和 Zoom 对话之间的 1:1 映射。
{% 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 账户的 1:1 映射。
如果在 Zoom 端未找到活跃 Slack 用户的电子邮件地址，则会在 Zoom 中为该电子邮件地址创建一个新的、已停用的用户。
如果在其他 Zoom 账户（例如个人账户）下找到了活跃 Slack 用户的电子邮件地址，则该用户将被映射到“dummy 用户”个人资料。在您的 Zoom 账户中，该用户将被命名为 **TeamChatMigration AppUser** 并将显示，以确保为您的工作区迁移所有消息数据。
{% hint style="warning" %}
请勿删除 **TeamChatMigration AppUser** 用户。
{% endhint %}
### 执行迁移任务
以下部分将帮助您启动迁移所需的任务。
#### 创建导入迁移任务
要创建新的迁移任务：
1. 单击 **上传文件**，选择您的 Slack 导出文件，然后点击 **上传**.
2. 等待您的文件上传到 Zoom。
1. 注意：请不要退出或刷新页面，因为这会导致文件上传停滞，并使任务卡在“Uploading”状态。如果发生这种情况，您可以删除“Uploading”任务并重新开始此流程
3. 初始文件上传完成后，一个 **迁移详情窗口** 当 Migration 应用准备迁移文件时会弹出。在此期间，您可以关闭、退出或刷新页面，同时等待任务准备就绪。
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 点（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.