前提事项

进入 钉钉开发者后台 - 应用开发

下文将提示需要收集和填入的信息

☁️：该标识指需要收集给稳赢系统
💡：该标识指需要填入钉钉后台

收集钉钉组织 CorpId

在页面右上角点击头像，点击复制 CorpId。

☁️ 请发送至稳赢客户成功经理邮箱。

应用配置步骤

在 “钉钉开发者后台 - 应用开发” 页面中开始创建企业内部应用，并进入应用详情。在 “添加应用能力” 中添加 “网页应用”能力，并进行以下配置：

应用能力 - 网页应用：

在左侧菜单栏中的 “应用能力 - 网页应用” 中配置：

• 应用首页地址：💡 填入稳赢提供的页面地址
• PC端首页地址：💡 填入稳赢提供的页面地址

应用和PC端首页地址格式为 https://{租户二级域名}.hrsaas.com/middle/?tenantId={租户ID}&redirectUrl=https://mob.hrsaas.com
租户ID请用该租户在稳赢云的租户ID进行替换， 租户二级域名必须以 _dingtalk结尾， 如 ABCD _dingtalk

点击保存。

基础信息 - 凭证与基础信息

在左侧菜单栏中的 “基础信息 - 凭证与基础信息” 中：

• ☁️ 获取原企业内部应用AgentId
• ☁️ 获取 Client ID（AppKey）
• ☁️ 获取 Client Secret（AppSecret）

请发送至稳赢客户成功经理邮箱。

开发配置 - 权限管理

在左侧菜单栏中的 “开发配置 - 权限管理” 中配置：

• “权限范围” 选择 “全部员工”
• “个人权限” 全部开通
• “通讯录权限” 全部开通
• “OA审批权限” 全部开通
• “考勤权限” 全部开通
• “硬件权限” 全部开通
• “智能人事权限” 全部开通
• “日志权限” 全部开通
• “身份验证权限” 全部开通
• “获取凭证权限” 全部开通
• “待办任务权限” 全部开通

开发配置 - 安全设置

在左侧菜单栏中的 “开发配置 - 安全设置” 中配置：

• 服务器出口IP：💡 填入稳赢提供的 IP 列表
• 重定向URL：💡 填入稳赢提供的重定向 URL 地址

应用发布 - 版本管理与发布

在左侧菜单栏中的 “应用发布 - 版本管理与发布” 中配置：

当所有钉钉开发者配置、稳赢系统配置均准备完毕后，可以开始发布应用，发布应用时可以选择应用在钉钉工作台的可见范围：

• 全部员工（正式开始上线钉钉集成）
• 部分员工、管理员、仅我可见（可供灰度测试验证阶段使用）

钉钉免费版集成权益须知

钉钉官方于 2023 年 10 月发布 关于企业内部应用API调用量和频次限制的调整说明，对标准版（免费版）的钉钉组织施行每月 API 调用量限制政策。

客户需要知悉稳赢系统与钉钉集成也会受到 “钉钉每月免费API调用量” 的限制。

稳赢云已接入的钉钉接口列表

钉钉官方定义了部分不纳入调用量统计的 API 接口，以下是稳赢系统中会产生的 API 接口调用量统计情况。

✅：豁免接口（不纳入调用量统计）
❌：统计接口（纳入调用量统计）

稳赢云调用纳入调用量统计相关接口的场景

调用发送钉钉通知接口

场景

• 当相关流程审批人收到新的审批任务后，会发送钉钉通知提醒处理。
• 当成员申请的审批任务结束后，会发送钉钉通知提醒申请人。
• 当审批任务未处理并超时后，会发送钉钉通知提醒相关成员处理。
• 当某些成员的考勤异常时，会发送钉钉通知提醒成员。
• 实施配置的自定义的消息通知被触发时，会发送钉钉通知提醒相关成员。

调用钉钉待办相关接口

场景一：流程步骤开始事件

当稳赢云系统中的审批流程开始流转时，稳赢云系统会调用【创建钉钉代办】接口来为每一位流转到的审批人创建钉钉代办。

场景二：流程步骤结束事件

当稳赢云系统中的审批流程被处理结束时，如果相关的审批人之前有创建过对应的钉钉代办，稳赢云系统会调用【更新钉钉代办】接口来将相关审批人的钉钉代办更新为已完成。

待办接口计次原则：

每调用一次待办接口，算一次；

举例：

某请假流程共有 4 个审批步骤，过程中没有任何抄送且每个步骤只有一个审批人，则办结流程大约需要调用 4 * 2 = 8 次；

调用钉钉考勤打卡相关接口

场景一：自动拉取

根据在稳赢云系统中配置的同步频率（默认 2 小时）来自动地、周期地拉取钉钉成员考勤打卡数据。

场景二：手动拉取

在稳赢云系统中手动同步指定员工的钉钉考勤打卡数据。

稳赢云拉取钉钉考勤打卡数据的接口调用计次原则：

遍历所有已与钉钉建立映射关系的稳赢云系统员工记录，每次同时拉取 48 个人的钉钉打卡记录。

例如：以 1000 名员工为例，同步一次钉钉考勤打卡数据时，共需调用 1000 ÷ 48 向上取整，约为 21 次；假设每隔 2 小时同步一次，则一个自然月的调用次数估算约为：21 X 12 X 30 = 7560 次。

钉钉成员变更手机号操作流程

当员工希望变更自己在稳赢系统中的手机号，同时稳赢系统又已和钉钉系统做了集成。那么请按照一下步骤进行操作，以减少双方进行系统账号切换的时间成本。

1. 员工登录自己现用的钉钉账号
2. 在钉钉 app 的个人信息设置中进行【手机号换绑】
3. 钉钉手机号换绑完毕后，告知 HR ：员工自己已在钉钉处换绑原账号的手机号，仍需要 HR 来帮忙在稳赢系统中修改员工登记的手机号。
4. HR 修改稳赢系统花名册中的员工手机号

至此整个手机号变更过程结束，员工的稳赢系统、钉钉系统中均为新手机号，并且可正常使用稳赢系统的员工端功能。