Skip to main content

一、功能简介

为满足广大开发者在个性化应用开发方面的需求,钉钉OA审批2024年09月01日起陆续上线了一批面向智能OA客户的专享OpenAPI。这些专享OpenAPI将提供更丰富的能力,响应更个性化的业务需求,支持不同场景下的企业内部应用开发,建议开发者更合理、有效地使用OpenAPI,打造更健康的钉钉开放生态。

二、适用场景

钉钉可能会因法律法规或政策调整、执行监管指令所需,或者为维护钉钉服务安全性等,对以下接口的范围或具体功能进行增加、修改或删除。实际对客户开放的接口以钉钉开放平台届时公示的内容为准。

1、企业自建审批中心

客户多套业务系统(企业自研或采购的第三方系统)中的审批任务已接入钉钉审批中心,希望借助钉钉OA审批开放能力帮助企业自建审批中心,来实现分来源筛选、批量审批等功能:
企业自建审批中心实践案例,审批任务列表支持分来源筛选和批量审批

2、流程交接解决方案

客户希望借助钉钉OA审批开放能力,在企业业务系统内实现钉钉官方OA审批流程交接功能,实现管理员批量将审批任务转交给组织内其他人员。 管理员查询指定员工的待处理任务列表:
流程交接实践案例,管理后台查询指定员工的待处理审批任务列表
管理员批量转交待处理任务给组织内其他人员:
流程交接实践案例,勾选待处理任务后弹出转交审批单窗口批量转交

3、流程中心集成(自定义业务分组)

客户希望把多个三方系统的审批任务都集中在钉钉审批中心,做一站式沉浸审批。同时希望在钉钉待办中心支持自定义业务分类、列表页一键审批,为用户、特别是审批事项繁多的管理层带来超级体验。 支持在待办中心自定义业务分类,查阅三方业务系统来源待办更清晰:
自定义业务分组实践案例前后对比,待办中心OA审批分类下新增二级业务来源分组
支持在待办中心列表页快捷审批来源于三方业务系统的待处理任务:
自定义快捷审批实践案例前后对比,待办中心列表页可直接同意或拒绝三方系统任务

4、流程中心集成(审批页面托管模式)

客户业务系统自有流程引擎,希望以自有OA审批模式集成,但没有 H5 详情页面,希望能复用钉钉官方OA审批详情页,并可自定义审批操作区:将不同业务系统的审批单结构、样式统一,为用户提供多端(移动端/PC/平板)一致体验;审批操作区按钮可自定义(同意、拒绝、转交、打印等)。 支持三方自有OA审批使用官方详情页样式:
审批页面托管实践案例,三方自有审批单以钉钉官方详情页样式展示
移动端详情页同样支持自定义审批操作区:
审批页面托管实践案例手机端详情页,底部操作区展示自定义的拒绝和同意按钮
支持三方业务自定义配置/渲染审批操作区按钮(同意、拒绝等),且可透出三方业务执行异常报错文案详情:
审批页面托管实践案例前后对比,PC端详情页操作区按钮可自定义并透出异常报错信息

三、操作步骤

上述专享 OpenAPI,标准版客户需要 升级智能OA 后才可申请使用;部分客户在2024年 9 月 1 日上线前已经参与公测,获得了这些 OpenAPI的调用权限,请按以下规则调用: 权限申请路径:开发者后台 > 应用开发 > 钉钉应用 > 新建应用或已有应用 > 点击应用 >【权限管理】>【OA审批】,选择申请需要的权限:
开发者后台应用权限管理页面,在OA审批分类下勾选申请所需的接口权限

四、常见问题

标准版钉钉客户无法使用智能OA的专享OpenAPI,需要先 升级智能OA 后才能调用这些接口,专享OpenAPI使用时消耗智能OA的OpenAPI额度。
2024年 09月 01日起,开发者可在开放平台开发者文档及 开发者后台 中看到本次上线的专享OpenAPI。

五、相关文档

流程中心开放方案

四种企业业务系统接入钉钉OA审批的方案总览

三方流程页面对接

业务系统发起,钉钉端内打开业务系统详情页审批