钉钉集成说明和步骤
概述
在明道云平台中搭建的应用，可以直接安装在钉钉的工作台，您可以在钉钉中就能体验明道云的服务。区别于一般的SaaS与钉钉集成方案，我们采用了钉钉自建内部应用的方式进行集成。效果如下图：
电脑端效果：
通过系统默认浏览器或钉钉内，打开明道云。
手机端效果：
免费版不支持集成钉钉
集成操作步骤
步骤简述
在钉钉管理后台安装一个微应用，建立钉钉和明道云的信息对接。
同步钉钉通讯录，完成明道云平台集成到钉钉。
优化配置：将钉钉待办消息同步到钉钉
将明道云的单个应用安装在钉钉工作台。
一、建立钉钉和明道云的对接
管理员进入明道云的管理后台，依照【获取对接信息】操作指南，在钉钉中创建一个微应用，建立明道云和钉钉的对接。
请依照当前文档步骤操作， 在需要一些对接信息时，再前往操作指南页面获取。
[!TIP]企业微信、钉钉、飞书只能选择一个平台对接，如果已经对接了一个，另外两个就不再显示了。
指南中关键步骤再介绍
1.在钉钉中创建对接应用。
钉钉管理员需要登录钉钉网页版的管理后台，在【工作台】模块创建应用。
2.填写接口信息
将对接信息页面中的2个地址复制，逐个粘贴到钉钉对应的栏目下。（如果点击复制没有效果，您可以鼠标选择进行复制。 ）
3.确定同步的员工范围
贵司使用钉钉的人员是100人，但是使用明道云的人数可能是50人，因此并非同步所有的账号。我们可以根据部门和指定人员来确认好同步的人员范围， 设定范围如下图：
如果所有人员使用，直接选择“全部员工”即可。如果不是全员使用明道云，则选择指定员工或部门即可。
4.获取通讯录权限接口
需要获取钉钉组织内的通讯录读取权限，必须添加的权限有以下7个，逐个复制名称搜索后，点击右侧的申请权限会自动获得。
通讯录部门信息读权限
成员信息读权限
通讯录部门成员读权限
企业外部联系人读取权限
企业员工手机号信息
个人手机号信息
邮箱等个人信息
如果您的钉钉后台界面是旧版本，操作界面和权限名称都不同，请切换到新版本操作。
5.确定钉钉工作台可见明道云的人员范围
第5步设定的范围是同步账号的人员范围，如果需要同步的人在钉钉工作台可见明道云应用，还需要设置以下范围,这部分人在钉钉工作台可以看见明道云应用的入口。
在测试阶段，可先选择部分人员可见。这样就只有几个人在钉钉工作台可看到明道云应用。
人员选择完毕后，点击确认发布。
待测试完毕后，确认正式使用时，修改应用的可见范围。
这里选择的人，在钉钉工作台都会看到明道云应用。
二、同步钉钉通讯录到明道云
1、录入同步对接信息
返回明道云后台的钉钉对接界面，将CorpId、AgentId、AppKey、AppSecret 4个对接信息录入。
如何获取4个对接信息，如附图
2、同步通讯录
点击 【同步】按钮，将钉钉的通讯录同步到明道云。
同步的信息有：姓名，公司，联系电话，部门，职位，头像。
每次同步钉钉的信息都会覆盖写入明道云，但明道云头像只在第一次同步时会覆盖。
3、钉钉中打开明道云
前面步骤操作后，就完成了明道云整个平台安装到钉钉的操作了。在钉钉工作台就能看到明道云入口。点击即可打开。
钉钉中看不到明道云？
新的应用属于未分组应用，管理员可将其添加到全员分组中。
三、个性化配置
1、待办消息同步
工作流中的待办（待审批、待填写、待查看）可以同步到钉钉的待办任务。在钉钉或明道云任意一方处理后，处理状态都会同步更新。
配置入口
权限申请
搜索“钉钉待办”，找到“钉钉待办事项相关接口权限"，然后申请权限即可。
2、钉钉PC端打开明道云的方式
在钉钉PC端打开明道云时，可以选择是在钉钉内打开，还是跳转到系统浏览器打开。
四、将单个应用安装在钉钉工作台
应用管理员进入应用，打开此应用的安装指南页面，一步步按照安装指南完成安装。
每个应用的配置信息是不同的,需要安装的应用都需要这样操作一遍。
应用安装在钉钉后，用户即可在工作台中看到此应用，点击即可使用。
打开后如果提示无权限或应用不存在，请联系管理员调整您的权限配置。
注意事项
点此请查看钉钉集成常见问题