了解 Outlook 可操作邮件的格式

3 分钟

Outlook 中的可操作邮件使用自适应卡片JSON 将可操作卡片部分添加到电子邮件中。在此单元中，我们来看一看自适应卡片 JSON 如何添加到电子邮件中。

可操作邮件卡

可操作邮件的关键部分就是消息卡。该卡主要显示在邮件顶部，使用与电子邮件客户端本机 UI 集成的 UI 元素。卡片的突出位置是传达关键信息以及向收件人请求操作的理想位置。

此卡通过标准自适应卡语法和功能实现，并增加了一些新的 Outlook 专用功能。

让我们看一个简单的示例。以下 JSON 实现基本卡片。

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "originator": "5a53e3ea-f50a-44d2-8855-2b5825d63eb8",
  "hideOriginalBody": "true",
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
      "type": "TextBlock",
      "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

此卡使用标准自适应卡片元素，例如 TextBlock、 Input.Text和 Action.OpenUrl。它还使用 Outlook 特有的功能，包括：

originator属性包含注册服务期间分配的提供商 ID。注册的内容将在以后的模块中介绍。
hideOriginalBody 属性控制 Outlook 客户端是否在卡片下方显示电子邮件的 HTML 正文。这可让你选择使用卡片完全替换正文，或使用卡片补充正文。对于不支持可操作邮件的电子邮件客户端，将始终显示 HTML 正文。因此，对于不支持可操作邮件的客户端，可以选择HTML正文作为回退邮件。
该 Action.Http 操作将收件人的输入发送到 url 属性中指定的 HTTPS 终结点。此终结点是一个为接收可操作邮件并处理信息而实施的 Web API。

以上 JSON 结果为一张在 Outlook 网页中外观如所示的卡片。

Outlook 网页呈现的可操作邮件卡示例

向电子邮件添加卡片

通过在<script> HTML 正文的标记 <head> 中添加一个标签，向电子邮件添加可操作的邮件。

<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <script type="application/adaptivecard+json">{
    "type": "AdaptiveCard",
    "version": "1.0",
    ...
  }
  </script>
</head>
<body>
Visit the <a href="https://learn.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

继续

了解 Outlook 可操作邮件的格式

可操作邮件卡

向电子邮件添加卡片

反馈