一.钉钉开发平台配置
钉钉开发后台链接:open-dev.dingtalk.com/fe/app#/corp/app(需管理员账户或已开启开发权限账户才可配置)
1.创建应用程序
2.配置机器人
创建酷应用---添加(配置)机器人---开启机器人配置;消息接受模式需选择stream模式,再调试(调试时,钉钉会生成一个内部测试群),再点发布;
3.获取机器人的Webhook地址
进入调试创建的测试群---群设置---机器人---webhookfu复制(到这钉钉端已全部配置完成)
二、开发端配置
1.引入依赖
第一个依赖:处理向钉钉API发送的请求
第二个依赖:将Map装换为Json格式
<!-- 钉钉消息推送 -->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>alibaba-dingtalk-service-sdk</artifactId>
<version>1.0.1</version>
<exclusions>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2</artifactId>
<version>2.0.33</version>
</dependency>
2.编写代码
将Webhook地址和需通知人的钉手机号带入即可,当然也可群里@所有人,方法代码中已备注
package org.DingDingPush;
import com.alibaba.fastjson2.JSON;
import com.beust.jcommander.internal.Maps;
import org.apache.commons.compress.utils.Lists;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.URL;
import java.net.URLConnection;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* @Description: 钉钉群消息推送工具类
* @author: QiTan
* @date: 2023/12/25 11:42
*/
public class DingDingGroupPush {
public static void main(String[] args) {
StringBuffer pushSb = new StringBuffer();
pushSb.append("【")
.append(new Date()).append("】")
.append("你好China");
//通知具体人的手机号码列表
List<String> mobileList = Lists.newArrayList();
mobileList.add("需通知人钉钉上的手机号码");
mobileList.add("需通知人钉钉上的手机号码");
DingDingGroupPush.send(pushSb.toString(),false,mobileList);
}
/**
* @author QiTan
* @param content 消息推送的内容
* @param isAtAll 推送所有人
* @param content 所推送人手机号码
* @return
**/
public static String send(String content,boolean isAtAll,List<String> mobileList){
//测试机器人key(webhook地址)
String dingKey ="webhook地址";
// 请求的JSON数据,这里我用map在工具类里转成json格式
Map<String,Object> json=new HashMap<>();
Map<String,Object> text=new HashMap<>();
//通知人
Map<String, Object> atUser = Maps.newHashMap();
//1.是否通知所有人
atUser.put("isAtAll", isAtAll);
//2.通知具体人的手机号码列表
atUser.put("atMobiles", mobileList);
json.put("at",atUser);
json.put("msgtype","text");
text.put("content",content);
json.put("text",text);
// 发送post请求
String result = DingDingGroupPush.sendPostByMap(dingKey, json);
System.out.println("result state " + result);
return result;
}
/**
* 发送POST请求,参数是Map, contentType=x-www-form-urlencoded
*
* @param url
* @param mapParam
* @return
*/
public static String sendPostByMap(String url, Map<String, Object> mapParam) {
Map<String, String> headParam = new HashMap<>();
headParam.put("Content-type", "application/json;charset=UTF-8");
return sendPost(url, mapParam, headParam);
}
/**
* 向指定 URL 发送POST方法的请求
*
* @param url 发送请求的 URL
* @param param 请求参数,
* @return 所代表远程资源的响应结果
*/
public static String sendPost(String url, Map<String, Object> param, Map<String, String> headParam) {
PrintWriter out = null;
BufferedReader in = null;
String result = "";
try {
URL realUrl = new URL(url);
// 打开和URL之间的连接
URLConnection conn = realUrl.openConnection();
// 设置通用的请求属性 请求头
conn.setRequestProperty("accept", "*/*");
conn.setRequestProperty("connection", "Keep-Alive");
conn.setRequestProperty("user-agent",
"Fiddler");
if (headParam != null) {
for (Map.Entry<String, String> entry : headParam.entrySet()) {
conn.setRequestProperty(entry.getKey(), entry.getValue());
}
}
// 发送POST请求必须设置如下两行
conn.setDoOutput(true);
conn.setDoInput(true);
// 获取URLConnection对象对应的输出流
out = new PrintWriter(conn.getOutputStream());
// 发送请求参数
out.print(JSON.toJSONString(param));
// flush输出流的缓冲
out.flush();
// 定义BufferedReader输入流来读取URL的响应
in = new BufferedReader(
new InputStreamReader(conn.getInputStream()));
String line;
while ((line = in.readLine()) != null) {
result += line;
}
System.out.println("line=" +line);
} catch (Exception e) {
System.out.println("发送 POST 请求出现异常!" + e);
e.printStackTrace();
}
//使用finally块来关闭输出流、输入流
finally {
try {
if (out != null) {
out.close();
}
if (in != null) {
in.close();
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
return result;
}
}
3.实现效果
当然,如不在群里通知,只想个人推送,请看小编下片文章!