钉钉消息机器人.Net通用C#Unity实现钉钉消息通知一个工具类(无需SDK，无其他引用)

Chinar blog ：www.chinar.xin

.Net通用钉钉自定义机器人

本文提供全流程，中文翻译。

Chinar 的初衷是将一种简单的生活方式带给世人

使有限时间具备无限可能

Chinar —— 心分享、心创新！

助力快速完成 .Net 通用的钉钉Post机器人消息通知

为初学者节省宝贵的时间，避免采坑！

Chinar 教程效果：

文章目录

1
- Presentation —— 介绍
2
- Utility Class —— 工具类
3
- Use —— 使用方法
支持
- May Be —— 开发者，总有一天要做的事！

全文高清图片，点击即可放大观看 (很多人竟然不知道)

1 Presentation —— 介绍

疫情原因，居家办公，移动办公或将成为未来世界的主流。

一、实现钉钉自己定义消息通知？

项目需求：需要直接通知消息或相关资料分享到钉钉里。

看了下钉钉官方文档，搜索了下发现网络上教程接入这块不够详细，初学者入门较难。各种失败案例！

官方文档详细，但实现方式上没有过多的说明。

二、钉钉消息通知，本质

本质上就是一个 POST 消息请求
所以我们只要，完成正常发送POST 使得钉钉方从中可获取对应格式的数据即可！

ps：最近有人吐槽我说：粉丝文章真恶心，不开放阅读不如不看。

我想说：辛苦总结的资料，基本都是经过多次测试，拿来即用。

您不点赞也就算了，关注一下都不愿意，也是醉了。

我的时间和经验也不是大风刮来的。

2 Utility Class —— 工具类

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 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 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());
    }
}

3 Use —— 使用方法

疫情原因，居家办公，移动办公或将成为未来世界的主流。

静态函数，直接调用即可

 // 1- Text 类型
            ChinarDing.SendText("Hello World!", new List(), 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 {"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();

支持 May Be —— 开发者，总有一天要做的事！

拥有自己的服务器，无需再找攻略

Chinar 提供一站式《零》基础教程

使有限时间具备无限可能！

先点击领取 —— 阿里全产品优惠券 (享受最低优惠)

Chinar 免费服务器、建站教程全攻略！( Chinar Blog )

END

本博客为非营利性个人原创，除部分有明确署名的作品外，所刊登的所有作品的著作权均为本人所拥有，本人保留所有法定权利。违者必究

对于需要复制、转载、链接和传播博客文章或内容的，请及时和本博主进行联系，留言，Email: ichinar@icloud.com

对于经本博主明确授权和许可使用文章及内容的，使用时请注明文章或内容出处并注明网址

钉钉消息机器人.Net通用C#Unity实现钉钉消息通知一个工具类(无需SDK，无其他引用)

.Net相关栏目本月热门文章