**钉钉消息推送开发介绍**

前言：钉钉官方开发文档有非常详细的 API 接口调用栗子，从而梳理钉钉应用内部的 userid 机制、access_token、接口权限的关系。

使用场景: 项目中会经常使用到异常评审或逐级反馈的需求。这些反馈信息需要推送到指定人员，实现的方式通常有微信消息推送、钉钉消息推送这两种比较常用接口调用方式。

提示：如果想直接看开发调用实现, 请直接拖拽至底部，上传的一共有三个文件:
api 调用类： DingDingToolService.java
参数配置 : ding.properties
pom 配置 : 引入本地钉钉的 SDK 第三方 jar, 否则打包的时候会报错
服务端 API SDK 下载: https://ding-doc.dingtalk.com/doc#/faquestions/vzbp02

准备工作

1. 申请账号

进入钉钉开发者平台注册账号，根据使用场景我们选择企业内部应用。提示: 我们公司的企业钉钉账号 {手机号} 就可以直接按照提示登录, 无需注册。

2. 创建小程序

第一步：进入文档之后, 根据开发文档的引导说明 {快速入门 - 创建小程序}, 登录钉钉开发者后台，选择 "应用开发"-“企业内部开发”-“小程序”，点击 "创建应用"。

第二步：配置开发信息
配置服务器出口 IP：就是服务器的公网 ip, 接口调用需要服务器可访问外网

第三步：对下图中的应用信息、人员设置 和 接口权限进行配置。

1. 人员信息中包含的有 ding.properties 的配置项目 AgentId、AppKey、AppSecret

2. 钉钉 API 接口都是通过 userId 机制进行消息的发送的，所以需要添加这个接口权限.

3. 关键参数项说明:
CorpID： 是企业在钉钉中的标识，每个企业拥有唯一的 CorpID。  
UserId ： 企业内每个员工都有唯一的 UserId，创建后不可修改。
AppId ： 为应用标识。
AppSecret 身份验证场景中均会使用到：
扫码登录第三方网站、钉钉内免登第三方网站、密码登录第三方网站.appId 和 appSecret 用于生成 ACCESS_TOKEN。

DingDingToolService 代码调用样例：
目前只实现了这两种调用方式, 如果有其他的需求请自行查阅 API
1. 按照手机号进行推送给指定人员

2. 推送给指定手机号的人员组

3. 开发文件链接地址

DingDingToolService.java
ding.properties
pom.xml

POM 配置