1.3注意事项

加签方式是钉钉机器人和开发者双向进行安全认证在群内自定义机器人时开发者的POST地址收到机器人消息携带的headers参数其中包含timestamp和sign字段开发者需要在自己服务内重新计算sign签名值最后再调用自定义机器人发送消息接口时携带开发者服务器内系统当前timestamp和重新计算的sign签名以此来验证安全性。

③IP地址

设定后只有来自IP地址范围内的请求才会被正常处理支持两种设置方式IP地址和IP地址段暂不支持IPv6地址白名单

①引入依赖

dependencygroupIdcom.aliyun/groupIdartifactIdalibaba-dingtalk-service-sdk/artifactIdversion2.0.0/version

package

com.kingagroot.info.common.tools.thirdparty;import

com.alibaba.nacos.api.config.annotation.NacosValue;

import

com.dingtalk.api.DefaultDingTalkClient;

import

com.dingtalk.api.DingTalkClient;

import

com.dingtalk.api.request.OapiRobotSendRequest;

import

com.kingagroot.info.common.tools.common.LogTool;

import

org.springframework.beans.factory.annotation.Autowired;

import

org.springframework.stereotype.Component;import

javax.crypto.Mac;

javax.crypto.spec.SecretKeySpec;

import

java.io.UnsupportedEncodingException;

import

java.nio.charset.StandardCharsets;

import

java.security.InvalidKeyException;

import

java.security.NoSuchAlgorithmException;

import

System.currentTimeMillis();String

stringToSign

Mac.getInstance(HmacSHA256);mac.init(new

SecretKeySpec(secret.getBytes(StandardCharsets.UTF_8),

HmacSHA256));byte[]

mac.doFinal(stringToSign.getBytes(StandardCharsets.UTF_8));String

sign

String(Base64.getEncoder().encode(signData)),

UTF-8);String

DefaultDingTalkClient(getURL());}/***

发送钉钉消息**

getClient();OapiRobotSendRequest

request

OapiRobotSendRequest();//设置发送消息类型request.setMsgtype(text);//设置消息内容OapiRobotSendRequest.Text

text

OapiRobotSendRequest.Text();text.setContent(msg);request.setText(text);//设置给谁发送消息OapiRobotSendRequest.At

new

isAtAll类型如果不为Boolean请升级至最新SDK设置为true代表群内的所有人at.setIsAtAll(true);//也可以指定接收人的手机号或者钉钉id将消息发送给指定的人//

at.setAtMobiles(Arrays.asList(1392xxxxx,155xxxx));request.setAt(at);client.execute(request);}

catch

}url是创建自定义机器人是的webhook地址secret是开启加签模式时的密钥。

使用加签方式调用自定义机器人发送消息时需要拼接当前的时间戳和签名。

签名生成方式把timestamp\n密钥当做签名字符串使用HmacSHA256算法计算签名然后进行Base64

encode最后再把签名参数再进行urlEncode得到最终的签名。

1.3注意事项

①部署到服务器后一定要开通服务器访问钉钉的权限否则会出现connect

②注意对钉钉发送异常时的信息记录可以存到日志表中或者是日志文件中

参照SpringBoot集成钉钉自定义机器人群消息推送-CSDN博客

2.1说明

首先要在钉钉的开发者后台创建应用获取应用的AppKey、AppSecret及AgentId。

获取企业内部应用的token然后再调用发送消息接口进行消息的发送。

2.2示例

com.kingagroot.info.common.tools.common;import

import

com.alibaba.nacos.api.config.annotation.NacosValue;

import

com.dingtalk.api.DefaultDingTalkClient;

import

com.dingtalk.api.DingTalkClient;

import

com.dingtalk.api.request.OapiGettokenRequest;

import

com.dingtalk.api.request.OapiMessageCorpconversationAsyncsendV2Request;

import

com.dingtalk.api.response.OapiGettokenResponse;

import

com.dingtalk.api.response.OapiMessageCorpconversationAsyncsendV2Response;

import

com.kingagroot.info.common.tools.thirdparty.DingDingTool;

import

org.springframework.beans.factory.annotation.Autowired;

import

org.springframework.stereotype.Component;/***

Author

DefaultDingTalkClient(tokenUrl);OapiGettokenRequest

request

OapiGettokenRequest();request.setAppkey(accessKey);request.setAppsecret(secret);request.setHttpMethod(GET);try

response

调用接口异常输出异常信息发送钉钉通知logTool.saveExceptionLog(,

DingUtils,

JSON.toJSONString(response));DingDingTool.sendDingMsg(获取钉钉token失败,

catch

调用接口异常输出异常信息logTool.saveExceptionLog(,

DingUtils,

DefaultDingTalkClient(sendMsgUrl);OapiMessageCorpconversationAsyncsendV2Request

request

OapiMessageCorpconversationAsyncsendV2Request();request.setAgentId(agentId);request.setUseridList(userCode);request.setToAllUser(false);OapiMessageCorpconversationAsyncsendV2Request.Msg

msg

OapiMessageCorpconversationAsyncsendV2Request.Msg();msg.setMsgtype(text);msg.setText(new

OapiMessageCorpconversationAsyncsendV2Request.Text());StringBuilder

content

StringBuilder();content.append(系统地址

);content.append(sysUrl);content.append(

);content.append(密码

);content.append(pwd);msg.getText().setContent(content.toString());request.setMsg(msg);try

{OapiMessageCorpconversationAsyncsendV2Response

result

调用接口异常输出异常信息logTool.saveExceptionLog(,

DingUtils,

调用接口异常输出异常信息logTool.saveExceptionLog(,

DingUtils,

①获取的token有效期为2个小时有效期内重复获取会返回相同结果并自动续期过期后获取会返回新的access_token。

开发者需要缓存access_token用于后续接口的调用。

因为每个应用的access_token是彼此独立的所以进行缓存时需要区分应用来进行存储。

不能频繁调用gettoken接口否则会受到频率拦截。

②发送消息接口为异步发送消息接口返回成功并不表示用户一定会收到消息需要通过获取工作通知消息的发送结果接口查询是否给用户发送成功。

③如果获取工作通知发送结果接口返回成功但用户还是没有接收到消息需要确认一下此用户是否在此钉钉关联的组织结构内。

④可以给全部员工发送也可以给某个部门的人发送也可以给某几个人通过指定接收人的钉钉id发送消息。