钉钉作为现在很多企业的移动办公平台,具有很多很强大的功能,可以帮助我们更加及时的发现问题,解决问题,今天我们做一个java实现钉钉自定义机器发送消息的功能。

首先,先放出官方文档地址:https://open.dingtalk.com/document/orgapp/custom-robot-access

接下来,先创建一个钉钉的群,打开钉钉群,在群的右上角点击齿轮图标 – 群设置,

再打开的群设置按钮,点击机器人,选择机器人 -添加机器人 – 自定义机器人

添加机器人

自定义机器人

进入到机器人设置页面

设置完成之后,会生成一个webhook地址,复制该地址出来。

然后点击完成,群内自定义机器人就添加完成了。

机器人添加完成之后,我们需要在代码中实现对机器人发送消息的功能。

在java代码中,我们可以创建一个钉钉发送消息的utils类,代码如下

public class DingdingTalkUtils {    public static String url = "webhook地址"; //生成机器人申城webhook地址    public static String keyWords = "安全设置-关键字内容"    public static String access__secret = "安全设置-加签"; //安全设置 - 加签方式下生成的秘钥    public static String sendKeyWordMessage(String json) {        try {            if (!StringUtils.contains(json, keyWords)) {                log.error("使用了钉钉群发送消息但是没有关键词 :{} >>> {} 将无法发送消息,直接退回", json, keyWords);                return null;            }            Map tmpMap = new HashMap();            tmpMap.put("content", json);            Map contentMap = new HashMap();            contentMap.put("msgtype", "text");            contentMap.put("text", tmpMap);            Map headers = new HashMap();            headers.put("Content-Type", "application/json; charset=utf-8");            headers.put("Accept", "application/json");            return HttpSupport.makeFastConnect().doPostBody(url,               JsonUtil.obj2Json(contentMap), headers).result();        } catch (Exception e) {            log.error("发送钉钉消息出现异常:{}", e.getMessage());        }        return null;    }    public static String sendEncryptMessage(String json, String secretKey) {        try {            String url = getUrl(secretKey);            Map tmpMap = new HashMap();            tmpMap.put("content", json);            Map contentMap = new HashMap();            contentMap.put("msgtype", "text");            contentMap.put("text", tmpMap);            Map headers = new HashMap();            headers.put("Content-Type", "application/json; charset=utf-8");            headers.put("Accept", "application/json");            return HttpSupport.makeFastConnect().doPostBody(url, JsonUtil.obj2Json(contentMap), headers).result();        } catch (Exception e) {            log.error("发送钉钉消息出现异常:{}", e.getMessage());        }        return null;    }    private static String getUrl(String secretKey) throws Exception {        String result = url;        long timestamp = System.currentTimeMillis();        String stringToSign = timestamp + "\n" + secretKey;        Mac mac = Mac.getInstance("HmacSHA256");        mac.init(new SecretKeySpec(secretKey.getBytes(StandardCharsets.UTF_8), "HmacSHA256"));        byte[] signData = mac.doFinal(stringToSign.getBytes(StandardCharsets.UTF_8));        String sign = URLEncoder.encode(new String(Base64.encodeBase64(signData)), "UTF-8");        result += "&timestamp=" + timestamp + "&sign=" + sign;        return result;    }}

上面的代码提供了通过关键字匹配发送,以及加签方式发送消息的两种方法,其中

contentMap.put("msgtype", "text");这里面指定了发送的消息以何种形式展现,目前钉钉提供了五种展现消息的形式:
  • 文本 (text)

  • 链接 (link)

  • markdown(markdown)

  • ActionCard

  • FeedCard

另外,如果引入钉钉的sdk,还能实现@功能,有兴趣的同学可以看一下官方文档,实现钉钉机器人发送消息的功能并不难实现,相信难不倒大家,不过还是希望这篇文章能对大家有一点点的帮助,好了,今天的分享就到这里了,感谢大家!