应用系统与钉钉集成案例及操作步骤

1、准备钉钉应用

1.1、注册钉钉账号

作为钉钉的企业管理员，首先登录钉钉官网，注册一个钉钉账号。

如果已经有账号，则直接使用即可。

钉钉官网：https://www.dingtalk.com/

1.2、开通企业团队

企业管理员使用账号登录钉钉。

如果没有创建过企业团队，则出现下图，点击“创建企业/组织/团队”。

如果已经创建过，则出现企业团队选择页面，选择一个要管理的团队，进入管理后台。

点击“创建企业/组织/团队”后，会弹出钉钉账号注册页，输入手机号，验证通过后，弹出如下图。

输入企业团队名称后，点击注册。

注册完成后就开通了自己的企业团队。

然后重新登录钉钉，出现企业团队选择页面，选择一个要管理的团队，进入管理后台。

进入钉钉管理后台，会提示是否“升级管理后台”或者“使用新版管理后台“，我们选择使用新版管理后台，后续截图都是基于新版管理后台进行的。

在管理后台可以进行企业认证、签署承诺等，这部分内容不影响后续的集成，我们先选择稍后再签，但是企业实际运营是需要企业管理员自行完成认证和签署等工作的。

1.3、创建钉钉应用（H5）

在钉钉管理后台，找到应用管理菜单，点击下方的“自建应用”按钮。

点击后，进入“钉钉开放平台”，如果您的账号管理了多个企业团队，需要先选择对应的企业团队。

然后点击创建应用按钮，如果您的页面没有下图的创建应用按钮，也可以点击菜单“应用开放->企业内部开发”，都可以进入企业内部开发页面。

点击“创建应用”按钮。

应用类型选择“H5微应用”，填写应用名称等，开发方式选择“企业自主开发”，点击确定，完成应用创建。

1.4、设置钉钉应用权限

钉钉扫码登录功能需要设置回调地址，点击菜单“登录与分享”，添加回调地址，回调地址就是正式系统的访问地址，图中是本地开发的示例。

开通账号的接口权限。

点击“权限管理”，全选“通讯录管理”的权限，注意有分页的话，需要把第二页也全选，然后勾选“个人权限”下的“个人手机号信息”和“通讯录个人信息读权限”两项，总共19项，执行批量申请。如果操作账号是企业管理员，则申请自动通过，如果操作账号不是企业管理员，还需要企业管理员完成批准操作。具体操作参考如下三张截图。

2、配置系统参数

2.1、找到应用凭证

在“应用管理”下，找到应用凭证的三个信息：AgentId、AppKey、AppSecret。

2.2、配置后端参数

在后端工程的yml文件中，把应用凭证对应配置到“yuncheng.dingtalk”下，参数名称与应用凭证的名称对应。

2.3、配置前端参数

在前端工程的“public/config/bootConfig.js”文件内，配置参数“VUE_APP_DINGTALK_APP_KEY”的值，对应钉钉应用凭证的“AppKey”。

在前端工程的“src/settings.js”文件内，配置开关参数“showDingtalk”的值为“true”，开启前端的钉钉扫码按钮、同步部门用户按钮的显示。

配置完成后，启动系统。

3、同步部门用户

3.1、同步部门

在组织管理模块，点击“钉钉同步->本地同步到钉钉”。

同步完成后，会有弹框提示同步情况，钉钉管理后台同步后的截图如下。

3.2、同步用户

在用户管理模块，点击“钉钉同步->本地同步到钉钉”。

注意：用户手机号是用户同步的关联标识，所以本地账号必须设置正确的手机号，才能进行同步。

同步完成后，会有弹框提示同步情况，钉钉管理后台同步后的截图如下。

注意：同步到钉钉的账号，如果该账号没有加入过当前企业团队，系统会自动向该账号发送加入邀请，该账号需要同意邀请后，才能加入当前企业团队。

3.3、同步注意事项

部门和用户的同步规则：以本地数据为准。

本地往钉钉同步，如果钉钉不存在，则新建；如果存在，则更新；如果钉钉有多余的账号，则删除。

钉钉往本地同步，如果本地不存在，则新建，如果存在，则更新，如果本地有多余的账号，则保持不变。本地新创建的用户的默认密码是“123456”，需要自行设置用户的角色、岗位等信息。

本地和钉钉是否同一用户的账号，是通过手机号进行判断的。

4、钉钉扫码登录

点击登录页面下方的钉钉图标，会显示钉钉二维码，使用手机钉钉扫码功能，完成扫码登录。

注意：必须完成上一步的用户同步，并且钉钉用户必须接受邀请加入企业团队后，才能进行扫码登录。

如果扫码登录后，提示用户不存在，需要检查钉钉账号所关联的手机号：

原因1、在平台的用户管理中可能没有该手机号对应的用户；

原因2、企业管理员可能没有同步钉钉用户或者该钉钉账号没有加入对应的钉钉企业团队；

原因3、企业管理员可能没有给钉钉应用开通通讯录和个人权限。