需打通飞书审批事件与workbuddy权限管理api:一、启用飞书approval_instance_result_change事件订阅并配置接收地址;二、映射审批表单字段至workbuddy变量;三、配置权限开通api连接器;四、构建事件驱动工作流;五、通过测试审批单验证全流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已配置WorkBuddy与飞书完成基础集成,但希望在飞书审批单通过后自动触发权限开通动作,则需将飞书审批事件与WorkBuddy的权限管理API打通。以下是实现该自动化工作流的具体步骤:
一、启用飞书审批事件订阅能力
飞书审批流程结束后会通过事件回调通知外部系统,必须先为应用开通并配置审批通过事件(approval_instance_result_change)的监听权限,否则WorkBuddy无法感知审批状态变更。
1、进入飞书开放平台对应企业自建应用的「事件订阅」设置页。
2、点击「添加事件」,在搜索框中输入approval_instance_result_change,勾选该事件类型。
3、填写WorkBuddy实例的统一事件接收地址,格式为:https://your-workbuddy-domain.com/api/v1/feishu/event。
4、保存后点击「验证URL」,确保飞书能成功调用该地址并返回200响应。
5、在事件签名密钥区域复制当前App的Verification Token与Encrypt Key,后续用于校验事件真实性。
二、配置飞书审批表单字段映射规则
审批单中需明确标识待开通权限的目标对象(如员工飞书ID或邮箱)及权限类型(如“文档编辑”“群组管理”),WorkBuddy需从审批结果中准确提取这些结构化字段,避免硬编码解析。
1、登录飞书审批后台,打开目标审批模板,进入「表单设置」。
2、确认至少包含以下两个必填字段:申请人飞书ID(单行文本/用户组件)、申请权限类型(多选下拉框,选项值固定为doc_edit、chat_manage、calendar_admin等预定义编码)。
3、记录各字段在审批实例数据中的JSON路径,例如:$.approver_user_id、$.approval_form_values.permission_type.value。
4、在WorkBuddy【集成中心】→【事件解析器】中新建飞书审批解析规则,绑定上述路径至内部变量名:target_user_id、requested_permissions。
三、创建权限开通API连接器
WorkBuddy需调用自有权限管理系统或第三方IAM服务的API完成实际授权操作,该连接器封装了认证方式、请求构造与失败重试逻辑。
1、进入【集成中心】→【新建连接器】,选择「手动配置HTTP API」。
2、命名连接器为“内部权限开通API”,端点URL设为:https://iam.internal.company.com/v1/authorize。
飞书任务管理工具,支持任务的创建、查询、更新、删除及清单的管理。适用场景:创建/管理任务与清单、查看任务列表或清单中的任务、用户提及任务、待办、to‑do、清单、task时、设置负责人和关注等。
3、在【请求头】中添加Authorization: Bearer {credentials.iam_admin_token},其中凭证已在【API凭证管理】中预先配置。
4、在【请求体】中选择JSON格式,填入模板:{"user_id":"{event.target_user_id}","permissions":{event.requested_permissions},"source":"feishu_approval"}。
5、在【响应映射】中设置成功判定条件为状态码=201且$.result == "success";错误信息提取路径为$.message。
四、构建审批后自动开通工作流
该工作流作为事件驱动型AI流程,在接收到飞书审批通过事件后立即执行,无需人工干预,所有参数由事件解析器自动注入。
1、进入【AI工作流设计台】,点击「新建事件驱动流程」。
2、触发器选择「飞书审批事件」,筛选条件设为:event_type == "approval_instance_result_change" 且 approval_result == "approved"。
3、拖入「权限开通API」连接器节点,自动绑定target_user_id与requested_permissions变量。
4、添加「条件分支」节点,判断API调用是否成功:若失败,则触发钉钉告警节点,推送错误详情至运维群。
5、保存流程并启用,状态显示为「已激活」即表示开始监听飞书审批事件。
五、测试审批闭环与日志验证
真实审批流程涉及多级审批人、驳回重提等边界情况,必须使用测试审批单验证全流程是否稳定可靠,重点关注事件送达时效性与参数完整性。
1、在飞书审批后台提交一条测试单,填写真实员工ID与权限类型,提交后等待审批通过。
2、登录WorkBuddy【系统日志】→【事件追踪】,筛选时间范围与事件ID,确认收到approval_instance_result_change事件。
3、检查日志中解析出的target_user_id与requested_permissions值是否与审批单一致。
4、查看权限开通API调用记录,确认返回状态码201及响应体中的result字段为"success"。
5、登录目标员工飞书账号,验证其是否已获得所申请的文档或群组操作权限。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










