跳到主要内容

对接飞书审批流程

NineData 平台与飞书审批系统深度集成，支持通过飞书发起、审批、撤销数据管理类任务流程，确保审计合规性与流程自动化。

前提条件​

  • 已通过企业管理员权限的账号登录飞书开放平台。
  • 已通过系统管理员权限的账号登录 NineData 平台。

注意事项​

  • 敏感操作审计：所有审批日志自动留存 180 天。

  • 字段兼容性：禁止修改标准模板中的系统保留字段。

  • 身份映射：需确保飞书 employee_id 与 NineData 账号体系一致。

步骤一：创建并发布飞书应用​

  1. 访问飞书开放平台。

  2. 单击创建企业自建应用，输入应用名称和应用描述，选择合适的应用图标，单击创建。

    image-20250304143544747

  3. 在左侧导航栏，单击基础信息下方的凭证与基础信息，记录应用凭证区域中的 App ID 和 App Secret。

    image-20250304143737803

  4. 在左侧导航栏，单击开发配置下方的权限管理，然后单击页面中的批量导入/导出权限。在导入页签中的 JSON 框中，粘贴如下 JSON 串，然后单击下一步，确认新增权限，并单击申请开通。

    {
      "scopes": {
        "tenant": [
          "approval:approval",
          "approval:approval:readonly",
          "approval:definition",
          "contact:user.id:readonly"
        ],
        "user": [
          "approval:approval",
          "approval:definition",
          "contact:user.id:readonly"
        ]
      }
    }

  5. 页面跳转至“应用身份权限”可访问的数据范围，在通讯录 > 权限可访问的数据范围右侧，单击配置。

    image-20250304144730692

  6. 单击全部成员，单后单击保存。

    image-20250304144856898

  7. 在左侧导航栏，单击应用发布下方的版本管理与发布，然后单击页面右侧的创建版本。

    image-20250304145304925

  8. 输入应用版本号和更新说明，单击保存。在确认窗口中，单击确认发布即可。

    image-20250304163238078

步骤二：在 NineData 中绑定飞书应用​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击>。

  3. 单击页签，然后单击页面 右侧的。

  4. 单击下方的。

  5. 在窗口中，输入【步骤一】的第 3 步中记录的 AppID和AppSecret，选中，然后单击即可。

    提示

    选中的情况下，NineData 会自动在飞书审批管理后台创建审批流程。

  6. 绑定完成后，单击渠道中右侧的 ID。

    image-20250304175421482

  7. 在窗口中，记录。

步骤三：配置回调事件监听​

  1. 访问飞书开放平台。

  2. 单击步骤一中创建的应用，在左侧导航栏，单击开发配置下方的事件与回调。

  3. 在事件配置页签，单击订阅方式右侧的edit图标，选择将事件发送至开发者服务器。在请求地址下方的文本框中，输入步骤二的第 7 步记录的，然后单击保存。

  4. 在页面下方已添加事件区域，单击右侧的添加事件。在添加事件页面，输入关键字【审批实例】，查找到审批实例状态变更项，选中该项然后单击确认添加即可。

    image-20250304182431212

步骤四：配置审批流程​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击>。

  3. 单击页签，找到目标需要启用飞书审批的审批流程，单击流程名称，进入页面。

  4. 单击需配置的任务类型页签，然后单击目标流程右侧的。勾选页面下方的，在下方左侧选框中选择飞书审批，然后在右侧选择对应的飞书流程 ID，单击即可。

    image-20250305171546264