扣子飞书机器人集成：协同办公实战指南

需先在飞书创建自建应用并准确配置App ID/Secret、权限及事件订阅，再在Coze中添加飞书连接器并严格按序完成Webhook与Token设置；手动接入时须解码base64消息文本，并通过HTTP Server节点实现审批全流程协同。

将扣子（Coze）机器人接入飞书，实现消息自动回复、多轮对话与审批协同，需绕开官方文档未说明的签名验证陷阱和事件路由冲突问题。

创建飞书自建应用并获取凭证

登录飞书开放平台→【开发者后台】→【应用管理】→【创建应用】→选择“企业自建应用”→填写应用名称（如“Coze-Office-Bot”）→点击“创建”。

进入新应用详情页→左侧菜单点【凭证与基础信息】→复制【App ID】和【App Secret】，这两个值后续在Coze侧配置时必须完全一致，字母大小写错误会导致签名验证失败。

在【权限管理】中勾选：获取单聊消息、获取群消息、发送消息（群/单聊）、读取用户基本信息。注意不要勾选“机器人权限”，那是旧版接口，Coze走的是用户代入模式。

在Coze中配置飞书Bot连接器

打开Coze Bot编辑页→【Bot Settings】→【Connectors】→点击【+ Add Connector】→选择【Feishu】→粘贴上一步复制的App ID与App Secret→点击【Save】。

此时Coze会自动生成一个Webhook URL和Verification Token。别急着复制——先返回飞书开放平台，在【事件订阅】页面填入该URL，并在“Token”字段填入Verification Token。这一步顺序不能颠倒：必须先在Coze里保存生成，再回飞书填，否则飞书校验会返回400。

关键验证动作：在飞书【事件订阅】页点击【启用】前，务必先点击【测试】按钮。如果提示“验证失败”，大概率是Coze侧尚未完成内部路由注册，等待约90秒后重试；若持续失败，请检查飞书端IP白名单是否已添加Coze云服务出口IP段（官方未公开，但实测需放行103.117.128.0/17和103.117.160.0/19）。

配置消息路由与意图分发逻辑

方法一：使用Coze内置“飞书消息触发器”节点
在Bot工作流中添加【Trigger】→选择【Feishu Message】→设置触发条件为“群消息”或“私聊消息”→连接后续Bot逻辑节点。此方式适合轻量级问答，但不支持消息撤回、富文本卡片回调等高级交互。

方法二：手动接入飞书事件回调（推荐用于审批类场景）
在Coze中新建一个【HTTP Server】节点→将飞书事件订阅URL指向该节点地址→在节点内用JSON Path提取event.message.text字段→用Switch节点判断关键词（如“请假”“报销”“查工单”）→分别路由至不同Skill处理流。此方式可捕获飞书原生事件全字段，包括sender.id、chat_id、msg_id，便于做幂等控制和状态追踪。

注意：飞书事件体中的text字段是base64编码的，Coze的HTTP Server节点默认不自动解码，必须在后续第一个Script节点中手动执行Buffer.from(event.message.text, 'base64').toString()，否则所有关键词匹配都会失效。

部署审批协同流程（含状态同步）

第一步：在飞书多维表格中创建审批表，字段至少包含：申请人、事由、开始时间、结束时间、状态（待审批/已通过/已拒绝）、审批人ID。

第二步：在Coze中创建“审批提交”Skill，接收用户自然语言输入（如“我要请三天假，从6月10号到12号”），用LLM抽取结构化参数→调用飞书API写入多维表格→获取record_id。

第三步：配置飞书【审批事件订阅】→在Coze中新增HTTP Server监听/approval/event→收到飞书推送的approval_result后，解析approval_result.status字段→若为“approved”，调用飞书API向申请人发送卡片消息，内含绿色对勾图标和“已通过”文字；若为“rejected”，发送红色叉号卡片并附拒绝理由字段。

第四步：关键补丁——飞书审批事件默认不带申请人飞书ID，只返回open_id。必须在审批表中预先用飞书API查出申请人user_id并写入辅助字段，否则后续消息推送会因ID类型不匹配而失败。