1、在钉钉开发平台创建应用
开发平台链接:https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app
2、添加机器人能力&H5网页应用
钉钉开发平台--添加应用能力
机器人能力配置:
网页应用能力配置:
首页填写信息:
https://实际IP、域名/manager/ssoLogin?corpId=$CORPID$
注:如果是域名,服务器需要有域名的https证书
3、获取钉钉应用的信息
(1)APP ID、ClientID、ClientSecret、AgentId获取位置
(2)UserID获取位置: 登录钉钉管理后台-通讯录-成员管理获取Userid
(3)CorpId获取位置: 在钉钉开发者管理后台-首页查看
(4)RobootID获取位置:
4、Smart侧配置应用集成
在Smart平台-系统集成-系统配置处,填写钉钉应用相关配置信息
在Smart平台-系统集成-业务集成,将通讯录和协同平台都选中钉钉,深度集成选择“第三方自建应用”选中即可,先不点击手动同步
在Smart-系统管理平台(admin)下配置Web服务器地址
5、回到钉钉侧配置权限管理
深度集成对接时,通讯录需要开放全部权限
以下列出当前版本所需要配置的所有接口权限
通讯录● 企业员工手机号信息● 邮箱等个人信息● 通讯录部门信息读权限● 成员信息读权限● 通讯录部门成员读权限● 查询行业通讯录信息权限日历● 日历应用中日程写权限● 日历应用中日程读权限会议室● 视频会议信息读权限 ● 视频会议信息管理权限 机器人● 企业内机器人发送消息权限 凭证● 获取钉钉开放接口用户访问凭证的基础权限
模块
接口权限
通讯录
企业员工手机号信息
fieldMobile
邮箱等个人信息
fieldEmail
通讯录部门信息读权限
qyapi_get_department_list
成员信息读权限
qyapi_get_member
通讯录部门成员读权限
qyapi_get_department_member
查询行业通讯录信息权限
qyapi_industry_info_read
日历
日历应用中日程写权限
Calendar.Event.Write
日历应用中日程读权限
Calendar.Event.Read
会议室
视频会议信息读权限
VideoConference.Conference.Read
视频会议信息管理权限
VideoConference.Conference.Write
机器人
企业内机器人发送消息权限
qyapi_robot_sendmsg
4、设置事件订阅
推送方式设置为:Stream模式推送 ,点击已完成接入,验证验证通道。如果通讯录和协同平台没有先选中钉钉,会验证失败
验证通过后,点击保存
5、配置相关的事件订阅接口权限及成员列表
全部成员:企业内所有成员的通讯录权限 部分成员:选择该范围后,你还需要手动选择部门或成员,以确认通讯录权限范围
以下列出当前版本所需要配置的所有接口权限
通讯录相关● 通讯录用户增加● 通讯录用户更改● 通讯录用户离职● 通讯录企业部门创建
日程&会议室相关● 会议室预定等事件,预定成功、取消等● 会议室创建、更新、删除等
5、权限和事件配置完成后发布应用
6、回到Smart进行同步
注意:同步钉钉数据时需要先同步钉钉通讯录再同步协同空间(调用同步协同空间接口时需要人员的ID)
7、管理员在钉钉软件添加H5应用
在工作台的全部应用下点击添加,检索配置的应用名,将应用添加到工作台