1.官方指导链接
2.创建一个群聊,添加自定义机器人
这一部分主要是进行两个关键参数的获取,得到即可
参数名 | 示例 |
secret | SECd33a8cb4cd57e1465ef67ca93fcb947crtrebd293e36c7b1df8cede5b9b |
webhook |
- ->设置 -> 智能群助手 ->添加机器人->选择 自定义机器人
- 点击添加
- 进入机器人配置页面 填写机器人名称,接下来配置安全设置,有三种安全设置可供选择,这里只演示加签安全设置
- 建议把加签后的 secret 复制下来备用 ,点击完成
这一步得到一个 webhook 建议复制下来一会要用
3.得到两个关键参数后,下面进入代码
- 添加下面两个maven依赖 版本可能会有更新,请大家留意官方文档
<!--钉钉依赖旧-->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>dingtalk</artifactId>
<version>1.2.15</version>
</dependency>
<!--钉钉依赖新-->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>alibaba-dingtalk-service-sdk</artifactId>
<version>2.0.0</version>
</dependency>
- 复制官方文档java测试用例 + 复制 签名计算示例代码
- 处理签名计算后的加密sign,结合webhook拼接完整 请求url
- 完整整合后代码
大家添加好依赖后,只需要替换掉final修饰成变量的两个关键参数即可使用
package com.shicilang;
import com.dingtalk.api.DefaultDingTalkClient;
import com.dingtalk.api.DingTalkClient;
import com.dingtalk.api.request.OapiRobotSendRequest;
import com.dingtalk.api.response.OapiRobotSendResponse;
import org.apache.commons.codec.binary.Base64;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.net.URLEncoder;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
/**
* @author shicilang
* @date 2022/1/21 11:05
* @Version 1.0
*/
@SpringBootTest
@RunWith(SpringRunner.class)
public class Test {
// 关键参数1 secret
private final String secret = "SECd33a8cb4cd57e1465ef67ca93这里放自己的secret9835af5fbd293e36c7b1df8cede5b9b";
// 关键参数2 webhook
private final String webhook = "https://oapi.dingtalk.com/robot/send?access_token=82这里放自己的webhook 9fb7fca3342d13a070f15d0cff10239d";
@org.junit.Test
public void dingSendTest() throws Exception {
// 签名计算示例代码部分
Long timestamp = System.currentTimeMillis();
String stringToSign = timestamp + "\n" + secret;
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(secret.getBytes("UTF-8"), "HmacSHA256"));
byte[] signData = mac.doFinal(stringToSign.getBytes("UTF-8"));
String sign = URLEncoder.encode(new String(Base64.encodeBase64(signData)), "UTF-8");
String signResult = "×tamp=" + timestamp + "&sign=" + sign;
// 得到拼接后的url
String url = webhook+signResult;
System.out.println(url);
// 发消息部分
DingTalkClient client = new DefaultDingTalkClient(url);
OapiRobotSendRequest request = new OapiRobotSendRequest();
request.setMsgtype("text");
OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();
text.setContent("测试文本消息");
request.setText(text);
OapiRobotSendRequest.At at = new OapiRobotSendRequest.At();
at.setAtMobiles(Arrays.asList("132xxxxxxxx"));
// isAtAll类型如果不为Boolean,请升级至最新SDK
at.setIsAtAll(true);
at.setAtUserIds(Arrays.asList("109929", "32099"));
request.setAt(at);
request.setMsgtype("link");
OapiRobotSendRequest.Link link = new OapiRobotSendRequest.Link();
link.setMessageUrl("https://www.dingtalk.com/");
link.setPicUrl("");
link.setTitle("时代的火车向前开");
link.setText("这个即将发布的新版本,创始人xx称它为红树林。而在此之前,每当面临重大升级,产品经理们都会取一个应景的代号,这一次,为什么是红树林");
request.setLink(link);
request.setMsgtype("markdown");
OapiRobotSendRequest.Markdown markdown = new OapiRobotSendRequest.Markdown();
markdown.setTitle("杭州天气");
markdown.setText("#### 杭州天气 @156xxxx8827\n" +
"> 9度,西北风1级,空气良89,相对温度73%\n\n" +
"> ![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)\n" +
"> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) \n");
request.setMarkdown(markdown);
OapiRobotSendResponse response = client.execute(request);
}
}
- 点击运行 钉钉群里已经可以看到消息了
4.其他
- 消息格式及类型建议参考官方文档
- 发送消息流程已通,为了教程简洁抽取工具类的方法还请大家自己按需要整合
- 欢迎大家留言区讨论