Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機(jī)器人的實(shí)現(xiàn)

更新時(shí)間：2021年11月09日 15:50:47 作者：福祿網(wǎng)絡(luò)研發(fā)團(tuán)

釘釘?shù)某霈F(xiàn)為企業(yè)節(jié)約了大量人力成本，其中也開(kāi)放了大量的外部api接口方便企業(yè)使用。本文主要介紹了Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機(jī)器人的實(shí)現(xiàn)，感興趣的可以了解一下

前言：

釘釘?shù)某霈F(xiàn)為企業(yè)節(jié)約了大量人力成本，其中也開(kāi)放了大量的外部api接口方便企業(yè)使用。今天我們就來(lái)說(shuō)說(shuō)企業(yè)自研釘釘機(jī)器人的使用方法。請(qǐng)盡情食用

創(chuàng)建釘釘機(jī)器人：

如何創(chuàng)建釘釘機(jī)器人

登錄釘釘開(kāi)發(fā)者后臺(tái)，依次選擇應(yīng)用開(kāi)發(fā) > 企業(yè)內(nèi)部開(kāi)發(fā) > 機(jī)器人，點(diǎn)擊創(chuàng)建應(yīng)用。

這個(gè)時(shí)候，企業(yè)自己的機(jī)器人就創(chuàng)建好了。

如何調(diào)用機(jī)器人api

1、添加接口調(diào)用權(quán)限。應(yīng)用創(chuàng)建后默認(rèn)只開(kāi)放登錄和消息通知接口的調(diào)用權(quán)限，您需要根據(jù)開(kāi)發(fā)需要，添加對(duì)應(yīng)的接口使用權(quán)限。

2、獲取應(yīng)用的access_token。access_token相當(dāng)于是身份憑證。調(diào)用接口時(shí)，通過(guò)access_token來(lái)鑒權(quán)調(diào)用者身份。

下載官網(wǎng)的sdk包：
https://developers.dingtalk.com/document/app/download-the-server-side-sdk
機(jī)器人回調(diào)所需要使用的apk

<dependency>
    <groupId>com.aliyun</groupId>
        <artifactId>dingtalk</artifactId>
    <version>1.1.84</version>
</dependency>

支持的消息格式

text類(lèi)型

{
    "at": {
        "atMobiles": [
            "180xxxxxx"
        ],
        "atUserIds": [
            "user123"
        ],
        "isAtAll": false
    },
    "text": {
        "content": "我就是我, @180xxxxxx 是不一樣的煙火"
    },
    "msgtype": "text"
}

markdown類(lèi)型

{
     "msgtype": "markdown",
     "markdown": {
         "title":"杭州天氣",
         "text": "#### 杭州天氣 @150XXXXXXXX \n> 9度，西北風(fēng)1級(jí)，空氣良89，相對(duì)溫度73%\n> ![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png)\n> ###### 10點(diǎn)20分發(fā)布 [天氣](https://www.dingalk.com) \n"
     },
      "at": {
          "atMobiles": [
              "150XXXXXXXX"
          ],
          "atUserIds": [
              "user123"
          ],
          "isAtAll": false
      }
 }

整體跳轉(zhuǎn)actionCard類(lèi)型

{
    "msgtype": "actionCard",
    "actionCard": {
        "title": "打造一間咖啡廳", 
        "text": "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \n #### 喬布斯 20 年前想打造的蘋(píng)果咖啡廳 \n\n Apple Store 的設(shè)計(jì)正從原來(lái)滿(mǎn)滿(mǎn)的科技感走向生活化，而其生活化的走向其實(shí)可以追溯到 20 年前蘋(píng)果一個(gè)建立咖啡館的計(jì)劃",
        "singleTitle" : "閱讀全文",
        "singleURL" : "https://www.dingtalk.com/"
    }
}

feedCard類(lèi)型

{
    "msgtype": "feedCard",
    "feedCard": {
        "links": [
            {
                "title": "時(shí)代的火車(chē)向前開(kāi)1", 
                "messageURL": "https://www.dingtalk.com/", 
                "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
            },
            {
                "title": "時(shí)代的火車(chē)向前開(kāi)2", 
                "messageURL": "https://www.dingtalk.com/", 
                "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
            }
        ]
    }
}

使用釘釘機(jī)器人推送消息

@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("時(shí)代的火車(chē)向前開(kāi)1", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
                        new RobotFeedCard.FeedCardBean.LinksBean("時(shí)代的火車(chē)向前開(kāi)2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
                        new RobotFeedCard.FeedCardBean.LinksBean("時(shí)代的火車(chē)向前開(kāi)2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"),
                        new RobotFeedCard.FeedCardBean.LinksBean("時(shí)代的火車(chē)向前開(kāi)2", "https://www.dingtalk.com/", "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png")));
            } else if (content[0].equals("活動(dòng)")) {
                return RobotReplyService.aloneActionCard("你想?yún)⒓舆@次活動(dòng)", "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \n>你就說(shuō)你想不想?yún)⒓踊顒?dòng)吧\n>", 1, Arrays.asList(
                        new RobotAloneActionCard.ActionCardBean.BtnsBean("參加", "fsdfsdf"), new RobotAloneActionCard.ActionCardBean.BtnsBean("不想?yún)⒓?, "不想?yún)⒓?)));
            } else if (content[0].equals("測(cè)試")) {
                return RobotReplyService.markdown(null, "啦啦啦啦", "[啦啦啦啦](啦啦啦啦啦)");

            }
            return dingtalkRobotService.findByQuestion(content[0]);
        } else {
            return RobotReplyService.text(null, "不知道你想說(shuō)啥");
        }
    }

機(jī)器人交互式卡片設(shè)計(jì)：

如何發(fā)送交互式卡片

配置消息模板

1、登錄釘釘OA管理后臺(tái)。

2、進(jìn)入釘釘可交互卡片搭建平臺(tái)，在搭建平臺(tái)上則可以看到當(dāng)前組織內(nèi)所創(chuàng)建的所有互動(dòng)消息模板。

3、單擊右上角的新增模板，然后輸入模板名稱(chēng)，選擇卡片類(lèi)型，最后單擊確認(rèn)完成模板創(chuàng)建。

修改機(jī)器人交互卡片回調(diào)地址

/**
     * 注冊(cè)回調(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ā)送機(jī)器人交互消息

/**
     * 機(jī)器人推送互動(dòng)卡片
     *
     * @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)消息

 /**
     * 釘釘機(jī)器人觸發(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()));
        }
    }

這個(gè)時(shí)候我們就可以按照自己的需求來(lái)開(kāi)發(fā)相應(yīng)業(yè)務(wù)邏輯了

文章參考：釘釘開(kāi)發(fā)展中心

到此這篇關(guān)于Java使用釘釘創(chuàng)建企業(yè)內(nèi)部機(jī)器人的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)Java 釘釘創(chuàng)建內(nèi)部機(jī)器人內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: