机器人将发送“消息”类型的 Activity 对象向用户传递信息,同样也将收到来自用户的“消息”活动 。 某些消息可能只包含纯文本,而另一些可能包含更丰富的内容,例如 建议的操作、媒体附件、富卡和 特定渠道的数据。 本文介绍了一些常用的消息属性。
消息文本和格式设置
可使用 plain、markdown 或 xml 设置消息文本的格式 。
textFormat
属性的默认格式是 markdown,并使用 Markdown 格式设置标准解释文本 。 文本格式支持的级别因通道而异。
提示
有关每个通道支持的功能的详细信息,请参阅通道参考一文。
textFormat
对象的 属性可用于指定文本的格式。 例如,要创建只包含纯文本的基本消息,请将 textFormat
对象的 Activity
属性设置为“plain”,将 属性设置为消息内容,并将 text
属性设置为发送方的区域设置。
Attachments
attachments
对象的 的属性可用于发送简单的媒体附件(图像、音频、视频、文件)和资讯卡。 有关详细信息,请参阅向消息添加媒体附件和向消息添加资讯卡。
实体
entities
对象的 属性是一组开放式 schema.org 对象,它允许在通道和机器人之间交换通用上下文元数据。
Mention 实体
许多通道支持机器人或用户在会话上下文中“提及”某人的功能。 要在消息中提及某位用户,请使用 entities
对象填充消息的 属性。
位置实体
要在消息中传达与位置相关的信息,请使用 entities
Place 对象填充消息的 属性。
通道数据
channelData
对象的 的属性可用于实现通道特定的功能。 有关详细信息,请参阅实现通道特定的功能。
建议的操作
suggestedActions
对象的 属性可用于提供用户能单击进行输入的按钮。 与资讯卡中显示的按钮(即使在单击后仍然可见且可供用户访问)不同,建议的操作窗格中显示的按钮将在用户进行选择后消失。 有关详细信息,请参阅向消息添加建议的操作。