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