你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
机器人将会发送类型为消息的活动对象来向用户传达信息,并且,也会从用户那接收消息活动。 某些消息可能只包含纯文本,而另一些可能包含更丰富的内容,例如 建议的操作、媒体附件、富卡和 特定渠道的数据。 本文介绍一些常用的消息属性。
消息文本和格式
可以使用 纯文本、 markdown 或 xml 设置消息文本的格式。 属性的默认格式 textFormat 是 Markdown ,并使用 Markdown 格式标准解释文本。 文本格式支持级别因通道而异。
小窍门
有关每个通道支持的功能的详细信息,请参阅通道参考一文。
textFormat
Activity 对象的属性可用于指定文本的格式。 例如,若要创建仅包含纯文本的基本消息,请将 textFormat 对象的属性 Activity 设置为 纯文本,将 text 属性设置为邮件内容,并将属性设置为 locale 发件人的区域设置。
附件
attachments
Activity 对象的属性可用于发送简单的媒体附件(图像、音频、视频、文件)和富卡。 有关详细信息,请参阅 向消息添加媒体附件 和 向消息添加富卡。
实体
entities
Activity 对象的属性是一组开放式 schema.org 对象,允许在通道和机器人之间交换通用上下文元数据。
Mention 实体
许多通道支持机器人或用户在会话上下文中“提及”某人的功能。 若要在消息中提及用户,请使用 entities 对象填充消息的属性。
放置实体
若要传达消息中的位置相关信息,请使用 entities 对象填充消息的属性。
通道数据
channelData
Activity 对象的属性可用于实现通道特定的功能。 有关详细信息,请参阅 “实现通道特定的功能”。
建议操作
suggestedActions
Activity 对象的属性可用于显示用户可以点击以提供输入的按钮。 与显示在富卡中的按钮(即使在点击后仍然可见且可供用户访问)不同,在用户进行选择后,显示在建议操作窗格中的按钮将会消失。 有关详细信息,请参阅 向消息添加建议的操作。