配置 Listener，以便在外部应用程序中发生事件时触发操作。 此示例演示如何使用 Listener 触发器创建 Task Bot，当用户在 Zendesk 平台创建工单时，向 Microsoft 365 Outlook 邮箱发送电子邮件。

该触发器监听 Zendesk 平台中的任何事件。 当用户在平台中创建工单时，触发器会启动后续自动化工作流，将包含工单详细信息的邮件发送至已配置的 Microsoft 365 Outlook 邮箱。

先决条件

确保您满足以下先决条件：
  • 自动化的监听器 URL。 有关创建监听器 URL 的更多信息，请参阅 为 Listener 网页触发器创建监听器 URL。
  • 具有 Zendesk 平台的管理员权限，可创建、更新和删除工单。
  • Listener 触发器 中列出的监听器触发器要求。
  • 一个名称为 TriggerData 的记录变量。
  • Microsoft 365 Outlook 的活动 OAuth 连接。
  • 包含 Microsoft 365 Outlook 用户名的凭据变量。

过程

  1. 请按照以下步骤在 Zendesk 平台创建一个 Webhook。
    1. 登录到您的 Zendesk 门户
    2. 前往管理中心 > 应用与集成 > Webhook，然后单击创建 Webhook。
    3. 在相应的字段中输入以下内容。
      1. 选择连接方式： 选择 Zendesk 事件并从事件类型下拉列表中选择任何工单事件。
      2. 名称： 为 Webhook 输入一个合适的名称。
      3. 终端节点 URL： 添加您在 Control Room 中创建的监听器 URL。
      4. 身份验证： 选择 API 密钥。
      5. 标头名称： 输入 ticket-header。
      6. 值： 输入标头的适当值。
      有关创建 Webhook 的更多信息，请参阅 Creating webhooks in Zendesk。
  2. 执行以下步骤，在 Control Room 中创建 Task Bot。
    1. 在左侧窗格中，单击自动化。
    2. 单击 创建 > 任务机器人。
      创建任务机器人向导会出现。
    3. 在名称字段中为机器人输入一个合适的名称。
      系统默认将所有机器人存储在<\Bots>文件夹中。
    4. 可选： 在描述字段中添加机器人描述。
    5. 可选： 单击选择，并按照提示将机器人保存到其他文件夹。
    6. 单击创建和编辑。
      机器人已创建，并且编辑任务机器人显示。
  3. 执行以下步骤以添加并配置 Listener 网页触发器。
    1. 单击触发器 > 通用网页触发器，然后双击或拖动监听器，将网页触发器添加到触发器部分。
    2. 从监听器下拉列表中选择生成的监听器 URL。
      系统会自动在 URL 字段中填充生成的 URL。
    3. 在身份验证标头中单击添加，以打开标头模态框。
    4. 在名称中输入身份验证标头名称。
    5. 选择不安全字符串，并在值中输入标头的值。
      或者，您可以将该值作为凭据保存在 Credential Vault 中，并使用凭据选项进行选择。
    6. 单击添加以添加身份验证标头。
    7. 从签名方案下拉菜单中选择无验证。
    8. 从响应下拉列表中选择 TriggerData。
      TriggerData 变量用于存储从 Zendesk 传入的响应有效负载。 有关工单事件响应有效负载的更多信息，请参阅 Zendesk ticket events payloads。
  4. 请按照以下步骤添加并配置 Microsoft 365 Outlook 连接 操作。
    1. 单击操作 > Microsoft 365 Outlook，然后双击或拖动连接，将该操作添加到操作部分。
    2. 在 Azure Cloud 中选择 Azure Global。
      如果您的 Microsoft 365 Outlook 属于 Microsoft 365 Government 版本，请选择 Azure US GCC High。
    3. 在 OAuth2 身份验证模式中选择 Control Room 托管。
    4. 单击选择，并按照选择 OAuth 连接模态框中的提示，选择 Microsoft 365 Outlook 的 OAuth 连接。
    5. 单击变量 > 插入值，然后按照提示选择 Microsoft 365 Outlook 用户名凭据。
    6. 可选： 在创建 Microsoft 365 Outlook 会话中输入合适的会话名称。
      系统默认将 Microsoft365OutlookSession 设置为会话名称。
  5. 请按照以下步骤添加并配置 Microsoft 365 Outlook 发送 操作。
    1. 单击操作 > Microsoft 365 Outlook，然后双击或拖动发送，将该操作添加到操作部分。
    2. 请输入您在配置连接操作时输入的会话名称。
      如果保留默认名称，系统会将 Microsoft365OutlookSession 预填为 Microsoft 365 Outlook 会话。
    3. 在收件人中输入要转发文件详细信息的 Microsoft 365 Outlook 邮箱 ID。
    4. 在主题中输入 $TriggerData{"detail.subject"}$。
      detail.subject 键包含 Zendesk 工单的主题，作为其值。
    5. 在电子邮件正文类型中选择 HTML 代码，并输入 $TriggerData{"detail.description"}$。
      detail.description 键包含 Zendesk 工单的描述，作为其值。
  6. 单击保存以保存配置。
当您单击运行 > 使用触发器运行时，系统将激活触发器，并且触发器会开始监听 Zendesk 平台中的工单事件。 当用户创建工单时，触发器会启动后续的 Microsoft 365 Outlook 操作。 Microsoft 365 Outlook 邮箱会收到一封邮件，其主题为工单主题，正文为工单描述。