1. 为什么你需要自定义飞书卡片消息想象一下这个场景你负责的采购审批流程启动了系统自动给审批人发了一条飞书通知。但这条通知只有干巴巴的“您有一条新的待办事项”审批人点进去还得在系统里翻找半天才能看到申请部门、采购金额、紧急程度这些关键信息。一来一回沟通成本高流程卡顿效率自然就低了。这就是传统文本通知的痛点。信息密度低、重点不突出、交互性差导致关键业务信息容易被淹没在聊天记录里。而飞书卡片消息就像给你的业务流程通知穿上了一件“定制西装”。它不再是单调的文字而是一个结构清晰、视觉突出、甚至可以交互的“信息看板”。我接触过很多使用班翎这类流程平台的企业初期集成飞书后虽然实现了消息触达但大家普遍反馈“通知是收到了但总觉得差点意思不够直观处理起来还是麻烦。” 直到他们开始尝试自定义卡片消息反馈立刻变成了“这个好一眼就能看到所有关键信息点一下按钮就能审批太方便了。”自定义飞书卡片消息的核心价值就在于“信息降噪”和“体验提效”。它允许你将业务流程中的关键数据如单据号、金额、状态、申请人、链接以更友好、更结构化的方式直接推送到审批人的飞书会话中。审批人无需跳转多个页面在消息卡片上就能完成决策所需的信息获取甚至直接进行操作如“同意”、“驳回”、“查看详情”。这不仅仅是美观更是对业务流程的一种重塑让信息流主动适配工作流极大减少了操作路径和认知负担。2. 准备工作打通班翎流程平台与飞书在开始设计花哨的卡片之前我们必须先把基础通路搭建好。这就好比你要发一封精美的电子邮件首先得确保邮箱账户能正常登录和发送。对于班翎流程平台与飞书的集成核心在于配置一个拥有发送消息权限的“机器人”或“应用”。2.1 创建并配置飞书自建应用首先你需要一个飞书开发者账号。进入飞书开放平台创建一个新的“企业自建应用”。这个应用就是你的“信使”。创建过程中有几个关键步骤我踩过坑这里特别提醒你权限配置在应用的“权限管理”页面务必找到并添加“以应用身份发送消息” (im:message) 和“获取用户信息”等核心权限。缺少发送消息权限后面一切配置都是白搭。启用机器人能力在应用的“功能”菜单下找到并启用“机器人”能力。这样你的应用才能作为一个独立的“成员”在群聊或单聊中发送消息。获取凭证配置完成后在“凭证与基础信息”页面你会得到三个至关重要的信息App ID、App Secret和Encryption Key。请妥善保存它们相当于你应用的“账号密码”。2.2 在班翎平台中配置飞书连接拿到飞书应用的“钥匙”后我们需要在班翎流程平台里把它配好。根据原始文章的指引关键配置点在“平台层-消息配置”中具体路径通常是工作流-三方消息发送配置 (HWKF.MSG_THIRD_PARTY)。在这里你需要新增一条飞书类型的消息配置。操作并不复杂找到消息类型为“飞书”的配置行如果没有就新增。填入你在飞书开放平台获取的App ID和App Secret。有些平台可能还需要配置“发送账户代码”这通常对应飞书应用的唯一标识。启用这条配置。很多朋友配置完忘了点启用结果调试半天收不到消息。这一步完成后班翎平台就具备了向飞书“喊话”的基本能力。但具体“喊什么内容”是使用平台自带的模板还是完全自定义的卡片这就是我们接下来要深入的了。3. 方法一使用工作流预置卡片样式快速上手如果你追求快速上线或者对UI要求不高只是想比纯文本更规范一些那么使用班翎流程平台自带的预置卡片样式是最佳选择。它不需要你懂任何前端代码完全在流程平台内通过配置完成。3.1 配置流程定义层的消息通知平台层的通用配置完成后具体到每个业务流程我们需要在“租户-流程定义”层面进行更细致的设置。这里有一个重要的优先级原则流程定义层的消息配置会覆盖全局层的默认配置。这给了我们极大的灵活性可以为“采购审批”和“请假申请”设置完全不同风格的通知。具体操作步骤如下进入你需要配置的流程定义例如“采购申请流程”。找到“消息通知”或类似的配置模块添加一个新的通知配置。在通知配置中关键是要选择“覆盖对应系统消息发送”并选择“自定义消息通知内容”。通知渠道自然要勾选上“飞书”。在内容来源里选择“自定义”。这里请注意使用预置样式时无需填写“外部编码”。这个“外部编码”是留给完全自定义卡片时填写飞书卡片ID用的。3.2 绑定流程变量让消息“活”起来预置卡片样式就像一个固定的相框而流程变量就是我们要放进相框里的照片。卡片上的每一个字段如“流程标题”、“申请人”、“申请时间”都需要绑定到具体的流程变量上。在班翎流程平台中当你进入消息内容编辑时通常会看到一个变量选择器。你可以从流程上下文中选择已有的变量比如${processName}流程名称、${applicant}申请人也可以使用表达式来生成更复杂的值比如${formatDate(applyTime, ‘YYYY-MM-DD HH:mm’)}来格式化时间。我的经验是在设计流程时就提前规划好需要推送哪些关键业务数据。例如采购流程的卡片上除了基础信息一定要把“采购单号”、“总金额”、“供应商名称”这几个核心业务变量绑定上去。这样审批人一眼就能抓住重点做出判断。配置完成后发起一个测试流程。你会在飞书中收到一条格式工整的卡片消息所有字段都自动填充了真实数据。虽然样式是平台固定的但信息结构清晰已经比纯文本通知前进了一大步。4. 方法二玩转完全自定义卡片打造品牌体验当预置样式无法满足你的品牌视觉或交互需求时就该祭出大招——完全自定义飞书卡片。这就像从“精装房”升级到了“自己设计装修”自由度极高可以打造出与你的企业品牌、业务场景完美契合的通知体验。4.1 禁用预置模板为自定义让路首先我们需要告诉平台“别用你自带的那个模板了用我自己的。”根据原始文章的操作你需要回到平台层的HWKF.MSG_THIRD_PARTY配置中找到飞书消息类型的那一行将其禁用或删除。同时还需要检查一个服务配置项hzero.workflow.fly_book_msg_type确保其值为“interactive”。这个配置项告诉底层服务飞书消息将使用交互式的卡片格式而非简单文本。4.2 使用飞书卡片搭建工具进行设计这是最具创造性的环节。飞书官方提供了一个非常强大的消息卡片搭建工具。它采用“所见即所得”的拖拽式设计即使你不会写代码也能轻松设计出漂亮的卡片。工具左侧是丰富的组件库标题、文本、分割线、图片、按钮、交互模块等。右侧是画布和属性面板。你可以像搭积木一样设计卡片。设计一个采购审批卡片顶部用醒目的颜色标题栏写上“采购审批申请”接着用字段-值对的形式清晰列出“单号”、“部门”、“金额”、“供应商”。中间可以嵌入一个“查看详情”按钮链接到系统内的单据页面。底部则放置“同意”和“驳回”两个交互按钮。设计一个项目里程碑通知卡片可以使用进度条组件展示项目整体进度用标签组件高亮显示当前完成的里程碑并附上负责人的头像和姓名。设计完成后点击工具上的“获取JSON”按钮你会得到一大段卡片的JSON代码。请保存好这段代码。4.3 在飞书平台创建卡片模板并获取ID拿到JSON代码后我们需要在飞书开放平台将它“注册”为一个可复用的模板。进入你的自建应用管理后台找到“消息卡片”或“卡片模板”相关功能创建一个新的卡片模板。将刚才复制的JSON代码粘贴到模板内容中保存。成功后飞书平台会为这个卡片模板生成一个唯一的card_id卡片ID。这个ID就是我们连接班翎流程平台和这个自定义卡片的桥梁。4.4 在班翎平台关联自定义卡片最后一步回到班翎流程平台。这次我们不去动HWKF.MSG_THIRD_PARTY而是找到“消息发送配置”菜单修改HWKF.TODO这类具体消息类型的模板配置。在对应的消息模板下配置飞书类型的子模板并启用。最关键的一步在“外部编码”或“模板ID”这个字段里填入你从飞书平台获取的那个卡片ID (card_id)。同样在消息模板的变量定义部分需要定义卡片JSON中用到的所有变量名。例如你的卡片JSON里有一个{{purchase_order_no}}的占位符那么在这里就需要定义一个同名的变量并配置它如何从流程数据中取值。完成以上配置后当流程触发时班翎平台就会拿着这个卡片ID和填充好的变量数据调用飞书接口发送出完全由你设计的那张精美、交互式的卡片消息了。5. 高级技巧与实战场景案例掌握了基本方法我们来看看如何用这些技巧解决更复杂的业务问题让卡片消息真正成为提升效率的利器。5.1 动态内容与条件显示卡片内容不是一成不变的。利用飞书卡片的“动态内容”特性我们可以实现更智能的通知。例如在费用报销审批场景中可以设置当报销金额超过5000元时卡片上自动高亮显示“需总经理审批”的警示标签。这需要在设计卡片JSON时使用条件判断逻辑。在飞书卡片搭建工具中你可以为组件设置“显示条件”。对应的JSON结构里会有visible: {“eq”: [ {“var”: “amount”}, 5000] }这样的条件表达式。在班翎平台配置变量时你需要确保能将流程中的“金额”变量正确传递过来供卡片进行条件判断。5.2 按钮交互与业务回传自定义卡片最强大的功能之一是交互按钮。按钮不仅仅是链接它可以携带自定义数据回传到你的业务系统。实战案例一键审批与反馈为审批卡片配置“同意”和“驳回”按钮。点击“驳回”按钮时可以弹出一个让审批人填写驳回原因的输入框。当审批人提交后这个动作和填写的理由会通过飞书的“回调事件”推送到你预先配置好的一个服务地址通常是你自己系统的API接口。班翎流程平台可以监听这个接口接收到回传数据后自动完成流程的“驳回”操作并将驳回理由更新到流程记录中。这就实现了“消息端操作流程端自动执行”的闭环审批人完全不用离开飞书。5.3 多场景融合通知一张卡片可以集成多个相关动作。比如“服务器故障告警”卡片可以同时包含“当前状态”、“影响服务”、“负责人”以及“我已接手”、“转派他人”、“查看监控”等多个按钮。将告警、认领、处理、转派等多个步骤融合在一个交互界面里极大缩短了故障响应路径。5.4 与飞书多维表格、集成平台联动除了流程平台飞书自身的生态工具也能玩出花样。正如搜索资料中提到的你可以利用飞书多维表格作为数据源结合飞书集成平台的自动化流程实现定时或触发式发送自定义卡片。例如你可以创建一个“客户生日提醒”多维表格。集成平台设置一个每日定时任务读取表格中“明天过生日”的客户列表自动生成一张精美的生日祝福卡片通过机器人发送到客户关怀群或直接发给销售负责人。这种组合拳实现了完全在飞书生态内的、低代码的自动化信息推送。6. 避坑指南与最佳实践在实际配置和使用的过程中我总结了一些常见的“坑”和让效果更好的建议。常见问题排查收不到消息首先检查飞书应用的“权限”是否开通并发布其次检查班翎平台的飞书消息配置是否“启用”最后检查接收人是否在应用可见范围内。卡片显示错乱或变量为空检查卡片JSON格式是否正确特别是引号、括号是否配对。确认班翎消息模板中定义的变量名与卡片JSON中的占位符{{variable}}是否完全一致大小写敏感。检查流程运行时这些变量是否有真实值。按钮点击无反应检查按钮的交互类型action和value值配置是否正确。确认接收回调事件的服务器地址URL可公开访问并能正确处理飞书发送的POST请求。最佳实践建议风格统一为企业内部不同流程如人事、财务、IT的卡片设计一套统一的视觉规范包括主色调、图标、排版形成品牌化的通知体验。信息精炼卡片空间有限切忌信息堆砌。只展示决策或行动所必需的关键信息更多细节可以通过“查看详情”按钮链接到系统页面。明确行动号召按钮文案要清晰明确如“批准申请”、“查看报告”、“填写进度”。避免使用“点击这里”等模糊用语。先测试后上线在正式业务流程使用前务必创建一个测试流程在小范围内进行发送测试确保卡片样式、变量替换、交互功能全部正常。关注性能如果卡片内容非常复杂如图片过多、嵌套太深可能会影响加载速度。在美观和性能间取得平衡。从我自己的项目经验来看成功落地自定义卡片消息的关键往往不是技术难度而是对业务场景的深度理解。你需要和业务部门坐在一起梳理他们的审批习惯、关注点、痛点然后把这些洞察转化为卡片上的一个字段、一个按钮、一种颜色。当一张小小的卡片能让业务人员脱口而出“这个好用”时它的价值就真正体现出来了。