Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機器人的實現(xiàn)
更新時間：2021年11月09日 15:50:47 作者：福祿網(wǎng)絡研發(fā)團
釘釘?shù)某霈F(xiàn)為企業(yè)節(jié)約了大量人力成本，其中也開放了大量的外部api接口方便企業(yè)使用。本文主要介紹了Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機器人的實現(xiàn)，感興趣的可以了解一下
前言：
釘釘?shù)某霈F(xiàn)為企業(yè)節(jié)約了大量人力成本，其中也開放了大量的外部api接口方便企業(yè)使用。今天我們就來說說企業(yè)自研釘釘機器人的使用方法。請盡情食用
創(chuàng)建釘釘機器人：
如何創(chuàng)建釘釘機器人
登錄釘釘開發(fā)者后臺，依次選擇應用開發(fā) > 企業(yè)內(nèi)部開發(fā) > 機器人，點擊創(chuàng)建應用。
這個時候，企業(yè)自己的機器人就創(chuàng)建好了。
如何調(diào)用機器人api
1、添加接口調(diào)用權(quán)限。應用創(chuàng)建后默認只開放登錄和消息通知接口的調(diào)用權(quán)限，您需要根據(jù)開發(fā)需要，添加對應的接口使用權(quán)限。
2、獲取應用的access_token。access_token相當于是身份憑證。調(diào)用接口時，通過access_token來鑒權(quán)調(diào)用者身份。
下載官網(wǎng)的sdk包：
https://developers.dingtalk.com/document/app/download-the-server-side-sdk
機器人回調(diào)所需要使用的apk
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>dingtalk</artifactId>
<version>1.1.84</version>
</dependency>
支持的消息格式
text類型
{
"at": {
"atMobiles": [
"180xxxxxx"
],
"atUserIds": [
"user123"
],
"isAtAll": false
},
"text": {
"content": "我就是我, @180xxxxxx 是不一樣的煙火"
},
"msgtype": "text"
}
markdown類型
{
"msgtype": "markdown",
"markdown": {
"title":"杭州天氣",
"text": "#### 杭州天氣 @150XXXXXXXX \n> 9度，西北風1級，空氣良89，相對溫度73%\n> \n> ###### 10點20分發(fā)布 [天氣](https://www.dingalk.com) \n"
},
"at": {
"atMobiles": [
"150XXXXXXXX"
],
"atUserIds": [
"user123"
],
"isAtAll": false
}
}
整體跳轉(zhuǎn)actionCard類型
{
"msgtype": "actionCard",
"actionCard": {
"title": "打造一間咖啡廳",
"text": " \n #### 喬布斯 20 年前想打造的蘋果咖啡廳 \n\n Apple Store 的設計正從原來滿滿的科技感走向生活化，而其生活化的走向其實可以追溯到 20 年前蘋果一個建立咖啡館的計劃",
"singleTitle" : "閱讀全文",
"singleURL" : "https://www.dingtalk.com/"
}
}
feedCard類型
{
"msgtype": "feedCard",
"feedCard": {
"links": [
{
"title": "時代的火車向前開1",
"messageURL": "https://www.dingtalk.com/",
"picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
},
{
"title": "時代的火車向前開2",
"messageURL": "https://www.dingtalk.com/",
"picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
}
]
}
}
使用釘釘機器人推送消息
@PostMapping(value = "/robots")
public String helloRobots(@RequestBody RobotResponse robotResponse
) throws Exception {
String[] content = robotResponse.getText().getContent().split(" ");
if (content.length == 2) {
return dingtalkRobotTypeService.findByQuestion(content[0], content[1]);
} else if (content.length == 1) {
if (content[0].equals("公告")) {
return RobotReplyService.feedCard(Arrays.asList(
new RobotFeedCard.FeedCardBean.LinksBean("時代的火車向前開1", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
new RobotFeedCard.FeedCardBean.LinksBean("時代的火車向前開2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
new RobotFeedCard.FeedCardBean.LinksBean("時代的火車向前開2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
new RobotFeedCard.FeedCardBean.LinksBean("時代的火車向前開2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png")));
} else if (content[0].equals("活動")) {
return RobotReplyService.aloneActionCard("你想?yún)⒓舆@次活動", " \n>你就說你想不想?yún)⒓踊顒影蒤n>", 1, Arrays.asList(
new RobotAloneActionCard.ActionCardBean.BtnsBean("參加", "fsdfsdf"), new RobotAloneActionCard.ActionCardBean.BtnsBean("不想?yún)⒓?, "不想?yún)⒓?)));
} else if (content[0].equals("測試")) {
return RobotReplyService.markdown(null, "啦啦啦啦", "[啦啦啦啦](啦啦啦啦啦)");
}
return dingtalkRobotService.findByQuestion(content[0]);
} else {
return RobotReplyService.text(null, "不知道你想說啥");
}
}
機器人交互式卡片設計：
如何發(fā)送交互式卡片
配置消息模板
1、登錄釘釘OA管理后臺。
2、進入釘釘可交互卡片搭建平臺，在搭建平臺上則可以看到當前組織內(nèi)所創(chuàng)建的所有互動消息模板。
3、單擊右上角的新增模板，然后輸入模板名稱，選擇卡片類型，最后單擊確認完成模板創(chuàng)建。
修改機器人交互卡片回調(diào)地址
/**
* 注冊回調(diào)地址
*
* @throws BusinessException
* @throws ApiException
*/
public static OapiImChatScencegroupInteractivecardCallbackRegisterResponse registerURL(String url) throws Exception {
DingTalkClient client = new DefaultDingTalkClient(O_API + "top/im/chat/scencegroup/interactivecard/callback/register");
RobotCallBack req = new RobotCallBack();
req.setCallbackUrl(url + "/robot/callback");
req.setApiSecret("bgRtxxxx");
req.setForceUpdate("true");
OapiImChatScencegroupInteractivecardCallbackRegisterResponse rsp = client.execute(req, AccessTokenUtil.getAccessToken());
return rsp;
}
發(fā)送機器人交互消息
/**
* 機器人推送互動卡片
*
* @param cardId
* @param phone
* @param cardData
* @throws Exception
*/
public static void sendCardMsg(String cardId, String phone, Map<String, String> cardData) throws Exception {
String userId = getUserIdByMobile(phone);
com.aliyun.dingtalkim_1_0.Client client = new com.aliyun.dingtalkim_1_0.Client(AccessTokenUtil.getHttpConfig());
SendInteractiveCardHeaders sendInteractiveCardHeaders = new SendInteractiveCardHeaders();
sendInteractiveCardHeaders.xAcsDingtalkAccessToken = AccessTokenUtil.getAccessToken();
SendInteractiveCardRequest sendInteractiveCardRequest = new SendInteractiveCardRequest()
.setCardTemplateId(cardId)
.setReceiverUserIdList(Collections.singletonList(userId))
.setOutTrackId(IdUtil.simpleUUID())
.setCardData(new SendInteractiveCardRequest.SendInteractiveCardRequestCardData().setCardParamMap(cardData))
.setOpenConversationId("cidJeCuP2boERqlkwy0rv4qHg")
.setConversationType(1);
try {
client.sendInteractiveCardWithOptions(sendInteractiveCardRequest, sendInteractiveCardHeaders, new RuntimeOptions());
} catch (TeaException err) {
log.error(JSON.toJSONString(err.getData()));
} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);
log.error(JSON.toJSONString(err.getData()));
}
}
接受交互卡片回調(diào)消息
/**
* 釘釘機器人觸發(fā)回調(diào)事件
*
* @param tractId
* @param cardData
* @throws Exception
*/
public static void updateCardMsg(String tractId, Map<String, String> cardData) throws Exception {
com.aliyun.dingtalkim_1_0.Client client = new com.aliyun.dingtalkim_1_0.Client(AccessTokenUtil.getHttpConfig());
UpdateInteractiveCardHeaders updateInteractiveCardHeaders = new UpdateInteractiveCardHeaders();
updateInteractiveCardHeaders.xAcsDingtalkAccessToken = AccessTokenUtil.getAccessToken();
UpdateInteractiveCardRequest updateInteractiveCardRequest = new UpdateInteractiveCardRequest()
.setOutTrackId(tractId)
.setCardData(new UpdateInteractiveCardRequest.UpdateInteractiveCardRequestCardData()
.setCardParamMap(cardData))
.setUserIdType(1);
try {
UpdateInteractiveCardResponse updateInteractiveCardResponse = client.updateInteractiveCardWithOptions(updateInteractiveCardRequest, updateInteractiveCardHeaders, new RuntimeOptions());
log.info(JSONObject.toJSONString(updateInteractiveCardResponse));
} catch (TeaException err) {
log.error(JSON.toJSONString(err.getData()));
} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);
log.error(JSON.toJSONString(err.getData()));
}
}
這個時候 我們就可以按照自己的需求來開發(fā)相應業(yè)務邏輯了
文章參考：釘釘開發(fā)展中心
到此這篇關于Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機器人的實現(xiàn)的文章就介紹到這了,更多相關Java 釘釘創(chuàng)建內(nèi)部機器人內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了Spring中利用配置文件和@value注入屬性值代碼詳解，代碼中注釋比較詳細，具有一定參考價值，需要的朋友可以了解下。2017-11-11
這篇文章主要介紹了在eclipse中如何修改svn的用戶名和密碼的方法，在eclipse中經(jīng)常用svn進行代碼版本控制，提交或更新代碼的時候需要我們輸入用戶名和密碼。對此感興趣的話可以來了解一下2020-07-07
Java 實戰(zhàn)練手項目之醫(yī)院預約掛號系統(tǒng)的實現(xiàn)流程
讀萬卷書不如行萬里路，只學書上的理論是遠遠不夠的，只有在實戰(zhàn)中才能獲得能力的提升，本篇文章手把手帶你用java+SpringBoot+Maven+Vue+mysql實現(xiàn)一個醫(yī)院預約掛號系統(tǒng),大家可以在過程中查缺補漏，提升水平2021-11-11
這篇文章主要介紹了idea如何配置javafxsdk,本文通過圖文并茂的形式給大家介紹的非常詳細，對大家的學習火鍋工作具有一定的參考借鑒價值，需要的朋友可以參考下2020-11-11
這篇文章主要介紹了Spring整合junit的配置過程圖解,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-02-02
這篇文章主要介紹了springboot跨域CORS處理代碼解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-12-12
這篇文章主要為大家介紹了java9版本特性資源自動關閉的語法增強的詳細使用說明，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步2022-03-03
工作中，我們經(jīng)常使用線程池，但是你真的了解線程池的原理嗎？同時，線程池工作原理和底層實現(xiàn)原理也是面試經(jīng)常問的考題，所以，今天我們一起聊聊線程池的原理吧2022-12-12
實例詳解Spring Boot實戰(zhàn)之Redis緩存登錄驗證碼
本章簡單介紹redis的配置及使用方法，本文示例代碼在前面代碼的基礎上進行修改添加，實現(xiàn)了使用redis進行緩存驗證碼，以及校驗驗證碼的過程。感興趣的的朋友一起看看吧2017-08-08
在本篇文章里小編給大家整理了一篇關于java自定義jar包讓jmeter使用的方法以及實例代碼，需要的朋友們參考下。2019-10-10