Chinar blog :www.chinar.xin
Chinar 的初衷是将一种简单的生活方式带给世人 使有限时间 具备无限可能 |
助力快速完成 .Net 通用的钉钉Post机器人消息通知 为初学者节省宝贵的时间,避免采坑! |
疫情原因,居家办公,移动办公或将成为未来世界的主流。
一、实现钉钉自己定义消息通知?
项目需求:需要直接通知消息或相关资料分享到钉钉里。
看了下钉钉官方文档,搜索了下发现网络上教程接入这块不够详细,初学者入门较难。各种失败案例!
官方文档详细,但实现方式上没有过多的说明。
二、钉钉消息通知,本质
本质上就是一个 POST 消息请求
所以我们只要, 完成正常发送POST 使得钉钉方从中可获取对应格式的数据 即可!
ps:最近有人吐槽我说:粉丝文章真恶心,不开放阅读不如不看。
我想说:辛苦总结的资料,基本都是经过多次测试,拿来即用。
您不点赞也就算了,关注一下都不愿意,也是醉了。
我的时间和经验也不是大风刮来的。
Chinar 为您节约宝贵时间,所有函数都已封装完毕。
无任何数据类,无需序列化。
只此一个工具脚本!.Net通用!
您只需
1. Webhook地址和关键字改用自己机器人
2. 调用对应方法即可发送消息。
工具类代码
using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;
public class ChinarDing
{
///
/// Webhook 地址
///
public static string WebHookUrl = "https://oapi.dingtalk.com/robot/send?access_token=b6592dff2c2d2f";
///
/// 关键字 1
/// 机器人设置的关键字
///
private const string keyWord = "【提示】";
///
/// 缓存 Json
///
private static readonly StringBuilder jsonStringBuilder = new StringBuilder(512);
///
/// 发送 Post 数据
///
/// 数据
/// Json
public static String Post(string data)
{
var httpWebRequest = (HttpWebRequest) WebRequest.Create(WebHookUrl);
httpWebRequest.ContentType = "application/json";
httpWebRequest.Method = WebRequestMethods.Http.Post;
if (data != null)
{
byte[] dataBytes = Encoding.UTF8.GetBytes(data);
httpWebRequest.ContentLength = dataBytes.Length;
using (var reqStream = httpWebRequest.GetRequestStream())
{
reqStream.Write(dataBytes, 0, dataBytes.Length);
httpWebRequest.GetRequestStream().Write(dataBytes, 0, dataBytes.Length);
}
}
using (var httpWebResponse = (HttpWebResponse) httpWebRequest.GetResponse())
{
var responseStream = httpWebResponse.GetResponseStream();
return responseStream == null ? null : new StreamReader(responseStream, Encoding.UTF8).ReadToEnd();
}
}
///
/// 发送 text 类型
///
/// 内容
/// @谁?支持多人
/// @所有人
public static void SendText(string content, List<string> phoneNumbers, bool isAtAll)
{
//var addColon = mobileList.Select(_ => $"\"{_}\""); //有时特殊需要,对电话号码每一项加上 “132XXX43210”
jsonStringBuilder.Clear();
var listToString = string.Join(",", phoneNumbers);
jsonStringBuilder.Append($"{{\"msgtype\":\"text\",\"text\":{{\"content\":\"{keyWord + content}\"}},\"at\":{{\"atMobiles\":[{listToString}],\"isAtAll\":{isAtAll.ToString().ToLower()}}}}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
Console.Write(ReturnJson);
}
///
/// 发送 Link 类型
///
/// 标题
/// 内容
/// 图片链接
/// 消息跳转链接
public static void SendLink(string title, string text, string imageUrl, string contentUrl)
{
jsonStringBuilder.Clear();
jsonStringBuilder.Append("{\"msgtype\":\"link\",\"link\":{" +
$"\"title\":\"{keyWord + title}\"," +
$"\"text\":\"{text}\"," +
$"\"picUrl\":\"{imageUrl}\"," +
$"\"messageUrl\":\"{contentUrl}\"}}}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
Console.Write(ReturnJson);
}
///
/// 发送markdown类消息
///
/// 标题
/// 消息主体
/// @人员电话
/// 是否@群所有成员
public static void SendMarkdown(string title, string text, string imageUrl, List<string> phoneNumbers, bool isAtAll)
{
var listToString = string.Join(",", phoneNumbers);
jsonStringBuilder.Clear();
jsonStringBuilder.Append($"{{\"msgtype\":\"markdown\",\"" +
$"markdown\":{{\"title\":\"{keyWord + title}\"," +
$"\"text\":\"{text} " +
$"![screenshot]({imageUrl})\\n> [Chinar](https://www.chinar.com) \\n\"}}," +
$"\"at\":{{\"atMobiles\":[\"{listToString}\"]," +
$"\"isAtAll\":{isAtAll.ToString().ToLower()}}}}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
Console.Write(ReturnJson);
}
///
/// 整体发送ActionCard类型消息
///
/// 标题
/// 图片Url
/// 文本标题
/// 文本
/// 按钮标题
/// 按钮Url
/// 按钮排列 0-按钮竖直排列,1-按钮横向排列
public static void SendActionCard(string title, string imageUrl, string texttitle, string text, string btnTitle, string buttonUrl, string btnOrientation)
{
jsonStringBuilder.Clear();
jsonStringBuilder.Append($"{{\"actionCard\":{{\"title\":\"{keyWord + title}\"," +
$"\"text\":\"![screenshot]({imageUrl}) \\r\\n ### {texttitle} \\r\\n {text}\"," +
$"\"btnOrientation\":\"{btnOrientation}\"," +
$"\"singleTitle\":\"{btnTitle}\"," +
$"\"singleURL\":\"{buttonUrl}\"}}," +
$"\"msgtype\":\"actionCard\"}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
//Console.Write(ReturnJson);
}
///
/// 独立发送 ActionCard类型消息
///
/// 标题
/// 图片Url
/// 文本标题
/// 文本
/// 按钮1Url
/// 按钮2Url
/// 按钮1访问Url
/// 按钮2访问Url
///
public static void SendActionCard(string title, string imageUrl, string texttitle, string text, string buttonUrl1, string buttonUrl2, string singleURL1, string singleURL2, string btnOrientation)
{
jsonStringBuilder.Clear();
jsonStringBuilder.Append($"{{\"actionCard\":{{\"title\":\"{keyWord + title}\"," +
$"\"text\":\"![screenshot]({imageUrl}) \\r\\n ### {texttitle} \\r\\n {text}\"," +
$"\"btnOrientation\":\"{btnOrientation}\"," +
$"\"btns\":[{{\"title\":\"{buttonUrl1}\"," +
$"\"actionURL\":\"{singleURL1}\"}}," +
$"{{\"title\":\"{buttonUrl2}\"," +
$"\"actionURL\":\"{singleURL2}\"}}]}}," +
$"\"msgtype\":\"actionCard\"}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
//Console.Write(ReturnJson);
}
///
/// 发送 FeedCard类型消息
///
/// 标题 单条信息文本
/// 点击单条信息到跳转链接
/// 单条信息后面图片的URL
///
///
///
public static void SendFeedCard(string title1, string messageUrl1, string imageUrl1, string title2, string messageUrl2, string imageUrl2)
{
jsonStringBuilder.Clear();
jsonStringBuilder.Append($"{{\"feedCard\":{{\"links\":[{{\"title\":\"{keyWord + title1}\"," +
$"\"messageURL\":\"{messageUrl1}\"," +
$"\"picURL\":\"{imageUrl1}\"}}," +
$"{{\"title\":\"{title2}\"," +
$"\"messageURL\":\"{messageUrl2}\"," +
$"\"picURL\":\"{imageUrl2}\"}}]}}," +
$"\"msgtype\":\"feedCard\"}}");
string ReturnJson = Post(jsonStringBuilder.ToString());
}
}
疫情原因,居家办公,移动办公或将成为未来世界的主流。
静态函数,直接调用即可
// 1- Text 类型
ChinarDing.SendText("Hello World!", new List<string>(), false);
//2- Link 类型
ChinarDing.SendLink("Link", "测试 Post Link 请求", "http://qiniu.chinar.xin/DingChinar-3.png", "http://www.chinar.xin");
// 3- Markdown 类型
ChinarDing.SendMarkdown("Markdown", "测试 MD 请求", "http://qiniu.chinar.xin/DingChinar-3.png", new List<string> {"135XXX53210"}, false);
// 4- Markdown 类型
ChinarDing.SendActionCard("Card", "http://qiniu.chinar.xin/DingChinar-3.png", "Text 标题", "测试 MD 请求", "内容不错", "不感兴趣", "https://www.dingtalk.com/", "https://www.dingtalk.com/", "0");
ChinarDing.SendActionCard("乔布斯 20 年前想打", "https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png", "乔布斯 20 年前想打造的苹果咖啡厅", "Apple Store 的设计正从原来满满的科技感走向生活化,", "内容不错", "不感兴趣", "https://www.dingtalk.com/", "https://www.dingtalk.com/", "0");
ChinarDing.SendFeedCard("时代的火车向前开", "https://www.dingtalk.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI", "https://gw.alicdn.com/tfs/TB1ayl9mpYqK1RjSZLeXXbXppXa-170-62.png", "时代的火车向前开", "https://www.dingtalk.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI", "https://gw.alicdn.com/tfs/TB1ayl9mpYqK1RjSZLeXXbXppXa-170-62.png");
ChinarDing.SendActionCard("乔布斯 20 年前想打", "https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png", "乔布斯 20 年前想打造的苹果咖啡厅", "Apple Store 的设计正从原来满满的科技感走向生活化,", "内容不错", "https://www.dingtalk.com/", "0");
Console.ReadKey();
Chinar 提供一站式《零》基础教程 使有限时间 具备无限可能! |
先点击领取 —— 阿里全产品优惠券 (享受最低优惠)
Chinar 免费服务器、建站教程全攻略!( Chinar Blog )
本博客为非营利性个人原创,除部分有明确署名的作品外,所刊登的所有作品的著作权均为本人所拥有,本人保留所有法定权利。违者必究
对于需要复制、转载、链接和传播博客文章或内容的,请及时和本博主进行联系,留言,Email: [email protected]
对于经本博主明确授权和许可使用文章及内容的,使用时请注明文章或内容出处并注明网址