飞书互动卡片(Feishu Card JSON v2)是一种用于在飞书平台中发送结构化交互消息的工具,旨在替代传统的纯文字问答形式。当需要用户进行表单填写、选项选择、操作确认或查看复杂数据时,通过发送卡片消息可以显著提升沟通效率和用户体验。该工具基于 JSON 2.0 规范构建,支持丰富的组件组合与灵活的布局设计,适用于多种业务场景下的信息展示与用户交互需求。开发者可通过 feishu-cards 插件提供的三个核心接口——feishu_send_card、feishu_send_form 和 feishu_update_card——实现卡片的创建、发送与动态更新功能。卡片结构包含 schema、config、header 和 body 四个顶层字段,其中 header 定义标题样式与图标,body 则承载各类内容组件与交互元素。整体设计兼顾美观性与功能性,支持响应式宽度模式、自定义颜色模板及转发控制等高级特性。
核心功能特点
- 支持发送含表单、按钮、表格等元素的交互式卡片,替代纯文本消息提升沟通效率
- 提供 feishu_send_card / feishu_send_form / feishu_update_card 三大工具函数,分别用于发送、更新卡片及带表单的专用卡片
- 卡片采用 JSON 2.0 架构,包含 header(标题栏)、body(内容区)、config(配置项)和 card_link(外链)四大模块
- 内置多种内容组件如 markdown 富文本、图片混排、图表、人员列表、音频播放等,满足多样化信息展示需求
- 交互组件涵盖输入框、下拉选择、日期时间选择器、勾选器、多图选择等,并支持回调机制获取用户操作结果
- 支持流式更新、共享卡片、自定义预览摘要等功能,增强消息的可维护性和传播性
适用场景
飞书互动卡片特别适合需要用户主动参与或快速反馈的业务流程。例如,在审批流程中,系统可发送一张带有确认/取消按钮的卡片,让用户直接在聊天界面完成高风险操作的二次确认,避免误触并记录操作意图。对于任务分配场景,可通过人员选择组件指定负责人,并结合状态标签直观呈现当前进度。当需要收集用户反馈时,使用表单容器搭配输入框与提交按钮,能高效汇总结构化数据,无需跳转至外部页面。此外,在数据汇报场景中,结合表格组件与图表可视化,可在单条消息内清晰展示工单列表、KPI 趋势或多维度分析结果,极大减少信息碎片化问题。折叠面板和分栏布局进一步提升了长内容的组织能力,使复杂信息更易阅读。无论是内部协作还是客户支持,飞书卡片都能将传统冗长的对话转化为紧凑、有序且可追踪的交互记录。
