You need to enable JavaScript to run this app.
导航
接入飞书审批
最近更新时间:2025.06.16 11:43:44首次发布时间:2024.09.04 14:03:45
我的收藏
有用
有用
无用
无用

您可以在飞连工作流中设置飞书审批环节,直接调用飞书的审批流程。用户在飞书审批中即可统一查看和处理对应工作流的审批,享受一站式的审批体验,全面提升审批效率。

使用限制

为了确保审批相关人员能够接收到飞书审批,员工数据源必须来自飞书。飞书组织架构导入飞连的具体操作,请参见飞书组织架构导入与第三方登录配置教程

注意事项

工作流支持接入飞书审批、Lark 审批。Lark 的配置与飞书的配置基本一致,本文仅以飞书审批为例进行介绍。

准备工作

开发飞书企业自建应用

在正式接入飞书审批之前,您需要先开发一个飞书企业自建应用,并为应用申请飞连工作流所必须的 API 权限。

  1. 登录飞书开放平台
  2. 创建一个企业自建应用。

    说明

    本文仅提供开发企业自建应用的必要步骤,完整的开发指南请参见飞书开放平台官方文档企业自建应用开发流程

  3. 创建完成后进入应用详情页,在基础信息 > 凭证与基础信息页面,保存应用凭证(包括 App IDApp Secret)。
    后续需要把应用凭证填写到飞连管理后台。
    Image
  4. 开发配置 > 权限管理页面,申请飞连工作流所必须的 API 权限。
    1. 需要选择应用身份权限 tenant_access_token,并申请以下权限。具体操作请参见飞书开放平台官方文档申请 API 权限
      • 获取通讯录基本信息
      • 获取用户 user ID
      • 查看、创建、更新、删除审批应用相关信息
      • 查看、创建、更新、删除原生审批实例相关信息
    2. 应用身份权限可访问的通讯录权限范围设置为全部成员。具体操作请参见飞书开放平台官方文档配置应用数据权限
  5. 发布应用,使以上配置生效。
    具体操作请参见飞书开放平台官方文档发布应用

创建飞书审批定义

登录飞书审批管理后台创建自定义审批定义,定义审批表单与审批流程(自定义配置,适配您的业务所需即可)。创建飞书审批定义的具体操作,请参见飞书官方文档管理员创建审批

注意

工作流中仅能映射飞书审批表单的单行文本多行文本数字联系人单选选项和多选选项控件。

步骤1:将飞书添加到飞连的第三方集成
  1. 登录飞连管理后台。

  2. 在左侧导航栏,选择工作流

  3. 工作流管理页面,单击右上角的高级配置

  4. 第三方集成页面,单击右上角的添加集成

  5. 在添加新的第三方集成项对话框中,设置相关参数,参数说明如下表所示。
    Image

    配置项

    说明

    集成项名称

    自定义的集成项名称,最多 30 个字符。

    描述

    对集成项的简要描述,最多 250 个字符。

    集成类型

    待集成的应用程序类型,包括飞书Lark

    应用 ID

    填写上文准备工作中已保存的应用 App ID。您也可以前往飞书开发者后台,进入自建应用详情页,在应用的基础信息 > 凭证与基础信息页面获取。

    应用 Secret

    填写上文准备工作中已保存的应用 App Secret。您也可以前往飞书开发者后台,进入自建应用详情页,在应用的基础信息 > 凭证与基础信息页面获取。

    主机地址

    (可选)飞书开放平台的服务端地址,支持 http 或 https 格式。

    加密密钥

    (可选)如果飞书开放平台开启了加密事件或回调,则需要配置此参数。请前往飞书开发者后台,进入自建应用详情页,在事件与回调 > 加密策略中查看 Encrypt Key 的值。

    验证令牌

    接入飞书开放平台的访问凭证。请前往飞书开发者后台,进入自建应用详情页,在事件与回调 > 加密策略中查看 Verification Token 的值。

  6. 单击确定

步骤2:在工作流中增加飞书审批环节
  1. 登录飞连管理后台。

  2. 在左侧导航栏,选择工作流

  3. 工作流管理页面,单击创建工作流

  4. 选择模版并开始配置页面,选择应用使用申请VPN资源访问权限审批工作流模版,并单击创建新工作流

    说明

    账号生命周期工作流(非审批类)不支持添加飞书审批环节。

  5. 创建工作流配置基本信息页面配置基本信息,并单击下一步,详细的参数说明请参见新建工作流

  6. 配置任务页面,单击添加新任务,选择飞书/lark审批,单击添加
    Image

  7. 飞书/lark审批页面,设置相关参数,参数说明如下表所示。配置完毕后单击确认。单击下一步

    配置项

    说明

    审批节点名称

    请规范填写审批节点的名称,审批节点名称将在用户审批表单里展示。

    集成类型

    选择步骤1:将飞书添加到飞连的第三方集成中已集成的第三方应用。

    说明

    如果之前未集成飞书,您也可以单击右侧的添加集成,集成飞书。

    选择后会展示请求 URL,您需要将该 URL 粘贴到飞书企业自建应用的事件订阅请求地址中。
    Image
    在飞书企业自建应用内需要完成以下操作。详细操作说明,请参见飞书开放平台官方文档将事件发送至开发者服务器将回调发送至开发者服务器

    1. 在应用内的开发配置 > 事件与回调 > 事件配置页面,添加事件订阅请求地址。
      Image
    2. 已添加的事件区域,添加以下事件。
      • 审批定义创建
      • 审批定义更新
      • 飞书审批评论创建
      • 飞书审批评论删除
      • 审批实例状态变更
      • 审批任务状态变更
        Image
    3. 开发配置 > 事件与回调 > 回调配置页面,添加回调请求地址。
      Image
    4. 已订阅的回调区域,订阅以下回调。
      • 卡片回传交互
      • 查看自定义名片页卡片
        Image
    5. 发布应用,使以上配置生效。
      具体操作请参见飞书开放平台官方文档发布应用

    审批定义码

    请填写飞书审批定义对应的唯一编码(Approval Code),审批定义码的获取方法如下:

    1. 进入飞书审批管理后台 > 审批管理页面,单击对应审批定义右侧的编辑图标。
    2. 在 URL 中获取对应的 definitionCode 的值。
      Image

    填写后会展示创建表单映射配置,您需要将飞书审批定义内表单控件与飞连工作流的属性值进行映射。例如,应用使用申请工作流内,可以将应用名称、申请原因、申请人范围以及申请用户等属性值与飞连审批定义进行关联。
    Image

    审批结果通知设置

    审批结果可通过邮箱第三方机器人发送通知给用户,您可以根据实际业务需要选择通知方式。

    • 邮箱:填写电子邮件主题正文并上传附件。

      说明

      为了启用电子邮件通知功能,您需要提前配置邮件网关。关于配置邮件网关的具体操作,请参见管理邮件配置

    • 第三方机器人:选择一个第三方机器人,并填写通知标题和正文消息。如果您此前从未添加过任何第三方机器人,单击+添加新机器人,添加自定义第三方机器人。关于第三方机器人配置,请参考管理第三方 IM

    说明

    您可以删除飞连工作流自带的审批节点,改为飞书审批。
    Image

  8. 审核并提交页面,确认配置信息。
    确认配置时您可以预览工单,以确保工单内容符合业务所需。
    Image

  9. 单击提交,并在提示弹窗中单击确定,立即启用该工作流。
    后续当员工发起应用使用申请工单时,审批人可以在飞书内收到审批通知。