文章导航

钉钉小程序生态1—区分企业内部应用、第三方企业应用、第三方个人应用
钉钉小程序生态2—区分小程序和H5微应用
钉钉小程序生态3—钉钉扫码登录PC端网站
钉钉小程序生态4—钉钉小程序三方企业应用事件与回调
钉钉小程序生态5—钉钉群机器人消息通知和钉钉工作通知

前言

在消息通知这块,钉钉可谓是玩出了花,比如工作通知、群机器人通知,还有那万恶的Ding一下。钉钉的通知不仅花样多,而且大部分渠道都支持自定义,也即可以自定义设置发送时间、发送内容,并且还支持多种样式的消息如文本、卡片、Markdown等。
这篇文章我主要介绍一下常用的两类:钉钉群机器人通知和钉钉工作通知。

钉钉群机器人通知效果图

钉钉工作通知效果图

具体的区别和对比我就不写了,机器人统治发在群里,工作通知发在工作通知栏目。简单来说钉钉群机器人消息通知发的消息所有人都可以看到,钉钉工作通知只有选择到的人才可以看到,所以钉钉群机器人消息通知适合发公告通知所有人,钉钉工作通知适合发工作安排通知到具体人,不过具体怎么用还得看业务的需要。

钉钉群机器人通知实现

官方文档链接

自定义机器人接入:https://open.dingtalk.com/document/robots/custom-robot-access

自定义机器人安全设置:https://open.dingtalk.com/document/robots/customize-robot-security-settings

配置流程

1. 选择需要添加机器人的群聊,然后依次单击群设置 > 机器人。

2. 点击添加机器人,然后找到自定义机器人

3. 输入配置,安全设置需要注意一下

由于创建自定义机器人必须选择安全设置,这里注意不要乱输,如果明白安全设置是啥最好,如果不懂建议选择加签的方式,然后看一下说明文档,不然测试的时候有可能会发送不成功。

4. 点击完成,会生成Webhook

开发机器人

1. 保存好安全设置的token和Webhook

2. 导入maven旧版依赖

    <!-- 使用旧版钉钉开放api --><dependency><groupId>com.aliyun</groupId><artifactId>alibaba-dingtalk-service-sdk</artifactId><version>2.0.0</version></dependency></dependencies>

3. 编写测试类

package com.example.dingtalkmsg.service;import java.net.URLEncoder;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;import com.dingtalk.api.DefaultDingTalkClient;
import com.dingtalk.api.DingTalkClient;
import com.dingtalk.api.request.OapiRobotSendRequest;
import com.dingtalk.api.request.OapiRobotSendRequest.Links;
import com.dingtalk.api.response.OapiRobotSendResponse;
import org.apache.tomcat.util.codec.binary.Base64;public class DingTalkRobotSendService {public static void main(String[] args) throws Exception {//安全设置加签Long timestamp = System.currentTimeMillis();String secret = "xxx ";String stringToSign = timestamp + "\n" + secret;Mac mac = Mac.getInstance("HmacSHA256");mac.init(new SecretKeySpec(secret.getBytes("UTF-8"), "HmacSHA256"));byte[] signData = mac.doFinal(stringToSign.getBytes("UTF-8"));String sign = URLEncoder.encode(new String(Base64.encodeBase64(signData)), "UTF-8");//构建消息发送ClientDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk"+ ".com/robot/send?access_token=xxx"+ "&timestamp="+ timestamp + "&sign=" + sign);//创建发送请求体OapiRobotSendRequest request = new OapiRobotSendRequest();request.setMsgtype("text");//文本消息OapiRobotSendRequest.Text text = new OapiRobotSendRequest.Text();text.setContent("测试文本消息");request.setText(text);OapiRobotSendRequest.At at = new OapiRobotSendRequest.At();at.setAtMobiles(Arrays.asList("xxxxx"));// isAtAll类型如果不为Boolean,请升级至最新SDK//at.setIsAtAll(true);//at.setAtUserIds(Arrays.asList("109929","32099"));request.setMsgtype("link");OapiRobotSendRequest.Link link = new OapiRobotSendRequest.Link();link.setMessageUrl("https://www.dingtalk.com/");link.setPicUrl("");link.setTitle("时代的火车向前开");link.setText("这个即将发布的新版本,创始人xx称它为红树林。而在此之前,每当面临重大升级,产品经理们都会取一个应景的代号,这一次,为什么是红树林");request.setLink(link);request.setMsgtype("markdown");OapiRobotSendRequest.Markdown markdown = new OapiRobotSendRequest.Markdown();markdown.setTitle("杭州天气");markdown.setText("#### 杭州天气 @156xxxx8827\n" +"> 9度,西北风1级,空气良89,相对温度73%\n\n" +"> ![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)\n"  +"> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) \n");request.setMarkdown(markdown);request.setMsgtype("feedCard");OapiRobotSendRequest.Feedcard feedcard = new OapiRobotSendRequest.Feedcard();OapiRobotSendRequest.Links links1 = new OapiRobotSendRequest.Links();links1.setTitle("时代的火车向前开1");links1.setMessageURL("https://www.dingtalk.com/");links1.setPicURL("https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png");OapiRobotSendRequest.Links links2 = new OapiRobotSendRequest.Links();links2.setTitle("时代的火车向前开2");links2.setMessageURL("https://www.dingtalk.com/");links2.setPicURL("https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png");List<Links> links = new ArrayList<>();links.add(links1);links.add(links2);feedcard.setLinks(links);request.setFeedCard(feedcard);OapiRobotSendResponse response = client.execute(request);System.out.println(response);}
}

总体来说,钉钉机器人推送消息的开发没有那些弯弯绕绕的设置,基本上能看懂文档就可以开发出来,也不需要什么特殊的环境支持。

钉钉工作通知实现

官方文档链接

第三方企业应用开发:https://open.dingtalk.com/document/isvapp/send-job-notification

配置流程

1. 创建一个第三方企业应用

我本来以为企业内应用和第三方企业应用一样,创建应用之后都有一个工作通知。创建应用后发现,确实都有一个,但是区别非常大。企业内应用通知就是机器人群消息,而第三方企业应用则是模板消息。

2. 依次点击应用功能—>消息推送—>新增

3. 选择Markdown模板进行创建—>发送测试消息

4. 保存好消息模板后点击提交审核,审核一般半天左右会通过

开发工作通知

1. 导入maven旧版依赖

    <!-- 使用旧版钉钉开放api --><dependency><groupId>com.aliyun</groupId><artifactId>alibaba-dingtalk-service-sdk</artifactId><version>2.0.0</version></dependency></dependencies>

2. 编写测试类

package com.example.dingtalkmsg.service;import com.dingtalk.api.DefaultDingTalkClient;
import com.dingtalk.api.DingTalkClient;
import com.dingtalk.api.request.OapiMessageCorpconversationAsyncsendV2Request;
import com.dingtalk.api.request.OapiServiceGetCorpTokenRequest;
import com.dingtalk.api.response.OapiMessageCorpconversationAsyncsendV2Response;
import com.dingtalk.api.response.OapiServiceGetCorpTokenResponse;public class DingTalkWorkNoticeSendService {public static void main(String[] args) throws Exception {//获取小程序的accessTokenDefaultDingTalkClient client1 = new DefaultDingTalkClient("https://oapi.dingtalk.com/service/get_corp_token");OapiServiceGetCorpTokenRequest req = new OapiServiceGetCorpTokenRequest();req.setAuthCorpid("dingxxxx");//suiteTicket获取比较麻烦,后续我会单独写文章说明OapiServiceGetCorpTokenResponse execute = client1.execute(req, "xxx", "xxx", "xxx");//构建工作通知推送ClientDingTalkClient client2 = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2");OapiMessageCorpconversationAsyncsendV2Request request = new OapiMessageCorpconversationAsyncsendV2Request();request.setAgentId(836390886L);request.setUseridList("user123");request.setToAllUser(false);//构建消息模板OapiMessageCorpconversationAsyncsendV2Request.Msg msg = new OapiMessageCorpconversationAsyncsendV2Request.Msg();msg.setMsgtype("text");msg.setText(new OapiMessageCorpconversationAsyncsendV2Request.Text());msg.getText().setContent("test123");request.setMsg(msg);msg.setMsgtype("image");msg.setImage(new OapiMessageCorpconversationAsyncsendV2Request.Image());msg.getImage().setMediaId("@lADOdvRYes0CbM0CbA");request.setMsg(msg);msg.setMsgtype("file");msg.setFile(new OapiMessageCorpconversationAsyncsendV2Request.File());msg.getFile().setMediaId("@lADOdvRYes0CbM0CbA");request.setMsg(msg);msg.setMsgtype("link");msg.setLink(new OapiMessageCorpconversationAsyncsendV2Request.Link());msg.getLink().setTitle("test");msg.getLink().setText("test");msg.getLink().setMessageUrl("test");msg.getLink().setPicUrl("test");request.setMsg(msg);msg.setMsgtype("markdown");msg.setMarkdown(new OapiMessageCorpconversationAsyncsendV2Request.Markdown());msg.getMarkdown().setText("##### text");msg.getMarkdown().setTitle("### Title");request.setMsg(msg);msg.setOa(new OapiMessageCorpconversationAsyncsendV2Request.OA());msg.getOa().setHead(new OapiMessageCorpconversationAsyncsendV2Request.Head());msg.getOa().getHead().setText("head");msg.getOa().setBody(new OapiMessageCorpconversationAsyncsendV2Request.Body());msg.getOa().getBody().setContent("xxx");msg.setMsgtype("oa");request.setMsg(msg);msg.setActionCard(new OapiMessageCorpconversationAsyncsendV2Request.ActionCard());msg.getActionCard().setTitle("xxx123411111");msg.getActionCard().setMarkdown("### 测试123111");msg.getActionCard().setSingleTitle("测试测试");msg.getActionCard().setSingleUrl("https://www.dingtalk.com");msg.setMsgtype("action_card");request.setMsg(msg);OapiMessageCorpconversationAsyncsendV2Response rsp = client2.execute(request, execute.getAccessToken());System.out.println(rsp.getBody());}
}

其实工作通知开发的难度也不高,但是由于这是个三方应用,所有三方应用的接口都需要一个accessToken。而这个accessToken也不是简单的拿ak/sk去获取就行了,钉钉那边还需要一个suiteTicket,这个suiteTicket才是开发的最大难点。
suiteTicket不是调用接口去获取的,而是钉钉主动推送过来的,所以我们还需要写一个回调接口供钉钉侧调用,详情请看这篇文章:添加链接描述。

钉钉小程序生态5—钉钉群机器人消息通知和钉钉工作通知相关推荐

  1. 微信小程序生态1-初识小程序

    文章导航 微信小程序生态1-初识小程序 微信小程序生态2-创建一个微信小程序 微信小程序生态3-微信小程序登录流程设计 微信小程序生态4-扫普通二维码进入小程序.打开短链接进入小程序 微信小程序生态5 ...

  2. 微信小程序生态13-微信公众号自定义菜单、个性化菜单配置

    文章导航 微信小程序生态1-初识小程序 微信小程序生态2-创建一个微信小程序 微信小程序生态3-微信小程序登录流程设计 微信小程序生态4-扫普通二维码进入小程序.打开短链接进入小程序 微信小程序生态5 ...

  3. 钉钉小程序生态1—区分企业内部应用、第三方企业应用、第三方个人应用

    文章导航 钉钉小程序生态1-区分企业内部应用.第三方企业应用.第三方个人应用 钉钉小程序生态2-区分小程序和H5微应用 钉钉小程序生态3-钉钉扫码登录PC端网站 钉钉小程序生态4-钉钉小程序三方企业应 ...

  4. 钉钉/支付宝小程序自定义组件

    钉钉/支付宝小程序自定义组件 1.新建自定义文件夹 eg:model 2.鼠标选中model 右键>新建小程序组件 输入测试组件:demo 3.新建小程序组件包含四个文件: 1.acss:组件页 ...

  5. 刚刚,阿里巴巴小程序生态联盟重磅启动

    9月27日下午,阿里巴巴小程序繁星计划峰会作为杭州云栖大会的压轴好戏,在云栖小镇国际会展中心迎来千余位商家.合作伙伴.个人开发者和行业专家.峰会以"小程序.大生态"为题,发布了阿里 ...

  6. 国内小程序生态服务平台即速应用完成5000万元A+轮融资

    1月14日消息,据亿欧报道,国内小程序生态服务平台即速应用完成5000万元A+轮融资,投资方为深创投及其旗下的深圳市人才创新创业一号股权投资基金.据了解,本轮融资将主要布局即速云2.0--小程序生态服 ...

  7. 极乐科技CEO应邀出席2017微信小程序生态课

    2019独角兽企业重金招聘Python工程师标准>>> 1月9日凌晨小程序正式上线.张小龙第一时间在其朋友圈写下一个日期-2007.1.9,并配上iPhone发布会的图片,微信小程序 ...

  8. 助力小程序生态发展 “小程序生态孵化社区”成立

    今年以来,小程序进入爆发之年,各类小程序平台的出现给急速发展的小程序生态带来了碎片化等问题和挑战. 2019年10月10日,由阿里巴巴标准化部主导发起的小程序生态孵化社区在北京正式成立.来自各行各业的 ...

  9. 国内小程序生态服务平台即速应用完成5000万元A+轮融资...

    1月14日消息,据亿欧报道,国内小程序生态服务平台即速应用完成5000万元A+轮融资,投资方为深创投及其旗下的深圳市人才创新创业一号股权投资基金.据了解,本轮融资将主要布局即速云2.0--小程序生态服 ...

最新文章

  1. C++标准库中sstream和strstream的区别
  2. Java 线程池的介绍以及工作原理
  3. Markdown:数学公式(4)
  4. Radare - 逆向工程框架
  5. InfluxDB(官方使用说明)
  6. IOS UIWindow 和 UIScreen
  7. 获取时间,并将时间的空格和特殊字符去掉,作为一个变量来使用
  8. E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?
  9. 电脑键盘下划线怎么打_苹果电脑键盘失灵怎么办,维护方法!
  10. 美团外卖返利小程序-饿了么外卖返利公众号系统 – 程序侠
  11. Ubuntu系统下载安装启动Docker
  12. R数据分析:方法与案例详解--自学笔记
  13. android-热修复-sophix
  14. SAP 查询物料的非限制库存、质检库存、冻结库存
  15. 关于井冈山大学校园宽带WIFI多人共享解决的一些思路
  16. 毕业设计之 --- 基于设深度学习的人脸性别年龄识别系统
  17. automagica 调用迅雷批量下载美剧
  18. 计算机设备预计净残值,电子设备折旧年限及残值率
  19. 嵌入式Linux磁盘(硬盘、SD卡)读写性能测试
  20. 从事计算机视觉必知的「大牛」有哪些?

热门文章

  1. netbeans ide for php,NetBeans IDE官方下载
  2. email邮箱情缘:《电子情书 You've Got Mail》
  3. css div冰淇淋车动画代码
  4. 树莓派OpenCV警告libEGL warning: DRI2: failed to authenticate(待续)
  5. python排序编程,02.编程学习--Python 排序
  6. 为什么输入动态口令后,不弹出证书,证书已下载。
  7. HTML——5(图片)
  8. 创新奇智上市首日破发:市值蒸发37亿港元,技术含金量略显不足
  9. Linux-14-Sersync
  10. Python: PS 滤镜--高反差保留 (High pass)