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