集成钉钉
稳赢云支持与钉钉的深度集成。通过集成钉钉,可以实现如下场景的互联互通,
- 企业组织架构、员工信息自动实时从稳赢云同步到钉钉,实现企业人事信息的高效管理;
- 将稳赢云员工自助终端集成到钉钉工作台,实现员工一站式的体验;
- 稳赢人事云可以直接拉取钉钉上下班打卡数据,实现钉钉到稳赢的一体化考勤管理。
启用钉钉H5微应用集成,需要完成如下4个阶段的工作;
1. 创建并配置钉钉H5微应用
1.1 创建钉钉H5微应用
- 通过电脑浏览器,进入钉钉开放平台(https://open-dev.dingtalk.com);
- 以企业钉钉管理员身份登陆开放平台;
- 点击
应用开发
分栏,进入后,点击企业内部开发-H5微应用
,样例如下: - 点击
创建应用
按钮,进入填写基本信息
表单,样例如下: - 点击下一步,进入
配置开发信息
表单,如图示,其中
- 开发应用类型:选择
微应用
; - 应用首页链接:链接格式如
https://{域名唯一标识符}_dingtalk.hrsaas.com/middle/?tenantId={租户ID}
域名标识符
可设置为企业英文名简称,如alibaba、tecent等;租户ID
需联系稳赢云客户成功团队获取;
- 服务器出口IP:需联系稳赢云客户成功团队获取;
- 开发应用类型:选择
- 点击
创建
即可完成创建H5微应用。
1.2 配置H5微应用的权限
- 点击进入新创建的H5微应用
- 点击「接口权限」分栏,开通接口权限
- 在
高级权限-企业通讯录
部分,开通:通讯录只读权限、通讯录编辑权限、手机号码信息 、手机号获取userid、邮箱等个人信息;且设置权限范围为:全部员工
,示例如下: - 在
高级权限-微应用
部分,开通:考勤和待办任务权限,
- 在
1.3 获取H5微应用AgentId、appkey和appSecret
- 进入应用首页,在
应用信息
一栏,点击查看详情
- 获取相关配置
1.4 获取CorpId
进入钉钉开放平台首页,拷贝企业CorpId,供后续配置使用,示例如下:
2. 配置钉钉集成
在稳赢人事云系统,点击左侧导航系统集成 > 钉钉集成
,进入钉钉集成页面,如图所示,
点击右上角配置
按钮,即可进入钉钉的集成配置页面,
该配置表单包含如下信息:
- 钉钉appKey: 步骤1.3中获取的appkey;
- 钉钉appSecret:步骤1.3中获取的appSecret;
- 钉钉AgentId:步骤1.3中获取的AgentId;
- 同步频率(分钟):即数据在稳赢云和钉钉之间的最大间隔时间,根据公司的实际需要设置,建议频率在30-120分钟;
- 代理主机:钉钉H5微应用的代理服务器IP,联系稳赢云客服获取;
- 代理端口:钉钉H5微应用的代理服务器端口,联系稳赢云客服获取;
- 钉钉企业CorpId:步骤1.4中获取的CorpId;
- 应用二级域名:步骤1.1中配置的
域名唯一标识符_dingtalk
(如:wyy_dingtalk) - 考勤同步时间设置:设置从钉钉同步考勤打卡数据的时间起点;
- 是否启用钉钉消息通知:启用钉钉H5微应用时使用,该开关用于
- 钉钉组织架构完全匹配模式:同步稳赢云组织架构到钉钉组织架构的匹配检查模式;如果开启,则意味着同步时,必须确保稳赢的组织架构和钉钉的组织架构完全一致;如果关闭,则只需保证钉钉组织架构包含稳赢组织架构即可;
- 选择不同步的员工: 设置不同步员工黑名单,名单中员工不会从稳赢同步到的钉钉;
- 表达式匹配不同步员工: 通过表单是设置不同步员工黑名单,和联系客户成功经理进行设置;
点击保存
即可完成集成配置;
3. 初始化并开启同步
配置好钉钉的集成信息后,即可进行数据初始化;初始化成功后,即可开启同步
;
同时系统会展示增量同步过程中出现的错误,管理员可根据错误提示,进行处理修复即可。
4. 常见问题FAQ
4.1 员工已经加到稳赢云了,但是钉钉中看不到该员工?
通常情况下,稳赢云对于员工的入职和离职,都会自动同步到钉钉,但是如下情况会导致同步失败
- 员工钉钉账号开启了
账号保护
;如图所示,
对于这种情况,只需通知员工关闭该设置即可,钉钉操作路径为我的 > 设置 > 安全中心 > 账号设置 > 更多
- 员工钉钉账号开启了
团队添加我时需要我的确认
,如图所示,
对于这种情况,只需通知员工关闭该设置即可,钉钉操作路径为我的 > 设置 > 安全中心 > 隐私开关
- 企业人数超出了当前认证级别的人员限制;针对不同的企业认证级别,钉钉的人数限制不同(如果人数超出10000人,可联系钉钉客服,提升企业的人数额度),
- 初级认证:500人
- 中级认证:1000人
- 高级认证:10000人
4.2 员工的钉钉打卡记录没有同步到钉钉?
通常情况下,引起这个问题的原因是稳赢的员工信息在钉钉那边没有匹配;需要做如下排查: 1、员工是否准确的同步到钉钉的公司群? 2、稳赢中员工的手机号码,跟员工的钉钉里面的账号(手机号)是否匹配?