钉钉员工消息通知工具类java 钉钉工作通知在哪里找

转载

码海探险家 2023-12-11 15:02:47

文章标签 钉钉员工消息通知工具类java c# 测试 java 发送消息 文章分类 Java 后端开发

钉钉员工消息通知工具类java 钉钉工作通知在哪里找_测试

首先看下官方文档，为我们提供了POST请求地址，和几个必传参数的列表以及参数示例，写的都挺详细的。

无奈提供的SDK请求示例是JAVA的，而我用的是.NET的，所以还是摸了一些坑出来，其实也就是不同平台的部分方法或者语法不同而已，调试好一个接口后，后面再调试其他接口就会快很多了。

调用淘宝接口，我看到的几个哥们，用的都是这个URL地址：https://eco.taobao.com/router/rest

相应代码如下：

1         /// <summary>
 2         /// 工作通知消息（淘宝URL）
 3         /// </summary>
 4         /// <returns></returns>
 5         public JsonResult SendWorkMessage()
 6         {
 7             //判断缓存中是否有access_token，否则重新获取
 8             var access_token = CacheHelper.GetCache("access_token");
 9             if (access_token == null)
10             {
11                 DingDevelopSDK developSDK = new DingDevelopSDK();
12                 access_token = developSDK.Get_access_token_by_appkey_and_appsecret(Models.DingDingConfig.appkey, Models.DingDingConfig.appsecret);
13             }
14             IDingTalkClient client = new DefaultDingTalkClient("https://eco.taobao.com/router/rest");
15             CorpMessageCorpconversationAsyncsendRequest req = new CorpMessageCorpconversationAsyncsendRequest();
16             req.Msgtype = "oa";                                                     //发送消息是以oa的形式发送的,其他的还有text,image等形式
17             req.AgentId = Models.DingDingConfig.agentId;
18             req.UseridList = "manager1805";
19             req.ToAllUser = false;                                                  //是否发给所有人,很重要，为true的时候，一天只能调用3次该接口
20             req.Msgcontent = "{\"message_url\": \"http://dingtalk.com\",\"head\": {\"bgcolor\": \"FFBBBBBB\",\"text\": \"头部标题\"},\"body\": {\"title\": \"测试文本\",\"form\": [{\"key\": \"姓名:\",\"value\": \"张三\"},{\"key\": \"爱好:\",\"value\": \"打球、听音乐\"}],\"rich\": {\"num\": \"15.6\",\"unit\": \"元\"},\"content\": \"淘宝URL\",\"image\": \"@lADOADmaWMzazQKA\",\"file_count\": \"3\",\"author\": \"李四 \"}}";
21             CorpMessageCorpconversationAsyncsendResponse rsp = client.Execute(req, access_token.ToString());//发送消息
22             string result = rsp.Body;
23            // DeBugLog.WriteLog(result);
24             return Json(new { Result = true, result }, JsonRequestBehavior.AllowGet);
25         }

调用结果：

钉钉员工消息通知工具类java 钉钉工作通知在哪里找_c#_02

接下来是调用官方文档里写的接口：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN。

这里的参数access_token不用写在url里，方法asyncsend_v2是示例代码里调用的，但是在.NET平台下方法和JAVA有些差异，在试过几个类和方法之后，我用的方法是asyncsend，后面没有带"_v2"，

所以接口地址就是：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend。

上代码：

1         /// <summary>
 2         /// 工作通知消息（钉钉URL）
 3         /// </summary>
 4         /// <returns></returns>
 5         public JsonResult SendMessage_ByDingDingURL()
 6         {
 7             try {
 8                 //判断缓存中是否有access_token，否则重新获取
 9                 var access_token = CacheHelper.GetCache("access_token");
10                 if (access_token == null)
11                 {
12                     DingDevelopSDK developSDK = new DingDevelopSDK();
13                     access_token = developSDK.Get_access_token_by_appkey_and_appsecret(Models.DingDingConfig.appkey, Models.DingDingConfig.appsecret);
14                 }
15                 //官网POST地址为https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2，根据方法的不同，下文的URL采用的是asyncsend而不是asyncsend_v2
16                 IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend");
17                 OapiMessageCorpconversationAsyncsendRequest req = new OapiMessageCorpconversationAsyncsendRequest();
18                 req.SetHttpMethod("POST");
19                 req.ToAllUser = false;
20                 req.AgentId = Models.DingDingConfig.agentId;
21                 req.UseridList = "manager1805";
22                 req.Msgtype = "oa";
23                 req.Msgcontent = "{\"message_url\": \"http://dingtalk.com\",\"head\": {\"bgcolor\": \"FFBBBBBB\",\"text\": \"测试001\"},\"body\": {\"title\": \"测试文本\",\"form\": [{\"key\": \"姓名:\",\"value\": \"张三\"},{\"key\": \"爱好:\",\"value\": \"打球、听音乐\"}],\"rich\": {\"num\": \"15.6\",\"unit\": \"元\"},\"content\": \"钉钉URL\",\"image\": \"@lADOADmaWMzazQKA\",\"file_count\": \"3\",\"author\": \"admin \"}}";
24                 OapiMessageCorpconversationAsyncsendResponse response = client.Execute(req, access_token.ToString());
25                 DeBugLog.WriteLog(response.Body);
26                 return Json(new { Result = true }, JsonRequestBehavior.AllowGet);
27             }
28             catch (Exception ex)
29             {
30                 DeBugLog.WriteLog(ex);
31                 return Json(new { Result = false }, JsonRequestBehavior.AllowGet);
32             }
33         }

结果和上面的是一样的。

这里获取ccess_token的方法我就不累述了，我是直接从缓存里获取的，其他参数的使用要点，要结合文档去使用：

发送工作通知消息需要注意以下事项：