应用介绍
如何添加钉钉应用账号
中国领先的智能移动办公平台,由阿里巴巴集团开发,用于商务沟通和工作协同。
通过LinkMecha将钉钉与您的其他应用集成起来，您可以使用以下功能来完成业务需求:
功能模块 | 功能明细 | 应用场景举例 |
用户签到事件 | 获签到数据 | 钉钉签到数据同步到企业考勤系统 |
考勤事件 | 获取打卡数据 | 钉钉考勤数据同步到企业OA系统 |
获取加班数据 | ||
获取排班变更数据 | ||
通讯录事件 | 通讯录用户新增 | 钉钉新增用户信息同步到HR应用 |
通讯录用户更改 | ||
通讯录用户离职 | ||
通讯录企业部门创建 | ||
通讯录企业部门删除 | ||
审批事件 | 审批任务开始、结束、转交 | 钉钉审批结果通过短信发送给员工 |
会议室事件 | 会议室预定、取消 | 会议室创建数据同步到OA系统 |
会议室创建 | ||
用户管理 | 创建用户 | 主数据系统的员工数据同步到到钉钉 |
查看用户详情 | ||
根据手机号查询用户 | ||
获取员工人数 | ||
获取部门用户userid列表 |
- 先登录钉钉开发平台：点击登录钉钉开放平台，选择【应用开发】-【企业内部开发】，进入钉钉应用界面。如果您已经有需要使用的订单应用，可以直接使用该应用的AppKey与AppSecret。如果没有应用，请按照如下步骤进行应用创建。
- 点击【创建应用】-【H5微应用】，填写应用名称、描述，上传应用图标，开发方式选择企业自主开发。
- 创建完成后，点击【开发管理】的【修改】，进行开发信息维护。
服务器出口IP：请参考LinkMecha出口IP获取LinkMecha最新的出口IP，然后将IP复制到此处处。
应用首页地址：填写https://www.linkmecha.com
配置完毕后点击保存。
- 设置应用权限：
为了正常使用钉钉的功能，您需要设置应用的接口权限。点击【权限管理】，根据您的需求申请对应的接口权限。常用的权限有：
- 个人手机号信息
- 通讯录个人信息读权限
- 企业员工手机号信息
- 通讯录管理
- 考勤组查询权限
- 调用企业API基础权限
- 企业考勤数据上传权限
- 查询企业考勤数据权限
选择完权限后点击【批量申请】。
- 应用认证与回调信息配置：
为了在LinkMecha上集成您的钉钉应用，您需要在LinkMecha上认证您的钉钉账户。当您的业务流程中需要接口钉钉的触发事件时，您需要在钉钉应用中维护事件回调信息，以便当事件触发时，钉钉可以根据您配置的回调地址将事件消息推送到该地址。操作步骤如下：
进入LinkMecha的【应用管理】-【SaaS应用】，单击【添加应用账户】，选择钉钉应用，可以看到需要填写认证信息与回调信息。
认证信息中的appkey与appsecret在钉钉开放平台的的【钉钉应用】中，点击您创建的应用，可以看到应用的appkey与appsecret
，将两个参数的值分别复制到LinkMecha的【添加应用账户】对应的输入框然后保存即可完成认证。
接下来填写事件回调信息。
在钉钉开发平台中，点击您的自建应用，进入应用详情界面，进入【事件与回调】设置界面，可以看到此处需要维护加密 aes_key、签名 token、请求网址三个参数。这三个参数需要从LinkMecha获取，获取方式为：
进入LinkMecha的【应用管理】-【SaaS应用】，点击您的钉钉应用，进入认证信息界面。
进入钉钉开发平台-【应用开发】-【企业内部开发】，选择您的应用，进入【事件与回调】配置界面，点击【加密 aes_key】与【签名 token】后的重置按钮，并点击取消隐藏。
- 将钉钉【事件与回调】界面的【签名 token】的值复制到LinkMecha【回调信息设置】内的【AES_TOKEN】内。
- 将钉钉【事件与回调】界面的【加密 aes_key】的值复制到LinkMecha【回调信息设置】内的【AES_KEY】内。
- 将LinkMecha【回调信息设置】内的【回调地址】复制到钉钉【事件与回调】界面的请求网址内。
- 【回调信息设置】内的【OWNER_KEY】的值来自于钉钉应用的【appkey】，将钉钉应用的的appkey复制到此处即可。
填写完毕后点击【保存】。
