# 钉钉集成流程 [TOC] ## 前提准备 ### 注册钉钉账号 注册地址：<https://oa.dingtalk.com/register_new.htm> 输入手机号，获取验证码即可。  第二步填写你的公司信息，邀请码没有不填就行。 ### 创建钉钉应用（H5微应用） 1. 首先登录钉钉后台 2. 点击上方导航栏的`工作台` 3. 向下滑动找到`自建应用`，并点击加号创建  4. 鼠标移动到上方导航栏的`应用开发`上，选择`企业内部开发`  5. 点击右上角的`创建应用`按钮 6. 应用类型一定要选`H5微应用`，开发方式一定选`企业自助开发`  7. 根据实际情况填写名称和描述，之后点确定创建即可 ### 开发者IP白名单配置 1. 在新创建的应用详情里，找到左侧导航栏的`开发管理` 2. 点击右上角的`修改`按钮 3. 填写服务器出口IP，如果是测试环境，可以去百度上搜索自己的外网IP（见下图），如果是线上环境，直接填写线上的公网IP即可。   ### 接口权限的获取 1. 打开`权限管理` 2. 点击`通讯录管理` 3. 点击全选按钮 4. 点击`批量申请`按钮 5. 注意：如果有多页，只有当前页的权限会被申请到，下一页的权限需要手动切换到下一页再申请。  >还需要在个人权限上申请`个人手机号信息`及`通信录个人信息读权限`  ## 对接配置 1. `AgentId`对应配置里的`agent-id` 2. `AppKey`对应配置里的`client-id` 3. `AppSecret`对应配置里的`client-secret` 4. 配置完成之后需要重启后端项目，重启完需要刷新前端页面 5. 对应关系如下图所示   ## 同步用户 ### 用户同步到钉钉 1. 在用户管理页面，点击同步钉钉按钮即可   2. 规则：本地同步到钉钉，钉钉上有就更新，没有就创建。本地没有但是钉钉有的，不做任何操作。 ### 从钉钉同步用户到本地 1. 需要在源码里添加如下选项 文件路径：src/views/system/UserList.vue   2. 再次回到页面，发现按钮变成了下拉形式，点击`同步到本地`即可  3. 规则：本地有的就更新，没有的就新增（默认密码123456）。本地有，钉钉没有的，不做任何操作。  ## 部门同步 ### 部门同步到钉钉 1. 在部门管理页面，点击同步钉钉按钮即可  2. 规则：本地同步到钉钉，钉钉上有就更新，没有就创建。本地没有但是钉钉有的，**删除**钉钉上的。 ### 从钉钉同步部门到本地 1. 需要在源码里添加如下选项 文件路径：src/views/system/DepartListSync.vue   2. 再次回到页面，发现按钮变成了下拉形式，点击`同步到本地`即可  3. 规则：本地没有的就创建，有的就更新。本地有，钉钉没有的，不做任何操作。  ## 发送消息 ### 发送消息测试与撤回 1. 页面路径：常见案例-->第三方APP消息测试  2. 撤回  ### 发送系统公告与撤回 1. 页面路径：系统管理-->系统通告 2. 直接发布消息即可   3. 效果预览：  4. 撤回  ## 附录网址 钉钉开发者中心：https://open-dev.dingtalk.com 钉钉后台： https://oa.dingtalk.com