Java项目中集成钉钉机器人推送消息提醒

前言：

      项目中有一个需求，当有新订单产生的时候，希望能够及时通知到业务相关人员进行处理，整体考虑了一下，选用了钉钉机器人提醒功能（公司内部主要也是使用钉钉进行通讯）。

 

操作：

      主要分为两部分进行处理：

      一、添加自定义机器人

      首先新建一个群

      步骤一：【电脑钉钉 】-【群聊】-【群设置】-【智能群助手】-【添加更多】-【添加机器人】-【自定义】-【添加】，编辑机器人名称和选择添加的群组。完成必要的安全设置（至少选择一种），勾选 我已阅读并同意《自定义机器人服务及免责条款》，点击“完成”即可。

      （备注：安全设置方式，我选用的是加签，密钥要复制出来，后面要用到）

      

 

 

      步骤二：复制出机器人的Webhook地址（格式如下截图），可用于向这个群发送消息。并点击【完成】，自定义机器人就添加成功了。

      

 

 

      二、代码部分

      主要分为两部分进行处理：

      首先在application中配置accessToken和密钥

#集成钉钉服务
ding:
  robot:
    token: 对应Webhook中的access_token值
    key: 对应安全设置->加签方式中的密钥

      添加加密方式

    /**
     * 钉钉自定义机器人安全设置
     * 把timestamp+"\n"+密钥当做签名字符串，使用HmacSHA256算法计算签名，然后进行Base64 encode，最后再把签名参数再进行urlEncode，得到最终的签名（需要使用UTF-8字符集）
     * @param secret
     * @return
     */
    public static String dingHmacSHA256(String timestamp, String secret) {
        try {
            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");
            return sign;
        } catch (Exception e) {
            log.error("dingHmacSHA256加密失败", e);
        }
        return null;
    }

      业务代码

    @Value("${ding.robot.token}")
    private String robotToken;
    @Value("${ding.robot.key}")
    private String robotKey;

    @Autowired
    private RestTemplate restTemplate;

    /**
     * 推送钉钉机器人消息
     * @param type
     * @return
     */
    public String sendDingMsg(String type, String orderId, String serviceName) {
        String timestamp = String.valueOf(System.currentTimeMillis());
        String sign = HmacSha256Util.dingHmacSHA256(timestamp, robotKey);
        // 钉钉机器人地址（配置机器人的webhook）
        // https://oapi.dingtalk.com/robot/send?access_token=XXXXXX&timestamp=XXX&sign=XXX
        String dingUrl = "https://oapi.dingtalk.com/robot/send?access_token=" + robotToken + "&timestamp=" + timestamp + "&sign=" + sign;

        //是否通知所有人
        boolean isAtAll = true;

        //通知具体人的手机号码列表
        List<String> mobileList = Lists.newArrayList();
        //mobileList.add("填入手机号，可以具体@到某个人");
        //mobileList.add("13411111111");

        //钉钉机器人消息内容
        String content = "【提醒】有一笔新的[" + serviceName + "]服务订单，订单号为" + orderId + "，请及时查看！";
        //组装请求内容
        Map<String, Object> reqStr = buildReqStr(content, isAtAll, mobileList);
        return invokeGeneralApi(dingUrl, reqStr);
    }

    /**
     * 组装请求报文
     * @param content
     * @return
     */
    private Map<String, Object> buildReqStr(String content, boolean isAtAll, List<String> mobileList) {
        //消息内容
        Map<String, String> contentMap = Maps.newHashMap();
        contentMap.put("content", content);

        //通知人
        Map<String, Object> atMap = Maps.newHashMap();
        //1.是否通知所有人
        atMap.put("isAtAll", isAtAll);
        //2.通知具体人的手机号码列表
        atMap.put("atMobiles", mobileList);

        Map<String, Object> reqMap = Maps.newHashMap();
        reqMap.put("msgtype", "text");
        reqMap.put("text", contentMap);
        reqMap.put("at", atMap);

        return reqMap;
    }
    
    @Override
    public String invokeGeneralApi(String url, Map<String, Object> params) {
        String body = "";
        try {
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            HttpEntity<Map<String, Object>> httpEntity = new HttpEntity<>(params, headers);
            ResponseEntity<String> entity = restTemplate.postForEntity(url, httpEntity, String.class);
            body = entity.getBody();
            LOGGER.info("invokeGeneralApi()>>>[{}]", body);
        } catch (RestClientException e) {
            LOGGER.error("API调用错误，接口地址:[{}]，请求参数:[{}]", url, params, e);
        }
        return body;
    }    

      三、效果图

      

 

 

官方链接：

      添加自定义机器人

      自定义机器人安全设置