钉钉集成部署

创建钉钉应用（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. 对应关系如下图所示
   
   

创建默认角色

创建角色编码为”third_role”的角色，授予一定的权限

同步用户

用户同步到钉钉

1. 在用户管理页面，点击同步钉钉按钮即可
   
   

2. 规则：本地同步到钉钉，钉钉上有就更新，没有就创建。本地没有但是钉钉有的，不做任何操作。

从钉钉同步用户到本地

1. 点击同步到本地即可
   
2. 规则：本地有的就更新，没有的就新增（默认密码123456）。本地有，钉钉没有的，不做任何操作。
   

   部门同步

   部门同步到钉钉

3. 在部门管理页面，点击同步钉钉按钮即可
   
4. 规则：本地同步到钉钉，钉钉上有就更新，没有就创建。本地没有但是钉钉有的，删除钉钉上的。

   从钉钉同步部门到本地

5. 点击同步到本地即可
   
6. 规则：本地没有的就创建，有的就更新。本地有，钉钉没有的，不做任何操作。

附录网址
钉钉开发者中心：https://open-dev.dingtalk.com
钉钉后台： https://oa.dingtalk.com