创建电子邮件触发器,当收到来自预定义电子邮件服务的新电子邮件消息时启动自动化。

Control Room 连接到系统上的电子邮件服务之一,并在收到新电子邮件时触发自动化。

对于电子邮件自动化,您可以使用 OAuth 2.0 与电子邮件服务器进行身份验证。 要在 Microsoft 身份识别平台上注册应用程序,请参阅 使用 电子邮件 软件包 中的连接 操作

先决条件

确保完成以下操作

过程

  1. 在左侧窗格中,单击自动化
    将显示可用 机器人 和表单的列表。
  2. 单击新建 > 机器人
  3. 输入 机器人 的名称。
    所有 机器人 都存储在 Bots 文件夹下。 (可选)单击浏览以更改文件夹。
  4. 单击创建和编辑
  5. 机器人 构建程序页面中,单击触发器 > 电子邮件触发器
  6. 电子邮件拖动到拖动触发器到此处
  7. 使用右侧的电子邮件触发器窗格,选择以下服务器类型之一作为传入电子邮件的触发器:
    服务器类型步骤
    Microsoft Outlook 单击 Outlook

    将 Bot Runner 设备上安装的 Microsoft Outlook 设置为电子邮件服务。 在 Microsoft Outlook 中收到电子邮件时,电子邮件触发器将启动自动化。

    电子邮件服务器 单击电子邮件服务器并执行以下步骤。
    1. 输入电子邮件服务主机信息。

      例如,如果您使用 Office365 作为电子邮件服务,请输入 Outlook.office365.com

    2. 选择 IMAPPOP3
      IMAP 和 POP3 是用于连接到邮件服务器的协议,使您能够通过电子邮件客户端阅读电子邮件。
      注: POP3 协议有一个已知的限制,其中任何新的日历邀请也可以触发 机器人
    3. 使用安全连接 (SSL/TLS): 如果要与邮件服务器使用安全连接,请选择此选项。
    4. 端口中输入为您的电子邮件服务器配置的端口号。
    5. 选择以下一种用户身份验证方法以登录到电子邮件服务器:
      • 基本
      • 客户端凭据
        • 指定在 Microsoft Azure 门户中注册应用程序时生成的唯一客户端和租户 ID。
        • 指定要用于访问邮件服务器的用户名。
        • 指定您在应用程序注册门户中为您的应用程序生成的客户端密钥。
          对于客户端 ID租户 ID用户名客户端密钥字段,请从凭据不安全字符串选项卡中选择:
          • 凭据: 使用凭据保管库中可用的值。
          • 不安全字符串: 手动输入值。
          注: 客户端凭据流程不支持 Gmail。
      • Control Room managed

        要使用 Control Room 管理的 OAuth2 身份验证模式来自动执行 Gmail,您必须在 Control Room 中配置 OAuth 连接。 请参阅 创建 OAuth 连接

        在以下字段中更新信息:

        • 连接: 单击选择按钮以选择连接类型。
        • 提供者类型字段中选择自定义
        • 选择您在 Control Room 中为 Google Workspace 应用设置的连接名称。

        • 使用令牌类型字段选择以下选项之一:

          有关 Google Workspace 应用程序访问和刷新令牌的信息,请参阅 配置企业应用程序

          • 共享: 当所有运行自动化的用户共享 OAuth2 访问令牌时,选择此选项。
            注: 此选项要求 Control Room 管理员或任何用户(在 OAUTH CONNECTIONS 中启用了管理连接和查看连接选项)在 Control Room 中设置一个 OAuth 连接。 将登录凭据保存一次,以生成一个共享访问令牌,供所有运行自动化的用户使用。
          • 用户专用: 当 OAuth2 访问令牌特定于运行自动化的每个用户时,选择此选项。
            注: 此选项要求 Control Room 管理员或任何用户(在 OAUTH CONNECTIONS 中启用了管理连接和查看连接选项)在 Control Room 中设置一个 OAuth 连接。 确保您不保存登录凭据,以便每个运行自动化的用户都可以提供他们的登录凭据并生成只能由该特定用户使用的访问令牌。
          • 单击确认
        注: 当您使用用户特定选项时,您必须登录到您的 Google 账户以进行身份验证并生成用户特定的令牌。 执行以下步骤以使用此选项:
        1. Control Room 中,导航到您的个人资料我的设置 > OAuth 连接
        2. 单击登录进行身份验证
        3. 登录到您的 Google 账户,然后选择继续
        4. 验证您可以访问的服务,然后单击继续

          如果连接成功,它将显示状态为活动

      注: 当您将电子邮件服务器的协议设置为 POP3 时,文件夹中的电子邮件不支持子文件夹,
    EWS 服务器 单击 EWS 服务器
    1. Microsoft Exchange 版本下拉菜单中,选择您的当前版本。

      例如,如果您使用的是 Microsoft Exchange Service Pack 2,请选择 Exchange2010_SP2 作为电子邮件服务。

    2. 输入域名,例如 smtp.office365.com
    3. 选择以下一种用户身份验证方法以登录到电子邮件服务器:
      • 基本
      • OAuth 2.0 – 客户端凭据
        • 指定在 Microsoft Azure 门户中注册应用程序时生成的唯一客户端和租户 ID。
        • 指定要用于访问邮件服务器的用户名。
        • 指定您在应用程序注册门户中为您的应用程序生成的客户端密钥。
          对于客户端 ID租户 ID用户名客户端密钥字段,请从凭据不安全字符串选项卡中选择:
          • 凭据: 使用凭据保管库中可用的值。
          • 不安全字符串: 手动输入值。
          注: Microsoft Outlook 不支持共享邮箱,但作为一种变通方法,您可以使用共享电子邮件作为用户名字符串的 EWS 服务器凭据流。
  8. 可选: 使用所有服务器类型下可用的检查时间间隔下拉菜单来设置触发间隔。

    默认情况下,机器人 的触发间隔设置为 120 秒。

    注: 使用检查间隔时间下拉菜单配置的触发间隔与计划间隔内收到的邮件数量无关。

    例如,如果您将检查间隔时间配置为 1 秒,即使您同时收到三封不同的电子邮件,也只会触发一次任务。 轮询的运行时间过滤器会更新为上次运行触发器的电子邮件的发送日期时间。

  9. 可选: 使用选择条件为选定服务器类型指定电子邮件事件。
    考虑您选择 Outlook 并希望在收到来自特定发件人的电子邮件时触发 机器人 的场景。 在选择条件中,选择电子邮件发件人复选框并指定发件人的电子邮件地址。
    当您选中电子邮件主题包含复选框时,电子邮件触发器将根据以下主题条件执行:
    • 如果使用双引号 ("") 含括主题行,例如 "ABC spreadsheet",则仅当电子邮件主题与含括在引号内的字符串完全匹配时才会执行触发器。
    • 如果多个主题行用英文分号分隔,例如 ABC spreadsheet; ABC project logs,则当电子邮件主题与提及的任何主题行匹配时将执行触发器。
  10. 可选: 要创建变量,请在分配到 > 录制选项卡中,单击选择变量图标

    您可以使用此变量来检索有关触发 机器人 的电子邮件的各种详细信息,例如发件人、收件人、主题、电子邮件内容、日期、操作信息、电子邮件服务器主机和端口数据。

  11. 单击保存以保存电子邮件触发器配置。
Microsoft Outlook、电子邮件服务器或 EWS 服务器设置为针对新电子邮件启动 机器人 的触发器。
注: 当您运行电子邮件触发器时,emailTo 键会返回收件人地址列表。 要将收件人地址列表转换为字符串,请使用 列表 软件包 中的分配 操作,然后使用 列表 软件包 中的连接项目 操作,以逗号作为分隔符来分隔地址。

后续步骤

使用操作配置所需的自动化,并保存该自动化。 单击运行 > 使用触发器运行时,自动化监听已配置的触发器。 收到新电子邮件时,触发器将启动配置的自动化。