钉钉集成说明和步骤

概述

在明道云平台中搭建的应用，可以直接安装在钉钉的工作台，您可以在钉钉中就能体验明道云的服务。区别于一般的SaaS与钉钉集成方案，我们采用了钉钉自建内部应用的方式进行集成。效果如下图：

电脑端效果：

通过系统默认浏览器或钉钉内，打开明道云。

明道云：将整个平台集成到钉钉工作台

OKR：将单个应用集成到钉钉工作台
手机端效果：

免费版不支持集成钉钉

集成操作步骤

步骤简述

在钉钉管理后台安装一个微应用，建立钉钉和明道云的信息对接。
同步钉钉通讯录，完成明道云平台集成到钉钉。
优化配置：将待办消息（审批、填写）同步到钉钉
将明道云的单个应用安装在钉钉工作台。

请严格按照以下步骤进行操作，任何一步出错都会导致集成失败。

一、建立钉钉和明道云的连接

1、打开明道云对接指南页面

管理员进入明道云的管理后台，打开获取对接信息操作指南，此页面不要关闭，后面的步骤需要页面中的以下信息：

LOGO （第3步）
应用首页地址（第4步）
PC端首页地址（第4步）

[!TIP]企业微信、钉钉、飞书只能选择一个平台对接，如果已经对接了一个，另外两个就不再显示了。如何关闭对接

2、在钉钉中创建对接应用

钉钉管理员需要登录钉钉网页版的开放平台后台，创建内部应用。

应用图标LOGO可从第1步打开的页面中下载。

3、填写钉钉应用的首页地址

打开[开发管理]栏，点击右上角编辑按钮，填写将对应的首页地址填入。

应用首页地址和PC端首页地址请在第1步打开的对接指南页面的完成接口信息中复制

4、确定同步的员工范围

特别重要！

贵司使用钉钉的人员是100人，但是使用明道云的人数可能是50人，因此并非同步所有的账号。我们可以根据部门和指定人员来确认好同步的人员范围，设定范围如下图：如果所有人员使用，直接选择“全部员工”即可。如果不是全员使用明道云，则选择指定员工或部门即可。

5、获取通讯录权限接口

特别重要！

需要获取钉钉组织内的通讯录读取权限，必须添加的权限有以下6个，逐个复制名称搜索后，点击右侧的申请权限会自动获得。

通讯录部门信息读权限
成员信息读权限
通讯录部门成员读权限
企业员工手机号信息
个人手机号信息
邮箱等个人信息

如果您的钉钉后台界面是旧版本，操作界面和权限名称都不同，请切换到新版本操作。

6、确定钉钉工作台可见明道云应用的人员范围

第4步设定的范围是同步账号的人员范围，如果需要同步的人在钉钉工作台可见明道云应用，还需要设置以下范围,这部分人在钉钉工作台可以看见明道云应用的入口。

在测试阶段，可先选择部分人员可见。这样就只有几个人在钉钉工作台可看到明道云应用。

人员选择完毕后，点击确认发布。

待后面的步骤也测试完毕后，确认正式使用了，再回来修改应用的可见范围，这里选择的人，在钉钉工作台都会看到明道云应用。

二、在明道云同步数据

1、录入同步钉钉中的信息

组织管理员返回明道云后台的钉钉对接界面，将CorpId、 4个对接信息录入。

如何获取4个对接信息，如附图

AgentId、AppKey、AppSecret的获取路径
CorpId的获取路径

2、同步通讯录

点击【同步】按钮，可以将钉钉的通讯录同步到明道云。

同步的信息有：姓名，公司，联系电话，部门，职位，头像。

每次同步钉钉的信息都会覆盖写入明道云，但明道云头像只在第一次同步时会覆盖。

同步前必看

将钉钉通讯录同步到明道云，是依据手机号和邮箱（优先手机号）进行匹配关联的。如果明道云的组织中有相同手机号的账户，则直接建立和钉钉账号的关联，如果没有则自动创建新的明道云账户。也就是说，能和现有明道云账户关联有两个条件：

两个平台间绑定的手机号相同
明道云账号要在组织内

示例：在钉钉中，员工绑定的手机号是199-9999-9999，在同步到明道云的组织时，这个组织内有个账户也绑定了手机号199-9999-9999，如果有则直接关联，如果没有，则自动创建一个新的账户并关联。如果明道云系统中现在有个199-9999-9999的账户，但不在您的组织内，依然不会同步并关联的，而是自动创建一个新的明道云账户。