Java实现钉钉自定义群聊机器人

曾经终败给现在 2023-10-12 11:07 106阅读 0赞

![1f44bf2d90ea4de0bc4a75a736eac096.jpeg][]

> 参考文档：
> 
> [自定义机器人接入 - 钉钉开放平台![O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png][]https://open.dingtalk.com/document/orgapp/custom-robot-access][- _O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png_https_open.dingtalk.com_document_orgapp_custom-robot-access]
> 
> [自定义机器人安全设置 - 钉钉开放平台目前有3种安全设置方式，请根据需要选择一种。![O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png][]https://open.dingtalk.com/document/robots/customize-robot-security-settings][- _3_O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png_https_open.dingtalk.com_document_robots_customize-robot-security-settings]

1、群聊添加群聊机器人（此处以加签方式推送消息）

![c1fb9f9dbff145bf8097184521b27d7f.png][]

此处如若设置**自定义关键词**，则发送文本内容中必须包含该关键词否则推送无效，并且后续无需传sign&timestamp参数（测试环节有详细说明）

![e5eb8399ce594801987b5550b2e9c4dc.png][]

2、保存推送信息以备用

![bab45bb4dec9480eaa1aee9578016e30.png][]

3、请求参数初始化

public static void main(String[] args) throws Exception{
            Long timestamp = System.currentTimeMillis()+50*60*1000;//保证时间误差不超过1小时
            System.out.println("timestamp:"+timestamp);
            String 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:"+sign);
        }

运行结果如下所示：

![c0809d1b1fb24c319dbeec983839a80c.png][]

4、复制出机器人的Webhook地址，拼接请求参数，尝试发送群消息

![c33674b02d3e4d79bc5c96cab30dbb4d.png][]

![cdb0868c9b78492fa490e3c5ccc5e823.png][]

![7e4db23f2050483b8937512364bcde20.png][]

5、消息推送API使用说明

> **重要**
> 
>  *  已默认开通使用自定义机器人发消息的权限，无需申请。即向Webhook地址发请求时，无需申请权限。
>  *  发起POST请求时，必须将字符集编码设置成UTF-8。
>  *  每个机器人每分钟最多发送20条。消息发送太频繁会严重影响群成员的使用体验，大量发消息的场景 (譬如系统监控报警) 可以将这些信息进行整合，通过markdown消息以摘要的形式发送到群里。
>  *  **接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或[钉钉专属版(Open API调用量500万次/月)][Open API_500]扩容调用次数。

具体参数说明参考：[自定义机器人在群聊场景中的使用 - 钉钉开放平台][-]

[1f44bf2d90ea4de0bc4a75a736eac096.jpeg]: https://img-blog.csdnimg.cn/1f44bf2d90ea4de0bc4a75a736eac096.jpeg
[O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png]: https://img.alicdn.com/imgextra/i4/O1CN01RtfAks1Xa6qJFAekm_!!6000000002939-2-tps-128-128.png
[- _O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png_https_open.dingtalk.com_document_orgapp_custom-robot-access]: https://open.dingtalk.com/document/orgapp/custom-robot-access
[- _3_O1CN01RtfAks1Xa6qJFAekm_6000000002939-2-tps-128-128.png_https_open.dingtalk.com_document_robots_customize-robot-security-settings]: https://open.dingtalk.com/document/robots/customize-robot-security-settings
[c1fb9f9dbff145bf8097184521b27d7f.png]: https://img-blog.csdnimg.cn/c1fb9f9dbff145bf8097184521b27d7f.png
[e5eb8399ce594801987b5550b2e9c4dc.png]: https://img-blog.csdnimg.cn/e5eb8399ce594801987b5550b2e9c4dc.png
[bab45bb4dec9480eaa1aee9578016e30.png]: https://img-blog.csdnimg.cn/bab45bb4dec9480eaa1aee9578016e30.png
[c0809d1b1fb24c319dbeec983839a80c.png]: https://img-blog.csdnimg.cn/c0809d1b1fb24c319dbeec983839a80c.png
[c33674b02d3e4d79bc5c96cab30dbb4d.png]: https://img-blog.csdnimg.cn/c33674b02d3e4d79bc5c96cab30dbb4d.png
[cdb0868c9b78492fa490e3c5ccc5e823.png]: https://img-blog.csdnimg.cn/cdb0868c9b78492fa490e3c5ccc5e823.png
[7e4db23f2050483b8937512364bcde20.png]: https://img-blog.csdnimg.cn/7e4db23f2050483b8937512364bcde20.png
[Open API_500]: https://page.dingtalk.com/wow/dingtalk/act/zsdd?&spm=a2q49.26303778
[-]: https://open.dingtalk.com/document/orgapp/custom-bot-to-send-group-chat-messages