你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Bot Connector API 创建消息

机器人将会发送类型为消息的活动对象来向用户传达信息,并且,也会从用户那接收消息活动。 某些消息可能只包含纯文本,而另一些可能包含更丰富的内容,例如 建议的操作媒体附件富卡特定渠道的数据。 本文介绍一些常用的消息属性。

消息文本和格式

可以使用 纯文本markdownxml 设置消息文本的格式。 属性的默认格式 textFormatMarkdown ,并使用 Markdown 格式标准解释文本。 文本格式支持级别因通道而异。

小窍门

有关每个通道支持的功能的详细信息,请参阅通道参考一文。

textFormat Activity 对象的属性可用于指定文本的格式。 例如,若要创建仅包含纯文本的基本消息,请将 textFormat 对象的属性 Activity 设置为 文本,将 text 属性设置为邮件内容,并将属性设置为 locale 发件人的区域设置。

附件

attachments Activity 对象的属性可用于发送简单的媒体附件(图像、音频、视频、文件)和富卡。 有关详细信息,请参阅 向消息添加媒体附件向消息添加富卡

实体

entities Activity 对象的属性是一组开放式 schema.org 对象,允许在通道和机器人之间交换通用上下文元数据。

Mention 实体

许多通道支持机器人或用户在会话上下文中“提及”某人的功能。 若要在消息中提及用户,请使用 entities 对象填充消息的属性。

放置实体

若要传达消息中的位置相关信息,请使用 entities 对象填充消息的属性。

通道数据

channelData Activity 对象的属性可用于实现通道特定的功能。 有关详细信息,请参阅 “实现通道特定的功能”。

建议操作

suggestedActions Activity 对象的属性可用于显示用户可以点击以提供输入的按钮。 与显示在富卡中的按钮(即使在点击后仍然可见且可供用户访问)不同,在用户进行选择后,显示在建议操作窗格中的按钮将会消失。 有关详细信息,请参阅 向消息添加建议的操作

其他资源