Java使用钉钉创建企业内部机器人的实现
更新时间：2021年11月09日 15:50:47 作者：福禄网络研发团
钉钉的出现为企业节约了大量人力成本，其中也开放了大量的外部api接口方便企业使用。本文主要介绍了Java使用钉钉创建企业内部机器人的实现，感兴趣的可以了解一下
前言：
钉钉的出现为企业节约了大量人力成本，其中也开放了大量的外部api接口方便企业使用。今天我们就来说说企业自研钉钉机器人的使用方法。请尽情食用
创建钉钉机器人：
如何创建钉钉机器人
登录钉钉开发者后台，依次选择应用开发 > 企业内部开发 > 机器人，点击创建应用。
这个时候，企业自己的机器人就创建好了。
如何调用机器人api
1、添加接口调用权限。应用创建后默认只开放登录和消息通知接口的调用权限，您需要根据开发需要，添加对应的接口使用权限。
2、获取应用的access_token。access_token相当于是身份凭证。调用接口时，通过access_token来鉴权调用者身份。
下载官网的sdk包：
https://developers.dingtalk.com/document/app/download-the-server-side-sdk
机器人回调所需要使用的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分发布 [天气](https://www.dingalk.com) \n"
},
"at": {
"atMobiles": [
"150XXXXXXXX"
],
"atUserIds": [
"user123"
],
"isAtAll": false
}
}
整体跳转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("你想参加这次活动", " \n>你就说你想不想参加活动吧\n>", 1, Arrays.asList(
new RobotAloneActionCard.ActionCardBean.BtnsBean("参加", "fsdfsdf"), new RobotAloneActionCard.ActionCardBean.BtnsBean("不想参加", "不想参加")));
} else if (content[0].equals("测试")) {
return RobotReplyService.markdown(null, "啦啦啦啦", "[啦啦啦啦](啦啦啦啦啦)");
}
return dingtalkRobotService.findByQuestion(content[0]);
} else {
return RobotReplyService.text(null, "不知道你想说啥");
}
}
机器人交互式卡片设计：
如何发送交互式卡片
配置消息模板
1、登录钉钉OA管理后台。
2、进入钉钉可交互卡片搭建平台，在搭建平台上则可以看到当前组织内所创建的所有互动消息模板。
3、单击右上角的新增模板，然后输入模板名称，选择卡片类型，最后单击确认完成模板创建。
修改机器人交互卡片回调地址
/**
* 注册回调地址
*
* @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;
}
发送机器人交互消息
/**
* 机器人推送互动卡片
*
* @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()));
}
}
接受交互卡片回调消息
/**
* 钉钉机器人触发回调事件
*
* @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()));
}
}
这个时候 我们就可以按照自己的需求来开发相应业务逻辑了
文章参考：钉钉开发展中心
到此这篇关于Java使用钉钉创建企业内部机器人的实现的文章就介绍到这了,更多相关Java 钉钉创建内部机器人内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
java 与testng利用XML做数据源的数据驱动示例详解
这篇文章主要介绍了java 与testng利用XML做数据源的数据驱动示例详解的相关资料,需要的朋友可以参考下2017-01-01
下面小编就为大家带来一篇java中利用反射调用另一类的private方法的简单实例。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2016-06-06
这篇文章主要介绍了Java设计模式模板方法(Template)原理解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2019-11-11
这篇文章主要给大家介绍了关于Spring Boot启动banner定制的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧。2018-03-03
Spring Cloud Ribbon 负载均衡使用策略示例详解
Spring Cloud Ribbon 是基于Netflix Ribbon 实现的一套客户端负载均衡工具，Ribbon客户端组件提供了一系列的完善的配置，如超时，重试等，这篇文章主要介绍了Spring Cloud Ribbon 负载均衡使用策略示例详解,需要的朋友可以参考下2023-03-03
这篇文章主要介绍了Java 多个文件生成zip包、下载zip包，包括文件上传，文件下载，多个文件打成zip包的操作代码，本文给大家介绍的非常详细,需要的朋友可以参考下2024-01-01
java SelectableChannel的使实例用法讲解
在本篇文章里小编给大家整理的是一篇关于java SelectableChannel的使实例用法讲解内容，有兴趣的朋友们可以学习下。2021-03-03
这篇文章主要给大家介绍了关于Java线程池配置的一些常见误区，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-01-01
这篇文章主要介绍了SpringCloud Feign高级配置，feign是netflix提供的服务间基于http的rpc调用框架，在spring cloud得到广泛应用2022-09-09
这篇文章主要介绍了spring实现bean对象创建代码详解，具有一定借鉴价值,需要的朋友可以参考下2017-12-12
最新评论