# 政务钉钉集成

来源快照：`result_data_new_260518.json`

- 来源 ID：`1167664070286303894`
- 模块：云桥
- 目录：未分组
- space ID：`1159147935877833073`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 政务钉钉集成

 

# 一、功能背景及价值

目前有不少客户同时使用OA系统和政务钉钉进行企业日常办公，为更好地服务客户，满足客户的需求，我们实现了将OA系统的功能接入政务钉钉。首先需要在系统：后台管理中心->所有服务->平台引擎->云桥->政务钉钉集成，配置集成政务钉钉的相关信息。具体功能包括“通讯录同步”、“应用集成”、“消息推送” 、"扫码登录”，即实现统一管理政务钉钉通讯录，在政务钉钉访问oa的应用，在政务钉钉接收系统消息处理待办事宜，在政务钉钉上扫码免登oa等，通过这些功能可增加办公便利性，实现移动办公。

[点击查看云桥整体介绍](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159148125032554582&space_id=1159147935877833073 "点击查看云桥整体介绍")

# 二、业务流程图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664546919809076&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

# 三、功能详细说明

 

## 1.【云桥对外域名】配置

在【基础参数设置】中填写【云桥外网地址】和【云桥内网地址】，点击保存即可

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664469669118074&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 2.企业集成

1.在【后台管理中心】-【平台引擎】-【云桥】中进入云桥集成页面

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664495260663883&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

2.选中【政务钉钉集成】-【新建政务钉钉】进入创建政务钉钉配置页面，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664465265098898&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

登录政务钉钉后台（https://openplatform-portal.dg-work.cn/devPage/#/myApp），点击【组织内部应用】旁的【创建应用】，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664473936822302&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

应用类型选择【H5微应用】，其他内容可自由填写，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664542720376836&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

点击【详情】，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664503950434339&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

复制应用凭证AppKey，AppSecret，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664508371230810&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在云桥中点击【新建政务钉钉】进入如下页面

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664521046417473&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

**企业名称** ：根据需要填写政务钉钉的名称

**租户ID** ：根据客户实际情况填写

**API服务地址** ：

专有钉钉填 https://openplatform.dg-work.cn （默认）

浙政钉填https://openplatform-pro.ding.zj.gov.cn

回到前面的政务钉钉后台，添加权限应用的权限（如果是专有钉钉，可以开通所有权限），如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664491099914304&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

 

最后发布应用，如下图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664469566357569&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 3.业务集成

### 3.1接口参数设置

点击【通讯录管理】的设置按钮进入设置页面

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664465265098799&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664456689844319&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

**接口权限-只读** ：只能执行从企业号同步到云桥，不能在云桥通讯录调整数据，一切以企业号的组织架构为准。

**选择应用** ：选择同步依赖的应用

### 3.2组织用户管理

政务钉钉组织架构同步分为两种：

1.

将政务钉钉的组织架构同步到云桥（不修改OA的组织架构）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664525319143595&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

2.

将政务钉钉的组织结构同步到云桥同时同步到OA（修改OA的组织架构）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664538313097275&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

#### 3.2.1从政务钉钉同步

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664516732469302&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**是否删除本地未添加用户** ：云桥存在的用户，在云之家中不存在，是否删除云桥本地用户

**用户自动绑定** ：设置本次同步过来的新成员（即云桥中不存在对应账号的成员）是否要自动建立于集成系统的关联关系

**用户字段** ：设置政务钉钉中成员字段对应eteams系统中人员字段的对应关系，若字段值可以匹配，则从政务钉钉同步可以自动关联上，具体说明可在界面点击查看用户自动说明文档

**定时同步** ：设置是否开启定时自动执行从政务钉钉同步操作，开启之后，系统会定时的将政务钉钉数据同步到移动平台中并自动建立与eteams的关联关系，具体设置建议为每隔一天同步一次，同步开始时间建议设置为凌晨2点或3点，例如开始时间设置为2019-02-02 02:00:00 则表示从2019年2月2日凌晨2点开始同步，并且每隔一天2点进行一次同步，结束时间一般不用填写

**是否同步到eteams** ：若选择是，可在从政务钉钉同步时修改eteams的用户数据，可根据需求开启，具体规则见文档[从云桥同步到E10](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1172472406387802184&space_id=1159147935877833073 "从云桥同步到E10")，如图：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664534099918939&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2.2账号关联导入

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664486765101107&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664503881121802&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664538293395479&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**导出用户账号关联关系表** ：根据需求选择需要导出的用户范围，以及用户在云桥的关联状态、政务钉钉状态、添加状态，之后点击导出人员账号关联关系表

**在导出的文件中配置【关联字段】，再进行导入** ：首先选择关联字段类型，再在第一步中导出的excel表中进行对该字段的维护，然后点击上传附件将excel表导入，即可实现人员批量关联

#### 3.2.3同步功能说明

执行【从政务钉钉同步】，把人员在政务钉钉中的身份和在OA系统中的身份关联上，可使用如下任何一种方式。

方法一：手动关联。

方法二：在从政务钉钉同步时进行自动关联：需要在【从政务钉钉同步】时，开启【新用户关联系统账号】，配置关联字段之后，进行同步。

后续可以在 【从政务钉钉家同步】时，开启定时同步，每隔一段时间将政务钉钉的组织架构的变动更新到云桥。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664503881121907&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若希望从政务钉钉同步的同时可以修改eteams的组织架构，可开启同步到eteams

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664503950434374&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.3用户绑定设置

将OA用户和政务钉钉人员绑定的方式有多种：

①

手动绑定（需要配置应用）

用户完成应用集成之后，可以直接访问应用，然后输入正确的系统账号密码后，对应集成的政务钉钉-通讯录中会记录用户的政务钉钉账号信息以及绑定关系。![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664521046417523&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664478228758589&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

自动绑定

用户字段有两个设置的地方：一个地方配置之后，其他一处也会开启自动同步；修改任意一处，也会变更其他一处的设置。

用户单点通讯录->用户绑定设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664521237151957&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

从政务钉钉同步->新用户关联系统账号

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664516861329524&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

根据配置的条件，比如：政务钉钉账号code 匹配 OA工号，如果匹配上了，就会自动将关联关系写入，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664495438921819&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

关联导入

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664478240178241&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

将已经同步到云桥本地的数据（单点写入或者从政务钉钉同步写入）导出，并且将需要绑定的OA人员的对应字段写入到文档中，上传文档，点击导入按钮，即可将关联关系写入，详情可见2.2.2

④

人员卡片绑定/解绑

将云桥本地的数据和OA的人员进行绑定或者解绑

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664533962670129&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664542540955688&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

⑤

批量解绑

解除云桥本地所有人员和OA人员的关联关系。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664499653263531&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

## 4.应用集成

应用管理功能主要是在移动平台中将政务钉钉应用与业务系统（eteams）功能模块进行对接，即实现在政务钉钉中使用业务系统的相关业务功能

1.

点击添加应用

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664542748573729&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2.

参考【企业集成】章节，在政务钉钉后台创建应用，并复制AppKey和AppSecret，填到应用的基本信息里，输入应用名称后单击保存

3.

应用主页是设置政务钉钉应用的主页功能，调用模块默认为打开应用，选择应用中心已经存在的主页型应用，如下图所示

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664534099918963&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

将应用主页地址复制至政务钉钉后台后提交审核即可

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664473933791249&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

也可使用自定义链接，将地址填入自定义链接处即可

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664482381119497&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

应用发布之后可在【控制台】里设置应用使用范围

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664546849775634&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

然后访问工作台管理后台（[ _https://admin-work.dg-work.cn/workbench_](https://admin-work.dg-work.cn/workbench) ），选择应用配置到工作台上，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664499653263504&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664499747741852&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664473936822322&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 5.消息推送

消息通过云桥推送，需要确保【消息推送设置】-【基本设置】-【消息渠道】开启了往云桥推送：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664542705803355&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 5.1消息规则配置

    消息管理功能主要是将OA应用消息推送到政务钉钉中，即实现在政务钉钉中接收并处理业务系统的消息。消息正常推送的前提是，政务钉钉用户要关联OA系统用户账号。

①

在消息中心找到需要提醒的业务事件，例如流程的待处理流程-提醒 ，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664465343856649&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

若流程模块的所有提醒都需要推送，可以在流程的总入口配置：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664529773494322&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

②

配置推送到云桥的消息推送规则，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664525324607553&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

③

推送到政务钉钉，设置推送目标后保存：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664533962670092&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

    消息类型有：通知和待办，可以根据需求选择相应的消息类型；

 

④

消息推送规则新建之后，数据会同步到云桥的消息推送规则里，可以点击【设置】按钮，对规则详情进行编辑，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664491147214889&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664495316353156&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

⑤

除了在消息中心创建消息推送规则，还可以在云桥创建消息推送规则，如下图所示：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664529695899659&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664499653263403&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

效果如下  
待办：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664461118201875&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

通知：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664533962670114&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 6.扫码登录

此功能主要实现通过政务钉钉自带的扫一扫功能扫描OA系统首页的二维码进行登录OA系统

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664538293395462&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1167664495316353036&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

开启按钮选择依赖应用即可，不在依赖应用可见范围的人员将无法使用

# 四、更多场景示例

暂无

# 五、上下游关联功能点

暂无

# 六、注意点

见第五点功能详细说明的红字标注
