# 三方审批接入指南

三方审批接入，即飞书审批支持将外部系统（企业自研或采购的第三方系统）的审批任务推送到飞书审批应用。审批任务可以实时多端（PC、手机、Pad）触达用户，并通过 **飞书审批的嵌入式单据** 打开，用户在飞书审批中即可统一查看和处理所有审批，享受一站式的审批体验。同时结合对话框消息推送、一键转发聊天、每日待办提醒、效率看板等功能，从审批发起、处理到统计全面提升审批效率。
- 如有审批接入诉求，可[预约方案演示](https://wenjuan.feishu.cn/m?t=syKbxL1vcOsi-1x4e)。
- 了解如何使用飞书审批可参考[飞书审批管理员手册](https://www.feishu.cn/hc/zh-CN/articles/360033971554#magicdomid-1_3114)。

## 适用场景

中大型企业的审批往往分散在不同的业务系统中，审批人每天需要花费时间切换不同系统去处理审批，操作繁琐且浪费时间，而且审批人很容易忘记，导致业务不能及时得到处理，影响企业的管理效率，高层管理者面临的审批类型和数量更多，问题往往也更加严重。

![0818修改.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b7d8a821ed44fd99a44fcf625a9f3106_vyFuBVc7qe.png?height=1520&lazyload=true&maxWidth=600&width=3200)

飞书审批提供了轻量的对接方式，企业无需改造原有的业务系统，只需在数据层将审批任务汇总推送到飞书审批，审批人即可“一站式”查看和处理所有审批任务，并且通过每日待办提醒、快捷审批、列表自动聚类等功能，提升审批人的处理效率。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/54afeaf394919c936a2a3ecb3b5fa569_LFSOvtdMKR.png?height=1520&lazyload=true&maxWidth=600&width=3200)

## 接入价值

- **审批中心将分散在各处的审批单据聚合，减少多入口的不便利，打造“一站式”的审批管理中心**

- 通过集成将原本分散在企业 OA、人力资源、财务等各系统中的单据集合到审批中心列表中，并提供统一、便捷的操作、查询方式。
	- 审批中心支持将三方系统的审批页面嵌入或侧边抽屉的形式打开，减少审批人页面跳转情况，带来连贯顺畅的审批体验。
	- 页面结构及设计简洁，同时适配 PC、手机、Pad ，多端无缝切换，推广、上手门槛低。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b10957163d4f3269082b5fe70da69e1e_5kprDPsLlC.png?height=435&lazyload=true&maxWidth=600&width=1280)

- **接入审批中心为业务提效赋能，助力更高效的审批流转效率**

- 集成后的待办审批任务会通过 bot 消息聚合后推送每日待办，降低审批流转时间，减少审批任务长时间滞留情况。
    - 集成后可快捷将审批转发到聊天中，审批人在沟通中即可完成审批。
    - 审批流转情况将汇集到审批效率看板中，管理效率的提升直观可视化。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/59eea8d0b807df256175282c366d99e4_Tdyg11Pw0t.png?height=1716&lazyload=true&maxWidth=600&width=2500)

- **提供统一、简洁的审批操作，给审批人更轻松的审批体验**

- 审批中心建立在飞书生态环境下，各系统间的连接性更好，可拓展使用场景更广。
	- 审批中心通过自动聚类、标记稍后处理等形式，以审批人的视角提升处理效率，带来更轻松的审批体验。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/e2e81f5eb47db82a73afacc7c7f16572_At3XXIwK1P.png?height=1350&lazyload=true&maxWidth=600&width=2400)

## 最佳实践

字节跳动的审批之前分散在 23 个系统中，现在审批人可以通过审批中心进行“一站式审批”：

-   从集成到审批中心前后对比来看，完成一单审批中全部节点审批的时间缩短 **48%** 。
-   将审批待办聚合并提醒，能一定程度上避免因审批环境分散而导致有单据遗漏不能得到及时处理的情况，对 24 小时内的消息阅读率有显著提升 **6.62%** 。
-   在字节跳动每天有约 **25000+** 的审批任务被完成的背景下，效率提升显著。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/3efd022366e3554df11f9da966244ea9_bTnLWrOLzj.png?height=1602&lazyload=true&maxWidth=600&width=2560)

## 接入方式与成本

### 方式一：**使用飞书审批提供的集成工具**

飞书官方自研的用于对接三方厂商 OA 系统的连接器 Connector，以满足低成本集成三方审批，在飞书内使用审批功能的需求。

#### 客户成本

标准能力，部署可用，无需额外开发，由专业实施人员提供支持。

#### 接入方式

[审批官方连接器](https://open.feishu.cn/document/ukTMukTMukTM/ukjNyYjL5YjM24SO2IjN/official-approval-connector)目前仅支持部分高频使用的三方 OA 系统，且部分接入方式付费，你可以[点击此处联系飞书审批团队获取集成支持](https://wenjuan.feishu.cn/m?t=syKbxL1vcOsi-1x4e) 。

### 方式二：通过审批的开放能力自助集成

由你或合作伙伴使用飞书审批提供的开放能力（[OpenAPI 与事件](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval-overview#6a043c9e)），完成三方审批系统与飞书审批中心的数据对接，实现在飞书内使用审批功能。

#### 客户成本

需要你或你选定的三方技术合作伙伴对三方审批系统和飞书审批中心进行对接，对接周期一般在 2~4 周。

#### 接入方式

调用审批 API 关联三方审批系统和飞书审批中心的数据，实际审批流程仍然是在三方审批系统内完成，但是整个审批流程的状态变化可以实时同步到飞书审批，审批提交人、审批审核人只需要在飞书内“一站式”操作即可完成审批相关操作。接入流程如下图所示：

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/29ad2c508cee634d487301c8c0dacb21_VKylxzVFpf.png?height=884&lazyload=true&maxWidth=600&width=953)

#### 流程概述

1. 企业管理员或开发者需要先调用[创建三方审批定义](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_approval/create)接口，将三方审批系统和飞书审批中心关联起来，其中包括：审批流程在飞书内的唯一标识、分组、名称与描述；在飞书提交审批时需要访问的三方审批链接；三方审批系统的回调 URL（用于接收审批任务在飞书内发生的变化）等信息。

2. 审批提交人在飞书客户端内发起一次审批。

该过程中，开发者需要调用[同步三方审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create)接口，同步三方审批系统内的审批实例、任务、抄送等数据。

3. 待审批流转到指定节点时，由审批人处理对应的审批任务。

该过程中，开发者需要调用[发送审批 Bot 消息](https://open.feishu.cn/document/ukTMukTMukTM/ugDNyYjL4QjM24CO0IjN)接口，在飞书客户端向各个审批人推送审批消息通知，审批人可以在消息通知的卡片内一键完成审批。

4. 开发者继续调用[同步三方审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/create)接口，更新审批实例与任务的状态，最后再调用[校验三方审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/external_instance/check)接口，确保已经将审批的最新状态同步到飞书审批中心。

#### 上手体验

飞书开放平台提供了基于开放能力接入三方审批的场景教程，你可参考[快速开发三方审批](https://open.feishu.cn/document/home/quickly-develop-three-party-approvals/introduction)体验接入流程。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/111e1e1a9549c1e3b024a56c3a9e0ebf_gSL5ZEenVA.png?height=600&lazyload=true&maxWidth=350&width=1128)

## 常见问题

### 飞书审批和三方系统是怎么对接的，是不是要把流程搬过来？

不需要。飞书审批采用的是轻量对接方式，只在数据层面打通，在飞书审批中打开的页面还是三方系统的单据详情，使对接成本降低，且实现审批流程数据一站式查看的体验。

### 什么样的审批可以被集成到飞书审批？

无论是企业自建审批系统还是采购的第三方审批系统，只要企业可以获取到审批任务数据，就可以对接飞书审批。企业自建系统理论都可以对接，三方系统中，目前我们官方审批连接器已经可实现对**泛微 OA、致远**等 OA系统快速集成，其他 OA 系统也可通过审批开放能力实现集成。

### 相比企业自己开发 OA，飞书审批集成方案有什么优势？

- 与飞书套件的深度打通：企业自己开发的 OA 与飞书套件是割裂的，仅仅是在飞书内增加了一个应用，而飞书审批作为官方应用可以与飞书套件做更深度的集成，意味着更优体验和更高效率。飞书审批可以支持直接在飞书消息、云文档、邮箱进行审批，让审批的动作更贴近行为发生的地方。
- 审批效率和信噪比持续优化：部分企业自己的 OA 往往开发上线之后很难再投入大量资源进行持续优化，而飞书审批团队会持续在效率和信噪比提升上进行投入，目标是打造“处理效率最高的审批系统之一”。