[TOC] ## 1 前提准备 ### 1.1 注册钉钉账号 注册地址：<https://oa.dingtalk.com/register_new.htm> 输入手机号，获取验证码即可。  第二步填写你的公司信息，邀请码没有不填就行。 ### 1.2 创建钉钉应用（H5微应用） 1. 首先登录钉钉后台 https://open-dev.dingtalk.com/ 2. 鼠标移动到上方导航栏的`应用开发`,点击`企业内部开发`  3. 点击`创建应用`按钮  4. 应用类型一定要选`H5微应用`，开发方式一定选`企业自助开发`  5. 根据实际情况填写名称和描述，之后点确定创建即可 ### 1.3 开发者IP白名单配置及首页地址配置(用于免登录) 1. 在新创建的应用详情里，找到左侧导航栏的`开发管理`，并单击右侧的`修改按钮`  2. 填写服务器出口IP及首页地址 - 出口ip ``` 192.144.199.247 ``` - 应用首页地址及PC端首页地址，`租户id`可以在组织信息中找到，如本示例`2088` - 租户id  - 应用首页地址及PC端首页地址 ``` https://app.qiaoqiaoyun.com/tenantId/租户id ```  ### 1.4 接口权限的获取 1. 在应用中找到`权限管理`  2. 点击`通讯录管理` 3. 点击全选按钮 4. 点击`批量申请`按钮 5. 注意：如果有多页，只有当前页的权限会被申请到，下一页的权限需要手动切换到下一页再申请。  >还需要在个人权限上申请`个人手机号信息`及`通信录个人信息读权限`  ## 2 敲敲云配置 ### 2.1 钉钉用户部门同步到敲敲云 - 找到钉钉配置`AgentId`、`AppKey`、`AppSecret`  - 进入敲敲云首页 https://app.qiaoqiaoyun.com/myapps/index - 点击租户管理  - 点击第三方配置，在右侧第二项点击`对接信息录入`,在点击`编辑`按钮  - 将`AgentId`、`AppKey`、`AppSecret`分别录入  - 点击同步即可完成钉钉同步  >[danger] 钉钉同步到敲敲云规则： - 部门及用户均可同步 - 当用户敲敲云没有注册的时候，系统自动创建成员，默认账号即`手机号`，默认密码即`手机号+租户门牌号`，`租户门牌号`管理员可以在`组织信息`中找到 - 当成员存在系统中，但当前租户中没有该成员，则默认`审核中`，由管理员审核通过后方可加入租户 - 当成员存在系统中，存在当前租户中，直接做更新操作 >[danger] 注意：当部门同步出现多条数据时（即重复数据），请查看一个企业下是否存在多个应用id对应不同的租户  ### 2.2 钉钉应用免登录 - 配置免登录回调地址 ··· https://api.qiaoqiaoyun.com ···  - 在PC端钉钉找到工作台，找到对应创建的应用，直接点击即可  - 进入页面