← 返回自动化PRD说明

WOA与飞书自动化消息推送格式说明

DF AI · 渠道适配与交付格式参考

本说明仅列出DF AI各交付格式在WOA与飞书中的官方消息容器、发送方式及参考地址。飞书以应用机器人服务端接口为范围,群自定义Webhook的能力需另行核对。

1 各交付格式的官方支持方式

交付格式WOA:官方方式与地址飞书:官方方式与地址
自动由DF AI选择文字、富文本、卡片或文件消息;
官方没有独立的“自动”消息类型。
由DF AI选择text、post、interactive或file消息;
官方没有独立的“自动”消息类型。
文本(MD)使用text消息,正文格式显式声明markdown;
也可使用卡片中的Markdown文本。Markdown表格不能仅凭通用Markdown支持就认定客户端可正确显示。
使用卡片Markdown组件,通过interactive消息发送;
JSON 2.0卡片Markdown支持表格。精细表格可使用原生table组件;
普通text消息不能当作同样的Markdown容器。
图文使用rich_text结构化富文本,或card中的文本和图片组件;
图片先上传取得storage_key,再按消息结构引用。
使用post富文本消息,或interactive卡片中的文本和图片组件;
图片先上传取得image_key。
PDF采用文件消息:先申请会话上传地址并上传,取得storage_key,再按file/local结构发送PDF文件。先上传PDF文件取得file_key,再使用file消息发送;
上传接口提供pdf文件类型。
HTML以Markdown链接或卡片链接发送已托管HTML报告地址;
可参考客户端webview协议打开网页容器。完整HTML不是独立消息类型;
通用文件流程不能据此保证任意HTML后缀或聊天内网页预览。
使用卡片Markdown的HTTP/HTTPS链接打开已托管报告。卡片支持的部分HTML标记不等于运行完整HTML网页;
HTML文件上传按一般文件规则另行确认,不据此承诺聊天内网页预览。
Excel采用文件消息:上传取得storage_key,再发送file/local文件消息;
具体文件后缀、大小和客户端预览限制按官方接口及部署版本确认。
先上传文件取得file_key,再发送file消息;
文件上传接口提供xls类型,具体扩展名与限制按官方接口说明配置。

2 通用发送与上传入口

WOA

飞书

3 使用边界