Java推送釘釘應(yīng)用消息實現(xiàn)過程
更新時間：2025年07月23日 11:01:33 作者：振宇i
這篇文章主要介紹了Java推送釘釘應(yīng)用消息實現(xiàn)的相關(guān)資料,包括創(chuàng)建應(yīng)用、獲取憑證、申請接口權(quán)限及調(diào)用接口流程,并提供Maven依賴配置,文中通過代碼介紹的非常詳細,需要的朋友可以參考下
前言：
本文的目的是通過手機號獲取釘釘成員的userid，實現(xiàn)釘釘應(yīng)用的消息推送。
一、創(chuàng)建釘釘應(yīng)用
登錄釘釘開放平臺
二、應(yīng)用相關(guān)憑證
需要獲取
Client ID (原 AppKey 和 SuiteKey)
Client Secret (原 AppSecret 和 SuiteSecret)
App ID
原企業(yè)內(nèi)部應(yīng)用AgentId
三、申請釘釘接口權(quán)限
需要先申請對應(yīng)的接口權(quán)限才能調(diào)用接口。
但是釘釘?shù)慕涌谔嗔?，一時半會也找不到對應(yīng)的接口，推薦直接全勾選。
四、釘釘官方接口
1、獲取token
請求方式：GET
參數(shù)：appKey，appSecret，reqMethod
url：https://oapi.dingtalk.com/gettoken
2、根據(jù)手機號獲取用戶ID
參數(shù)：access_token，mobileNum
url：https://oapi.dingtalk.com/topapi/v2/user/getbymobile
3、發(fā)送通知
參數(shù)：access_token，msgType，content，userId
url：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2
五、工具類
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
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.request.OapiV2UserGetbymobileRequest;
import com.dingtalk.api.response.OapiGettokenResponse;
import com.dingtalk.api.response.OapiMessageCorpconversationAsyncsendV2Response;
import com.dingtalk.api.response.OapiV2UserGetbymobileResponse;
import com.taobao.api.ApiException;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
@Slf4j
@Component
public class DingTalkUtil {
private static final String GET_TOKEN_URL = "https://oapi.dingtalk.com/gettoken";
private static final String GET_BY_MOBILE = "https://oapi.dingtalk.com/topapi/v2/user/getbymobile";
private static final String ASYNC_SEND_V2_URL = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2";
private static final String DEFAULT_APP_KEY = "XXX";
private static final String DEFAULT_APP_SECRET = "XXXX";
private static final Long DEFAULT_AGENT_ID = 123L;
private static final String DEFAULT_REQUEST_METHOD = "GET";
private String appKey;
private String appSecret;
private Long agentId;
private String reqMethod;
public DingTalkUtil() {
this(DEFAULT_APP_KEY, DEFAULT_APP_SECRET, DEFAULT_AGENT_ID, DEFAULT_REQUEST_METHOD);
}
public DingTalkUtil(String appKey, String appSecret, Long agentId, String reqMethod) {
this.appKey = (appKey != null && !appKey.isEmpty()) ? appKey : DEFAULT_APP_KEY;
this.appSecret = (appSecret != null && !appSecret.isEmpty()) ? appSecret : DEFAULT_APP_SECRET;
this.agentId = (agentId != null) ? agentId : DEFAULT_AGENT_ID;
this.reqMethod = (reqMethod != null && !reqMethod.isEmpty()) ? reqMethod : DEFAULT_REQUEST_METHOD;
}
// 獲取AccessToken
public String getTokenResponse() throws ApiException {
DingTalkClient client = new DefaultDingTalkClient(GET_TOKEN_URL);
OapiGettokenRequest req = new OapiGettokenRequest();
req.setAppkey(appKey);
req.setAppsecret(appSecret);
req.setHttpMethod(reqMethod);
OapiGettokenResponse rsp = client.execute(req);
return rsp.getAccessToken();
}
// 根據(jù)手機號獲取UserId
public String getUserIdByMobile(String accessToken, String mobileNum) throws ApiException {
DingTalkClient client = new DefaultDingTalkClient(GET_BY_MOBILE);
OapiV2UserGetbymobileRequest req = new OapiV2UserGetbymobileRequest();
req.setMobile(mobileNum);
OapiV2UserGetbymobileResponse rsp = client.execute(req, accessToken);
JSONObject jsonObject = JSON.parseObject(rsp.getBody());
JSONObject result = jsonObject.getJSONObject("result");
String userid = result.getString("userid");
return userid;
}
// 發(fā)送工作通知消息
public boolean sendWorkNotice(String accessToken, String msgType, String content, List<String> userIds) throws ApiException {
DingTalkClient client = new DefaultDingTalkClient(ASYNC_SEND_V2_URL);
OapiMessageCorpconversationAsyncsendV2Request req = new OapiMessageCorpconversationAsyncsendV2Request();
req.setAgentId(agentId);
req.setUseridList(String.join(",", userIds));
OapiMessageCorpconversationAsyncsendV2Request.Msg msg = new OapiMessageCorpconversationAsyncsendV2Request.Msg();
msg.setMsgtype(msgType);
OapiMessageCorpconversationAsyncsendV2Request.Text text = new OapiMessageCorpconversationAsyncsendV2Request.Text();
text.setContent(content);
msg.setText(text);
req.setMsg(msg);
OapiMessageCorpconversationAsyncsendV2Response rsp = client.execute(req, accessToken);
return rsp.isSuccess();
}
public static class Builder {
private String msgType = "text";
private String content;
private List<String> mobiles = new ArrayList<>();
private List<String> userIds = new ArrayList<>();
public Builder setMsgType(String msgType) {
this.msgType = msgType;
return this;
}
public Builder setContent(String content) {
this.content = content;
return this;
}
public Builder addUserId(String userId) {
this.mobiles.add(userId);
return this;
}
public Builder addUserIds(List<String> userIds) {
this.mobiles = userIds;
return this;
}
public boolean send(DingTalkUtil utils) throws ApiException {
// 獲取 accessToken
String accessToken = utils.getTokenResponse();
// 根據(jù)手機獲取userId
for (String mobileNum : mobiles) {
String userId = utils.getUserIdByMobile(accessToken, mobileNum);
userIds.add(userId);
}
// 調(diào)用 sendWorkNotice 發(fā)送消息
return utils.sendWorkNotice(accessToken, msgType, content, userIds);
}
}
// 封裝的發(fā)送釘釘通知的方法
public boolean sendDingTalkNotification(List<String> phoneList, String message) throws ApiException {
DingTalkUtil dingTalkUtil = new DingTalkUtil();
return new DingTalkUtil.Builder().setMsgType("text")
.setContent(message)
.addUserIds(phoneList)
.send(dingTalkUtil);
}
// 內(nèi)部測試
public static void main(String[] args) throws ApiException {
DingTalkUtil dingTalkUtil = new DingTalkUtil();
List<String> phoneList = Arrays.asList("phoneNum");
String message = "your message";
boolean result = dingTalkUtil.sendDingTalkNotification(phoneList, message);
System.out.println("消息發(fā)送結(jié)果: " + result);
}
}
六、MAVEN引入
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>dingtalk</artifactId>
<version>1.5.24</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>alibaba-dingtalk-service-sdk</artifactId>
<version>2.0.0</version>
</dependency>總結(jié)
到此這篇關(guān)于Java推送釘釘應(yīng)用消息實現(xiàn)的文章就介紹到這了,更多相關(guān)Java推送釘釘應(yīng)用消息內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Java String 類的 indexOf() 方法返回指定字符串中指定字符或字符串第一次出現(xiàn)的位置,這篇文章主要介紹了Java中indexOf函數(shù)詳解,需要的朋友可以參考下2024-01-01
MyBatis是支持普通SQL查詢，存儲過程和高級映射的優(yōu)秀持久層框架。mybatis的學(xué)習(xí)是程序員的必修課。今天小編通過分享本教程幫助大家快速入門mybatis，對mybatis入門知識感興趣的朋友參考下吧2016-11-11
新手入門Jvm-- JVM對象創(chuàng)建與內(nèi)存分配機制
JVM是Java Virtual Machine（Java虛擬機）的縮寫，JVM是一種用于計算設(shè)備的規(guī)范，它是一個虛構(gòu)出來的計算機，是通過在實際的計算機上仿真模擬各種計算機功能來實現(xiàn)的2021-06-06
Servlet+JavaBean+JSP打造Java Web注冊與登錄功能
比作MVC的話,控制器部分采用Servlet來實現(xiàn)，模型部分采用JavaBean來實現(xiàn),而大部分的視圖采用Jsp頁面來實現(xiàn),接下來我們就來詳細看看如何用Servlet+JavaBean+JSP打造Java Web注冊與登錄功能2016-05-05
這篇文章主要介紹了Java設(shè)計模式之單例模式,以實例形式較為詳細的分析了單例模式的概念、定義及簡單實現(xiàn)技巧,需要的朋友可以參考下2015-11-11
IDEA關(guān)于.properties資源文件的編碼調(diào)整問題
這篇文章主要介紹了IDEA關(guān)于.properties資源文件的編碼調(diào)整問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-06-06
java實現(xiàn)MapReduce對文件進行切分的示例代碼
本文主要介紹了java實現(xiàn)MapReduce對文件進行切分的示例代碼，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-01-01
Spring AOP注解失效原因及解決方法,詳細解析Spring動態(tài)代理機制,包括JDK動態(tài)代理和CGLIB動態(tài)代理,以及AOP注解在方法調(diào)用中的應(yīng)用問題和解決方案2026-06-06
這篇文章主要介紹了SpringBoot之跨域過濾器配置允許跨域訪問方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-07-07
這篇文章主要介紹了java方法通用返回結(jié)果集封裝操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-08-08