通过

将机器人连接到可操作邮件的 Outlook 通道（预览版）

  • 项目

适用于：SDK v4

可操作邮件支持用户在 Outlook 中快速执行操作。 将机器人连接到 Outlook 可操作邮件通道时，机器人可以使用自适应卡片创建可操作邮件，从而增强用户参与体验。

注意

可操作邮件的 Outlook 通道以公共预览版提供。 预览版的功能可能不完整，并且可能会在公开版本中推出之前进行更改。 仅用于评测和探索目的。

警告

创建“spambots”（包括发送不需要或未经请求的批量电子邮件的机器人）将被视为违反 Bot Framework 行为准则。

先决条件

注意

  • 不要将自己的个人电子邮件帐户用于机器人，因为发送到该电子邮件帐户的每份邮件都将转发给机器人。 这可能导致机器人不恰当地向发件人发送响应。 因此，机器人应仅使用专用的 O365 电子邮件帐户。
  • 如果使用 Microsoft Exchange Server，请先启用自动发现，然后再配置电子邮件通道。

设计邮件

可操作邮件的 Outlook 通道通过电子邮件收发自适应卡片。

可使用 Actionable Message Designer 设计和测试可操作邮件卡片。

重要

通用机器人操作模型在自适应卡片架构版本 1.4 中引入。 如要使用这些新功能，自适应卡片的版本属性应设置为 1.4 或更高版本。 请参阅自适应卡片架构资源管理器中的 Action.Execute。

实现和部署机器人

常规流用于机器人向用户发送可操作邮件，然后处理用户的操作。

  1. 当用户回复电子邮件中的卡片时，Outlook 会将调用活动发送给机器人。 活动的 value 属性包含一个带有 type、verb 和 data 属性的操作对象。 例如，活动将包括以下信息，其中谓词和数据对应于机器人最初发送的卡片上的信息。

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    有关完整的对象架构，请参阅自适应卡片架构资源管理器中的 Action.Execute。

  2. 机器人处理传入的调用活动并返回一个结果，其中包含将取代原始自适应卡片的新自适应卡片。 调用响应可能如下所示：

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

请求访问权限

  1. 在 Azure 门户中打开机器人资源。
  2. 打开通道窗格。
  3. 选择 Outlook 通道。
  4. 在配置 Outlook页面，选择请在此处注册。
  5. 填写注册表单以请求访问权限。 请参阅使用可操作的电子邮件开发人员仪表板注册服务，了解详细信息。

后续步骤