目录

• 玩转钉钉机器人
  • 创建钉钉机器人：
    • 如何创建钉钉机器人
    • 如何调用机器人api
    • 支持的消息格式
      • text类型
      • markdown类型
      • 整体跳转actionCard类型
      • feedCard类型
    • 使用钉钉机器人推送消息
  • 机器人交互式卡片设计：
    • 如何发送交互式卡片
      • 配置消息模板
      • 修改机器人交互卡片回调地址
      • 发送机器人交互消息
      • 接受交互卡片回调消息

玩转钉钉机器人 前言：
钉钉的出现为企业节约了大量人力成本，其中也开放了大量的外部api接口方便企业使用。今天我们就来说说企业自研钉钉机器人的使用方法。请尽情食用
创建钉钉机器人： 如何创建钉钉机器人
【使用钉钉创建企业内部机器人】登录钉钉开发者后台，依次选择应用开发 > 企业内部开发 > 机器人，点击创建应用。

文章图片


文章图片

这个时候，企业自己的机器人就创建好了。
如何调用机器人api
1、添加接口调用权限。应用创建后默认只开放登录和消息通知接口的调用权限，您需要根据开发需要，添加对应的接口使用权限。
2、获取应用的access_token。access_token相当于是身份凭证。调用接口时，通过access_token来鉴权调用者身份。

文章图片

下载官网的sdk包： https://developers.dingtalk.com/document/app/download-the-server-side-sdk 机器人回调所需要使用的apk com.aliyun dingtalk 1.1.84

支持的消息格式
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> ![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png)\n> ###### 10点20分发布 [天气](https://www.dingalk.com) \n" }, "at": { "atMobiles": [ "150XXXXXXXX" ], "atUserIds": [ "user123" ], "isAtAll": false } }

文章图片

整体跳转actionCard类型

{ "msgtype": "actionCard", "actionCard": { "title": "打造一间咖啡厅", "text": "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \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 = "https://www.it610.com/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("你想参加这次活动", "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \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 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 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())); } }

文章图片

这个时候 我们就可以按照自己的需求来开发相应业务逻辑了
文章参考：钉钉开发展中心
福禄·研发中心 福小雄

推荐阅读

• 

  什么是对公负债业务
• 

  做生鲜电商需要办什么营业执照
• 

  威能壁挂炉代码百度如何解决
• 

  拍鸟用什么相机好
• 

  荒野行动物品怎么拆分 如何分开扔掉道具
• 

  黄雅琼个人资料介绍 黄雅琼个人资料介绍
• 

  怎样做稻谷酒
• 

  天山雪菊哪里买 天山雪菊多少钱才能买到
• 

  鹅蛋和什么东西不能吃
• 

  电池容量|骁龙870基本“零差评”，这四款价格两千左右，入手用三年
• 

  mongodb数据库迁移到另一台服务器 mongodb 迁移数据
• 

  紫叶草怎么种植 紫叶草怎么养
• 

  补办车牌号一般几天可以下来
• 

  3m汽车膜分几个档次 汽车贴膜什么牌子好
• 

  前端|实习生 Git 不熟练，还没脸去问是种什么体验
• 

  开发转数据分析,数据分析好还是大数据开发好
• 

  熊童子多肉服盆的注意事项有哪些 多肉熊童子用什么盆好看
• 

  地板出汗怎么办 地板如何去汗，地板如何去汗渍
• 

  冠状沟白色污垢是什么
• 

  mysql中的锁指的是什么 mysql导致锁的原因

• 由浅入深理解AOP
• 【译】20个更有效地使用谷歌搜索的技巧
• mybatisplus如何在xml的连表查询中使用queryWrapper
• MybatisPlus|MybatisPlus LambdaQueryWrapper使用int默认值的坑及解决
• MybatisPlus使用queryWrapper如何实现复杂查询
• django-前后端交互
• iOS中的Block
• Linux下面如何查看tomcat已经使用多少线程
• 使用composer自动加载类文件
• android|android studio中ndk的使用