使用 Bot Connector API 创建消息

机器人将发送“消息”类型的 Activity 对象向用户传递信息,同样也将收到来自用户的“消息”活动 。 某些消息可能只包含纯文本,而另一些可能包含更丰富的内容,例如 建议的操作媒体附件富卡特定渠道的数据。 本文介绍了一些常用的消息属性。

消息文本和格式设置

可使用 plain、markdown 或 xml 设置消息文本的格式 。 textFormat 属性的默认格式是 markdown,并使用 Markdown 格式设置标准解释文本 。 文本格式支持的级别因通道而异。

提示

有关每个通道支持的功能的详细信息,请参阅通道参考一文。

textFormat 对象的 属性可用于指定文本的格式。 例如,要创建只包含纯文本的基本消息,请将 textFormat 对象的 Activity 属性设置为“plain”,将 属性设置为消息内容,并将 text 属性设置为发送方的区域设置。

Attachments

attachments 对象的 的属性可用于发送简单的媒体附件(图像、音频、视频、文件)和资讯卡。 有关详细信息,请参阅向消息添加媒体附件向消息添加资讯卡

实体

entities 对象的 属性是一组开放式 schema.org 对象,它允许在通道和机器人之间交换通用上下文元数据。

Mention 实体

许多通道支持机器人或用户在会话上下文中“提及”某人的功能。 要在消息中提及某位用户,请使用 entities 对象填充消息的 属性。

位置实体

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

通道数据

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

建议的操作

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

其他资源