使用 Bot Connector API 向消息添加资讯卡附件

某些通道允许机器人向用户发送资讯卡。 资讯卡是包含交互式元素的附件，例如按钮、文本、图像、音频、视频等。

本文介绍如何创建可附加到消息的资讯卡。 有关如何向消息添加附件的特定说明，请参阅如何向消息添加媒体附件。

富卡类型

资讯卡包括标题、说明、链接和图像。 消息可包含多个资讯卡，以列表格式或轮播格式显示。 Bot Framework 目前支持八种类型的资讯卡：

处理资讯卡中的事件

若要处理资讯卡中的事件，请使用 CardAction 对象指定当用户单击按钮或单击卡的某个部分时应发生的情况。 每个 CardAction 对象包含以下属性：

若要正常运行，请为英雄卡上的每个可单击项指定一种操作类型。 下表列出并描述了可用的操作类型以及应该存在于相关联的值属性中的内容。

messageBack 卡操作比其他卡操作的含义更泛性。 有关 messageBack 和其他卡操作类型的详细信息，请参阅活动架构的卡操作部分。

向消息添加英雄卡

若要向消息添加资讯卡附件，请执行以下操作：

1. 创建一个对象，该对象表示要添加到消息中的卡片类型。
2. 创建附件对象：
   • 将其 contentType 属性设置为卡片的媒体类型。
   • 将其 content 属性设置为创建的表示卡片的对象。
3. 将 Attachment 对象添加到消息的 attachments 数组中。

某些通道允许将多个资讯卡添加到消息中的 attachments 数组。 如果想为用户提供多个选项，此功能非常有用。 例如，如果机器人允许用户预订酒店房间，它可为用户提供一张资讯卡列表，显示出可选房间类型。 每张卡包含与房间类型相对应的图片和设施清单，并且用户可通过单击卡或单击按钮来选择房间类型。

以下示例显示了包含单个主图卡附件的完整消息。 在此示例请求中，https://smba.trafficmanager.net/teams 表示基本 URI；机器人发出的请求的基本 URI 可能不同。 有关设置基本 URI 的详细信息，请参阅 API 参考。

POST https://smba.trafficmanager.net/teams/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
    "type": "message",
    "from": {
        "id": "12345678",
        "name": "sender's name"
    },
    "conversation": {
        "id": "abcd1234",
        "name": "conversation's name"
    },
    "recipient": {
        "id": "1234abcd",
        "name": "recipient's name"
    },
    "attachments": [
        {
            "contentType": "application/vnd.microsoft.card.hero",
            "content": {
                "title": "title goes here",
                "subtitle": "subtitle goes here",
                "text": "descriptive text goes here",
                "images": [
                    {
                        "url": "https://www.publicdomainpictures.net/pictures/30000/t2/duck-on-a-rock.jpg",
                        "alt": "picture of a duck",
                        "tap": {
                            "type": "playAudio",
                            "value": "url to an audio track of a duck call goes here"
                        }
                    }
                ],
                "buttons": [
                    {
                        "type": "playAudio",
                        "title": "Duck Call",
                        "value": "url to an audio track of a duck call goes here"
                    },
                    {
                        "type": "openUrl",
                        "title": "Watch Video",
                        "image": "https://www.publicdomainpictures.net/pictures/30000/t2/duck-on-a-rock.jpg",
                        "value": "url goes here of the duck in flight"
                    }
                ]
            }
        }
    ],
    "replyToId": "5d5cdc723"
}

向消息添加自适应卡片

自适应卡片可包含文本、语音、图像、按钮和输入域的任意组合。 自适应卡使用自适应卡中指定的 JSON 格式创建而成，这让你可以完全控制卡内容和格式。

利用自适应卡片站点中的信息来了解自适应卡片架构，探索自适应卡片元素，并查看可用于创建具有不同组成内容和复杂性的卡的 JSON 样本。 此外，可使用交互式可视化工具设计自适应卡片有效负载并预览卡片输出。

以下示例显示了一个表示工作分配的单个自适应卡附件对象。 若要将此内容发送给用户，需要将其作为附件添加到消息中。

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
    {
      "type": "Container",
      "items": [
        {
          "type": "TextBlock",
          "text": "Publish Adaptive Card schema",
          "weight": "bolder",
          "size": "medium"
        },
        {
          "type": "ColumnSet",
          "columns": [
            {
              "type": "Column",
              "width": "auto",
              "items": [
                {
                  "type": "Image",
                  "url": "https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg",
                  "size": "small",
                  "style": "person"
                }
              ]
            },
            {
              "type": "Column",
              "width": "stretch",
              "items": [
                {
                  "type": "TextBlock",
                  "text": "Matt Hidinger",
                  "weight": "bolder",
                  "wrap": true
                },
                {
                  "type": "TextBlock",
                  "spacing": "none",
                  "text": "Created {{DATE(2017-02-14T06:08:39Z, SHORT)}}",
                  "isSubtle": true,
                  "wrap": true
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "type": "Container",
      "items": [
        {
          "type": "TextBlock",
          "text": "Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.",
          "wrap": true
        },
        {
          "type": "FactSet",
          "facts": [
            {
              "title": "Board:",
              "value": "Adaptive Card"
            },
            {
              "title": "List:",
              "value": "Backlog"
            },
            {
              "title": "Assigned to:",
              "value": "Matt Hidinger"
            },
            {
              "title": "Due date:",
              "value": "Not set"
            }
          ]
        }
      ]
    }
  ],
  "actions": [
    {
      "type": "Action.ShowCard",
      "title": "Comment",
      "card": {
        "type": "AdaptiveCard",
        "body": [
          {
            "type": "Input.Text",
            "id": "comment",
            "isMultiline": true,
            "placeholder": "Enter your comment"
          }
        ],
        "actions": [
          {
            "type": "Action.Submit",
            "title": "OK"
          }
        ]
      }
    },
    {
      "type": "Action.OpenUrl",
      "title": "View",
      "url": "https://adaptivecards.io"
    }
  ]
}

生成的卡片包含标题、有关创建卡片的人员的信息（其姓名和头像）、创建卡片的时间、工作分配说明以及与分配相关的信息。 还有一些按钮可以单击，对工作分配进行评论或查看：

其他资源

• 创建消息
• 发送和接收消息
• 向消息添加媒体附件
• 通道参考
• Bot Framework Activity 架构
• Bot Framework 卡片架构