钉钉作为现在很多企业的移动办公平台,具有很多很强大的功能,可以帮助我们更加及时的发现问题,解决问题,今天我们做一个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; } MaptmpMap = 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 += "×tamp=" + timestamp + "&sign=" + sign; return result; } }
上面的代码提供了通过关键字匹配发送,以及加签方式发送消息的两种方法,其中
contentMap.put("msgtype", "text"); 这里面指定了发送的消息以何种形式展现,目前钉钉提供了五种展现消息的形式:
文本 (text)
链接 (link)
markdown(markdown)
ActionCard
FeedCard
另外,如果引入钉钉的sdk,还能实现@功能,有兴趣的同学可以看一下官方文档,实现钉钉机器人发送消息的功能并不难实现,相信难不倒大家,不过还是希望这篇文章能对大家有一点点的帮助,好了,今天的分享就到这里了,感谢大家!