使用 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 属性。

位置实体

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

通道数据

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

文本到语音转换

Activity 对象的 speak 属性可用于指定机器人要在启用语音的通道上说出的文本,Activity 对象的 inputHint 属性可用于影响客户端麦克风的状态。 有关详细信息,请参阅向消息添加语音向消息添加输入提示

建议的操作

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

其他资源