钉钉通知

简介: 本文介绍如何通过Java代码调用钉钉机器人API,实现系统告警消息的实时推送。涵盖机器人创建、PostMan测试、Java代码编写及实际应用优化,如封装工具类、配置解耦等,并提供常见失败原因分析,助力高效集成钉钉告警通知。

本文讲实现Java代码调用钉钉机器人API,发送指定告警消息的效果,以满足用户对于系统的实时监控。

API:https://open.dingtalk.com/document/orgapp/custom-robots-send-group-messages

每个机器人每分钟最多发送20条消息到群里,如果超过20条,会限流10分钟。

重要

如果有大量发消息的场景(譬如系统监控报警)可以将这些信息进行整合,通过markdown消息以摘要的形式发送到群

1.创建钉钉机器人

创建告警群聊

就拉一个普通群聊就可以

创建机器人

  • 群设置选择机器人


  • 选择自定义机器人

  • 定义机器人相关信息,重点关注关键词

保存Webhook

2.PostMan测试发送API

基于官方提供的API,我们可以做下述测试

官方请求示例

请求示例(HTTP)

  • 下面的token需要替换成webhook中的地址
POST https://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代码

import com.dingtalk.api.DefaultDingTalkClient;
import com.dingtalk.api.DingTalkClient;
import com.dingtalk.api.request.OapiRobotSendRequest;
import com.dingtalk.api.response.OapiRobotSendResponse;
import com.taobao.api.ApiException;
import java.util.Arrays;
public class DingTalk {
    public static void main(String[] args) {
        try {
            // 1-初始化API调用Client
            DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/robot/send?access_token=87b520af3e0b6aacc137d1525e4d9b21f61c901f1c8ac4f05a17bc12a8e7f737");
            // 2-初始化请求参数
            OapiRobotSendRequest req = new OapiRobotSendRequest();
            // 2-1 设置消息类型
            req.setMsgtype("text");
            // 2-2 设置消息@人
            OapiRobotSendRequest.At at = new OapiRobotSendRequest.At();
            at.setAtMobiles(Arrays.asList("17600477102"));
            req.setAt(at);
            // 2-3 设置消息内容(必须匹配关键词),工作中这里就对应error日志
            OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();
            text.setContent("[告警]测试java代码消息");
            req.setText(text);
            // 3 消息发送
            OapiRobotSendResponse rsp = client.execute(req, "");
            System.out.println(rsp.getBody());
        } catch (ApiException e) {
            e.printStackTrace();
        }
    }
}

代码测试

4.工作中到底怎么用

上面我们完成了简单的告警通知,实际工作中也是这么来做,但是会做一点点优化

  • 将上述代码封装成一个工具类,如:DingTalkMessageUtil
  • 将token保存在nacos中,与代码解耦
  • 在有异常日志、慢SQL等关键场景中调用此工具类,将消息发送到群,让开发人员及时感知并处理

5.失败原因分析

  • 看看你发送消息中,是不是没有自己定义的关键词
  • 看看你消息的接收方,是不是userId或手机号不对
相关文章
|
4月前
|
监控 安全 机器人
钉钉通知
本文介绍如何通过Java代码调用钉钉机器人API实现系统告警消息实时推送。涵盖机器人创建、Webhook配置、Postman测试及Java代码封装,强调关键词匹配与限流规则,助力开发人员高效集成钉钉通知,提升系统监控响应能力。(238字)
647 0
|
存储 Java 文件存储
微服务——SpringBoot使用归纳——Spring Boot使用slf4j进行日志记录—— logback.xml 配置文件解析
本文解析了 `logback.xml` 配置文件的详细内容,包括日志输出格式、存储路径、控制台输出及日志级别等关键配置。通过定义 `LOG_PATTERN` 和 `FILE_PATH`,设置日志格式与存储路径;利用 `&lt;appender&gt;` 节点配置控制台和文件输出,支持日志滚动策略(如文件大小限制和保存时长);最后通过 `&lt;logger&gt;` 和 `&lt;root&gt;` 定义日志级别与输出方式。此配置适用于精细化管理日志输出,满足不同场景需求。
2990 1
|
4月前
|
SQL 分布式计算 运维
XXLJOB:超长定时任务慢节点优化实践
本文针对ODPS大宽表任务运行慢的问题,通过定位耗时卡点、解决数据倾斜与计算堆积,提出视图落表、节点拆分、前置裁剪、中表关联等优化方案,显著提升任务效率,产出时间提前4小时以上,并降低回刷成本与资源消耗。
|
Linux
Linux系统盘制作(UltraISO)
Linux系统盘制作(UltraISO)
1033 1
|
2月前
|
人工智能 自然语言处理 安全
免费的BI产品推荐(2026年最新版)
2026年,瓴羊Quick BI成免费BI首选:永久免费基础版+30天高级试用;零代码操作,支持Excel/MySQL等多源接入;内置“智能小Q”AI助手,自然语言秒出图表与归因分析;国产安全合规,适配中小企、创业者及一线业务人员。让数据决策真正零门槛。
|
存储 固态存储 Linux
如何看电脑的配置
**电脑配置关乎日常使用体验,包括CPU、内存、硬盘、显卡、主板和操作系统等。要查看配置,可右击“此电脑”选“属性”查看基础信息,使用任务管理器检查性能,运行&quot;msinfo32&quot;获取详细系统信息,或借助如CPU-Z等第三方工具。了解配置助于选购和优化电脑。**
如何看电脑的配置
|
XML Java 开发者
深入解析 Spring 和 Spring Boot 的区别
深入解析 Spring 和 Spring Boot 的区别
|
4月前
|
缓存 NoSQL Java
[ERP]SpringBoot集成Redis技术(☆)
本文介绍如何从Gitee克隆项目并运行代码,涵盖JDK、Maven等环境配置问题及应对策略。通过商品管理接口引入Redis缓存的实战需求,锻炼开发者在真实工作场景中独立解决问题、主动沟通和使用工具测试的能力,涉及git、maven、springboot、redis等核心技术。
 [ERP]SpringBoot集成Redis技术(☆)
Element-UI中el-input输入值不显示
Element-UI中el-input输入值不显示
1060 0
|
4月前
|
Java 关系型数据库 MySQL
低代码平台芋道:代码本地运行(☆)
简介:本任务面向新人,要求基于SpringBoot、MySQL、Maven技术栈,本地导入并运行指定项目,自行解决JDK、Maven等环境问题。需录制8分钟以上视频,讲述对项目技术架构、核心功能及数据库关系的理解,并提出当前困惑,提升表达与思考能力,助力快速融入团队。
 低代码平台芋道:代码本地运行(☆)