# 钉钉集成流程 [TOC] ## 前提准备 ### 注册钉钉账号 注册地址:<https://oa.dingtalk.com/register_new.htm> 输入手机号,获取验证码即可。 ![](https://img.kancloud.cn/e9/ef/e9ef27e9fd27a1038f88a8b4667d1ee9_454x278.png) 第二步填写你的公司信息,邀请码没有不填就行。 ### 创建钉钉应用(H5微应用) 1. 首先登录钉钉后台 2. 点击上方导航栏的`工作台` 3. 向下滑动找到`自建应用`,并点击加号创建 ![](https://img.kancloud.cn/45/24/45247be0158a665047776278336941af_238x116.png) 4. 鼠标移动到上方导航栏的`应用开发`上,选择`企业内部开发` ![](https://img.kancloud.cn/9f/88/9f882c2356028766b8f5be059372e67c_392x233.png) 5. 点击右上角的`创建应用`按钮 6. 应用类型一定要选`H5微应用`,开发方式一定选`企业自助开发` ![](https://img.kancloud.cn/f2/20/f220a77016cf38fd04f79b65cc4aebee_426x594.png) 7. 根据实际情况填写名称和描述,之后点确定创建即可 ### 开发者IP白名单配置 1. 在新创建的应用详情里,找到左侧导航栏的`开发管理` 2. 点击右上角的`修改`按钮 3. 填写服务器出口IP,如果是测试环境,可以去百度上搜索自己的外网IP(见下图),如果是线上环境,直接填写线上的公网IP即可。 ![](https://img.kancloud.cn/dd/24/dd244eb96eff184ea56477afa09a418f_425x118.png) ![](https://img.kancloud.cn/95/9a/959a15b4d733b5a514fecce411de7bf6_905x498.png) ### 接口权限的获取 1. 打开`权限管理` 2. 点击`通讯录管理` 3. 点击全选按钮 4. 点击`批量申请`按钮 5. 注意:如果有多页,只有当前页的权限会被申请到,下一页的权限需要手动切换到下一页再申请。 ![](https://img.kancloud.cn/4e/01/4e01826a492f8562cfde9609302b5fc9_1564x736.png) >还需要在个人权限上申请`个人手机号信息`及`通信录个人信息读权限` ![](https://img.kancloud.cn/4e/9b/4e9bce2d868abb0a49ea24c7cfdeccdd_2866x1662.png) ## 对接配置 1. `AgentId`对应配置里的`agent-id` 2. `AppKey`对应配置里的`client-id` 3. `AppSecret`对应配置里的`client-secret` 4. 配置完成之后需要重启后端项目,重启完需要刷新前端页面 5. 对应关系如下图所示 ![](https://img.kancloud.cn/2d/c9/2dc97fb0b1656e420a706a9f23ab4d22_1319x307.png) ![](https://img.kancloud.cn/e8/45/e845a7d325512127e4ca338c8eb28334_808x418.png) ## 同步用户 ### 用户同步到钉钉 1. 在用户管理页面,点击同步钉钉按钮即可 ![](https://img.kancloud.cn/a1/e2/a1e29214bc72691021e53a4d8c7f796b_626x358.png) ![](https://img.kancloud.cn/9e/30/9e306aaa0b1508bac9a18f599eaaf39e_511x260.png) 2. 规则:本地同步到钉钉,钉钉上有就更新,没有就创建。本地没有但是钉钉有的,不做任何操作。 ### 从钉钉同步用户到本地 1. 需要在源码里添加如下选项 文件路径:src/views/system/UserList.vue ![](https://img.kancloud.cn/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png) ![](https://img.kancloud.cn/4b/8b/4b8b58276e5efefe313e7f4017193904_1176x139.png) 2. 再次回到页面,发现按钮变成了下拉形式,点击`同步到本地`即可 ![](https://img.kancloud.cn/b2/5c/b25c709704eaf52e26a4c3aa6bd3ffaa_575x354.png) 3. 规则:本地有的就更新,没有的就新增(默认密码123456)。本地有,钉钉没有的,不做任何操作。 ![](https://img.kancloud.cn/21/9c/219cce8deea0ef6026d3141d4caf1b67_519x260.png) ## 部门同步 ### 部门同步到钉钉 1. 在部门管理页面,点击同步钉钉按钮即可 ![](https://img.kancloud.cn/0c/dd/0cdd16fdb9b7a474f22a75c7ddc21ad0_538x409.png) 2. 规则:本地同步到钉钉,钉钉上有就更新,没有就创建。本地没有但是钉钉有的,**删除**钉钉上的。 ### 从钉钉同步部门到本地 1. 需要在源码里添加如下选项 文件路径:src/views/system/DepartListSync.vue ![](https://img.kancloud.cn/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png) ![](https://img.kancloud.cn/f4/4a/f44a232e747dfb403ecf03b3815b9645_1170x196.png) 2. 再次回到页面,发现按钮变成了下拉形式,点击`同步到本地`即可 ![](https://img.kancloud.cn/48/20/482041a53575642fbcde5db81e2faf32_695x491.png) 3. 规则:本地没有的就创建,有的就更新。本地有,钉钉没有的,不做任何操作。 ![](https://img.kancloud.cn/52/c2/52c27174cbfe5305e3b7e1869d859670_516x344.png) ## 发送消息 ### 发送消息测试与撤回 1. 页面路径:常见案例-->第三方APP消息测试 ![](https://img.kancloud.cn/4f/d8/4fd83f376d152c4404d21e56fb4250b7_887x345.png) 2. 撤回 ![](https://img.kancloud.cn/c0/c0/c0c0f6008f19a15667048b0f547bdc9b_1377x179.png) ### 发送系统公告与撤回 1. 页面路径:系统管理-->系统通告 2. 直接发布消息即可 ![](https://img.kancloud.cn/28/b9/28b96351c5a6b8e303beb607409e3b76_755x632.png) ![](https://img.kancloud.cn/ad/96/ad960c272d69f8203aac5f872316e6d9_133x203.png) 3. 效果预览: ![](https://img.kancloud.cn/8a/17/8a17973c0490bd674a580aff5479ef2d_860x542.png) 4. 撤回 ![](https://img.kancloud.cn/13/7b/137b55a01deaaacebed3fe0f0ba7413d_172x167.png) ## 附录网址 钉钉开发者中心:https://open-dev.dingtalk.com 钉钉后台: https://oa.dingtalk.com