1.创建钉钉机器人
创建告警群聊
就拉一个普通群聊就可以
创建机器人
- 群设置选择机器人
- 选择自定义机器人
- 定义机器人相关信息，重点关注关键词
保存Webhook
2.PostMan测试发送API
基于官方提供的API，我们可以做下述测试
官方请求示例
请求示例（HTTP）
- 下面的token需要替换成webhook中的地址
POSThttps://oapi.dingtalk.com/robot/send?access_token=ACCESS_TOKEN
- 请求正文
- 下面消息类型支持多种，通过msgtype声明你要哪种
- at，标识群里@哪些人，如果isAtAll就标识@群里所有人，@atMobiles标识指定手机号，其余参数同理
{ "at":{ "isAtAll":"false", "atUserIds":["user001","user002"], "atMobiles":["15xxx","18xxx"] }, //链接消息"link":{ "messageUrl":"1", "picUrl":"1", "text":"1", "title":"1" }, //markdown消息"markdown":{ "text":"1", "title":"1" }, //feedCard消息"feedCard":{ "links":{ "picURL":"1", "messageURL":"1", "title":"1" } }, //文本消息"text":{ "content":"123" }, "msgtype":"text", //actionCard消息"actionCard":{ "hideAvatar":"1", "btnOrientation":"1", "singleTitle":"1", "btns":[{ "actionURL":"1", "title":"1" }], "text":"1", "singleURL":"1", "title":"1" } }
测试@所有人
测试@指定人
测试卡片消息
3.编写发送代码
有了上述PostMan的测试，下面的java代码编写对于我们来说就很简单了
引入pom依赖
公司内网则直接下载好：https://open-dev.dingtalk.com/sdk/download/java
<dependency><groupId>com.aliyun</groupId><artifactId>alibaba-dingtalk-service-sdk</artifactId><version>2.0.0</version></dependency><dependency><groupId>com.aliyun</groupId><artifactId>dingtalk</artifactId><version>2.0.18</version></dependency>
编写java代码
importcom.dingtalk.api.DefaultDingTalkClient; importcom.dingtalk.api.DingTalkClient; importcom.dingtalk.api.request.OapiRobotSendRequest; importcom.dingtalk.api.response.OapiRobotSendResponse; importcom.taobao.api.ApiException; importjava.util.Arrays; publicclassDingTalk { publicstaticvoidmain(String[] args) { try { // 1-初始化API调用ClientDingTalkClientclient=newDefaultDingTalkClient("https://oapi.dingtalk.com/robot/send?access_token=87b520af3e0b6aacc137d1525e4d9b21f61c901f1c8ac4f05a17bc12a8e7f737"); // 2-初始化请求参数OapiRobotSendRequestreq=newOapiRobotSendRequest(); // 2-1 设置消息类型req.setMsgtype("text"); // 2-2 设置消息@人OapiRobotSendRequest.Atat=newOapiRobotSendRequest.At(); at.setAtMobiles(Arrays.asList("17600477102")); req.setAt(at); // 2-3 设置消息内容(必须匹配关键词)，工作中这里就对应error日志OapiRobotSendRequest.Texttext=newOapiRobotSendRequest.Text(); text.setContent("[告警]测试java代码消息"); req.setText(text); // 3 消息发送OapiRobotSendResponsersp=client.execute(req, ""); System.out.println(rsp.getBody()); } catch (ApiExceptione) { e.printStackTrace(); } } }
代码测试
4.工作中到底怎么用
上面我们完成了简单的告警通知，实际工作中也是这么来做，但是会做一点点优化
- 将上述代码封装成一个工具类，如：DingTalkMessageUtil
- 将token保存在nacos中，与代码解耦
- 在有异常日志、慢SQL等关键场景中调用此工具类，将消息发送到群，让开发人员及时感知并处理
5.失败原因分析
- 看看你发送消息中，是不是没有自己定义的关键词
- 看看你消息的接收方，是不是userId或手机号不对
