记一次钉钉群聊机器人的开发_钉钉机器人上传图片-CSDN博客

本文链接：https://blog.csdn.net/qq_46993700/article/details/107959598

本文记录了一次使用Java开发钉钉群聊机器人的过程，包括需求描述、开发思路和详细步骤。开发者通过阅读钉钉开发文档，创建并设置机器人，理解消息格式，实现了向钉钉群发送自定义文本和图片消息的功能。开发过程中强调了正确调用API接口、设置安全模式以及处理不同消息类型的重要性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

一、需求描述
二、开发思路
三、开发步骤
四、总结

一、需求描述

为实现更好的沟通，现需要实现以自定义形式向钉钉群聊中发送文本内容及图片消息的功能。

二、开发思路

（一）明确需求。即向钉钉群聊内发送自定义文本或图片消息
（二）阅读钉钉开发手册。钉钉具有一套面向开发者的开发手册，其上描述了钉钉对外提供的API接口，我们可以通过调用接口实现相应功能。
（三）了解接口要求。在我们调用接口时，需要向其中传递符合规范的参数，并以规定的方式调用，避免出错。若返回的消息出错，阅读错误码文档，对症下药进行修改。
（四）搭建开发环境编写代码。项目基于Springboot开发，Springboot确实能为开发省下了不少麻烦事，也不必再花费大量时间在配置上。
（五）测试

三、开发步骤

（一）阅读开发文档

首先我们要明确这是一个后端项目，并且需要对群聊进行开发，因此对应钉钉开发文档的服务端API中的群聊机器人
在这里插入图片描述

钉钉群机器人开发文档链接

（二）创建机器人

如群机器人开发文档所示，首先我们得创建机器人并设置安全模式，安全模式分为三种，分别是关键字，加签（加密），IP地址限制

我们必须选取其中的任意一种或多种。
对各项安全模式进行讲解：
（1）方式一，自定义关键词
最多可以设置10个关键词，消息中至少包含其中1个关键词才可以发送成功。
例如：添加了一个自定义关键词：监控报警
则这个机器人所发送的消息，必须包含监控报警这个词，才能发送成功。
关键字模式调用的接口URL模板为

https://oapi.dingtalk.com/robot/send?access_token=XXXXXX

（2）方式二，加签
要求如下

第一步，把timestamp+"\n"+密钥当做签名字符串，使用HmacSHA256算法计算签名，然后进行Base64 encode，最后再把签名参数再进行urlEncode，得到最终的签名（需要使用UTF-8字符集）。

其中需要两个参数，分别为timestamp与secret

参数	说明
timestamp	当前时间戳，单位是毫秒，与请求调用时间误差不能超过1小时
secret	密钥，机器人安全设置页面，加签一栏下面显示的SEC开头的字符串

Java代码

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.codec.binary.Base64;
import java.net.URLEncoder;

public class Test {
   
    public static void main(String[] args) throws Exception {
   
        Long timestamp = System.currentTimeMillis();
        String secret = "secret";//此处填写安全设置页面下面的密钥字符串

        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");
        System.out.println(sign);
    }
}