1 简介

本篇文章主要是介绍钉钉同步人员信息到苍穹的配置和遇到的问题，从而实现通过钉钉待办任务和消息推送。

2 适用版本

金蝶云苍穹 V3.0以上

3 创建钉钉应用（如果已创建，跳过这一步）

3.1 进入管理后台

3.2 进入钉钉应用开发平台

路径：工作台—自建应用—进入到应用开发平台— 企业内部开发—创建应用

3.3 创建应用

输入应用名称、上传应用Logo，开发方式选择企业内部自主开发

3.4 设置出入口IP

选择开发管理，填写服务器出口IP，这里的IP必须是外网的IP，否则无法访问

3.5 接口权限配置

由于访问苍穹系统需要拿到用户的手机号作为登录凭证，需要开启用户的手机号码信息

3.6 应用发布

打开应用发布界面点击确认发布

4 苍穹钉钉参数配置

 1、进入苍穹系统，系统服务云---基础服务菜单---系统参数，钉钉参数位置填写对应的钉钉应用信息（只需要填写一个全员应用即可）

应用标识：对应上钉钉应用的应用凭证的AppKey

应用密钥：对应钉钉应用的AppSecret

企业ID：对应钉钉首页如图的CorpId

问题排查方式：

方式1：根据traceid查对应的日志

方式2：通过class查日志，类名：kd.bos.dd.service.DingDingServiceHelper

5 常见问题

 1、钉钉同步时，提示“DeptList is null”，从monitor日志上可以看到IP不在访问白名单的报错。报 错详情可见以下截图。

【处理方案】：将报错提示的ip添加到钉钉出口ip上

2、钉钉同步时，提示“DeptList is null”，从monitor日志上可以看到接口没有访问权限的报错。报 错详情可见以下截图。

【处理方案】：开启应用对应的接口权限，如图