Exchange 集成

Automation Cloud 上 IXP 的 Exchange 集成，用于将电子邮件数据同步到 Communications Mining，包括账单详细信息和设置概述。

警告：

Microsoft 将于 2026 年 10 月 1 日停用 Exchange Online 的 Exchange 网页服务 (EWS)（ Microsoft 公告）。我们建议尽快将 Exchange 集成切换到 Microsoft Graph API。有关迁移步骤，请参阅EWS 到 Microsoft Graph API 迁移指南。

概述

Exchange 集成提供了一种方便且易于设置的方式，用于将开发和生产电子邮件数据实时同步到 Communications Mining™ 中。

备注：

如果其文本已被修改，对于每个创建的注释或更新的注释，您需要支付 1 个 AI Unit 或 0.2 个 Platform Units 的费用，具体取决于电子邮件的消息 ID。

Exchange 集成持续轮询您的 Exchange 服务器，以获取已配置邮箱中的新电子邮件。 电子邮件经过清理、丰富并转换为 Communications Mining 注释对象，可供 Communications Mining 网页平台上的用户访问，也可由应用程序或机器人通过 Communications Mining API 访问。 Exchange 集成在 Communications Mining Cloud 中运行。

可以在 Communications Mining 用户界面中方便地配置要轮询的邮箱，该用户界面还提供启动或停止集成的功能，以及更新用于连接到 Exchange 服务器的配置参数的功能。

备注：

• Exchange 集成与 Exchange Online 和使用 Exchange Web 服务 (EWS) 的 Microsoft Exchange 2010-2019 Server 兼容。
• Exchange 集成通过 HTTPS 发出经过身份验证的 GET 请求，从而轮询 Exchange 服务器。 Exchange 集成通过其启动的 GET 请求接收数据，并且不接受在其他地方启动的任何入站连接。 可以使用特定密码配置 Exchange 集成。
• 仅向 Exchange 集成授予对您邮箱的只读访问权限就足够了。

电子邮件的同步方式

集成将持续同步每个已配置邮箱中的电子邮件。 如果未提供开始时间，则系统将同步所有电子邮件。

集成会将注释的message_id设置为已同步电子邮件的十六进制编码的comment ID 。如果将包含同一封电子邮件的多个邮箱（例如，由于被添加到同一封电子邮件的“抄送”字段）同步到同一个存储桶，则生成的注释将包含最后一个同步的重复电子邮件的元数据。

当将相应的电子邮件移到其他文件夹时，集成将更新注释的文件夹用户属性。如果在发送或接收电子邮件后在电子邮件中更新注释主题或正文，集成将不会更新注释主题或正文。

您还可以在 Exchange 集成的邮箱级别启用附件同步。然后，流 API 使可通过附件引用检索附件。在附件和使用 Exchange 集成页面中查看有关同步附件的更多信息。

下图包含具有值的邮箱配置示例：

• 存储桶: 邮箱 (org2/example-2b2f8982)

• 内容筛选规则：

  • 明确允许的文件夹：根目录/信息存储顶部/收件箱
  • 明确拒绝的文件夹：无
  • 从 2023 年 2 月 1 日凌晨 12 点 UTC 起
  备注：

  您应该使用 Exchange 服务器的语言（而不是用户的语言）来表示“信息存储顶部”。

  应用文件夹筛选器时，请确保考虑以下因素：

  • 嵌套文件夹用正斜杠/分隔。
  • Outlook 中可见的文件夹通常以root/Top of Information Store为前缀。
  • 允许文件夹意味着拒绝未明确允许的文件夹。
  • 您可以拒绝允许文件夹中的文件夹。
  • 您不能允许使用遭拒文件夹中的文件夹。
  提示：

  将文件夹筛选器作用域限制为用例所需的最小值。如果将“允许的文件夹”留空，则集成会持续同步邮箱中的每个文件夹，包括“存档项目”和“可恢复的项目”（清除），这会大大减慢同步速度。对于大多数 BAU 处理，仅允许：

  • root/Top of Information Store/Inbox
  • root/Top of Information Store/Sent Items

  

集成错误

如果集成配置不正确，系统将自动在集成级别禁用持续遇到问题的集成；如果邮箱配置不正确，系统将在邮箱级别自动禁用。

系统会通知您解决一个或多个问题，问题解决后，您可以重新启用集成。

当找不到邮箱、邮箱已被删除、服务帐户无权访问收件箱或凭据已过期需要更新时，就会发生这种情况。如果问题仅影响一个邮箱（例如不允许应用程序访问的邮箱），则仅禁用该邮箱，而集成的其余部分将继续同步。

禁用集成的错误示例包括：

• 凭据不正确
• 凭据已过期
• 达到上传数据的配额限制
• Exchange 服务器详细信息配置错误

禁用邮箱的错误示例包括：

• 服务帐户或应用程序身份验证的权限无效
• 邮箱地址拼写错误
• 已删除的邮箱

大多数邮箱错误都包含“ Error 详细信息： ”行，其中包含 Microsoft 返回的未修改的错误，该行指出了根本原因。有关您可能看到的错误、原因以及解决方法，请查看Exchange 集成故障排除。

订阅通知

如果您具有以下角色之一，则系统将为您自动订阅警示和集成错误通知：

• IXP 项目管理员
• IXP 模型训练者
• IXP 开发者
• IXP 查看者
• IXP 分析师

您也可以通过通知服务自行订阅或取消订阅。要管理您的通知首选项，请查看管理通知。

要更新集成配置，需要IXP 项目管理员或IXP 开发者角色。

配置

在线 Exchange

对于新的集成，请遵循 Microsoft Graph API 指南：

• Exchange 与 Azure 应用程序身份验证和图形集成

以下指南介绍 EWS API，Microsoft 将于 2026 年 10 月 1 日在 Exchange Online 中停用该 API。仅将其用于维护现有的 EWS 集成，如需将其迁移到 Graph，请查看“EWS 到 Microsoft Graph API 迁移”指南：

• Exchange 与 Azure 应用程序身份验证集成
• Exchange 与 Azure 服务用户的集成

自托管 Exchange Server

仅通过具有 NTLM 身份验证的 EWS API 支持自托管 Exchange 服务器。使用客户端密码或私钥的 OAuth 身份验证仅适用于 Exchange Online。

设置 NTLM 服务帐户，并授予服务用户委派读取您要同步的邮箱的权限。

备注：

Exchange 集成在 UiPath Automation Cloud™ 中运行，因此您的 EWS 端点必须可通过互联网访问，并解析为公共 IP 地址。

收集以下详细信息：

• EWS 端点 - Exchange 服务器上 EWS 服务的完整 URL。路径应以 /EWS/Exchange.asmx 结尾，例如 https://mail.example.com/EWS/Exchange.asmx。
• 服务用户的用户名和密码。
• 服务用户可以访问的测试邮箱，用于在保存凭据时检查您的凭据。
• Exchange 服务器的内部版本编号（可选）。
• 要同步的邮箱列表。

要在 Communications Mining™ 中配置集成：

1. 导航到“管理”页面，然后选择“集成”选项卡。
2. 选择“新建集成” 。
3. 在“连接到您的应用程序”下，选择“EWS API” 。
4. 选择“使用 NTLM” ，然后输入 EWS 端点、内部版本编号（如果有）和测试邮箱。
5. 选择“提供服务用户访问权限” ，然后输入服务用户的用户名和密码。
6. 选择“验证并保存凭据” 。
7. 添加要同步的邮箱，如使用 Exchange 集成中所述。

重要提示：

如果在“时间筛选器”部分中选择“所有时间” ，则可能会导致同步的数据超过预期，并且在上传时对消息收费。