钉钉集成手册¶

场景¶

• 实现钉钉与平台租户日程信息的双向同步（会议室日程）；

• 实现钉钉与平台租户通讯录同步；

前置条件¶

• 钉钉管理员进行相关操作配置

• 需要创建自建应用并提供 CorpId(企业ID)，AgentID，APPKey，APPSecret，加密 aes_key，签名 token

操作步骤¶

获取钉钉企业ID¶

• 管理员登录钉钉开放平台

https://open-dev.dingtalk.com/#/index

• 首页找到【企业ID】并复制保存

创建自建应用¶

• 登录钉钉开放平台后点击切换到【应用开发】界面，点击【创建应用】按钮

• 填写应用名称和描述，点击【保存】按钮保存应用

• 保存成功后，点击【应用名称】进入应用详情

• 在【基础信息】-->【凭证与基础信息】中获取 AgentId，APPKey，APPSecret 保存

• 进入【权限管理】配置相关权限

  • 通讯录部门信息读权限 qyapi_get_department_list

• 通讯录部门成员读权限 qyapi_get_department_member

• 企业员工手机号信息 fieldMobile

• 日历应用中日程写权限 Calendar.Event.Write

• 日历应用中日程读权限 Calendar.Event.Read

• 配置事件订阅

  • 订阅管理配置推送方式，获取加密 aes_key，签名 token

请求网址

• 跳转管理后台填写相关配置等到后台完成钉钉通讯录配置后，点击【保存】按钮进行保存、

• 配置【日程变更】事件[]{#monitor .anchor}监听，打开对应开关

配置钉钉通讯录¶

• 登录管理后台进入租户组织管理界面

• 点击【账户管理】-->【系统配置】-->【通讯录】进入通讯录配置页面

- 将获取到的钉钉配置信息填写到对应的表单中，然后点击【确定】按钮保存

• 跳转到钉钉自建应用继续配置事件订阅

同步用户通讯录¶

• 前置条件：完成【智会办公平台配置钉钉通讯录】相关配置

• 登录管理后台进入租户组织管理界面

- 点击【账户管理】-->【系统配置】-->【通讯录】-->【数据同步】按钮，同步钉钉通讯录数据

• 点击查看【用户管理】模块如果有钉钉用户数据说明通讯录同步成功