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

简介: 钉钉消息机器人.Net通用C#Unity实现钉钉消息通知一个工具类(无需SDK,无其他引用)Chinar —— 心分享、心创新!助力快速完成 .Net 通用的钉钉Post机器人消息通知为初学者节省宝贵的时间,避免采坑!官方文档详细,但实现方式上没有过多的说明。本质上就是一个 POST 消息请求所以我们只要, 完成正常发送POST 使得钉钉方从中可获取对应格式的数据 即可!

Chinar blog www.chinar.xin

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


本文提供全流程,中文翻译
Chinar的初衷是将一种简单的生活方式带给世人
使有限时间 具备无限可能

Chinar 教程效果:
Text格式.png
Link 格式.png
ActionCard格式.png


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


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
{
    /// <summary>
    /// Webhook 地址
    /// </summary>
    public static string WebHookUrl = "https://oapi.dingtalk.com/robot/send?access_token=b6592dff2c2d2f";


    /// <summary>
    /// 关键字 1
    /// 机器人设置的关键字
    /// </summary>
    private const string keyWord = "【提示】";


    /// <summary>
    /// 缓存 Json 
    /// </summary>
    private static readonly StringBuilder jsonStringBuilder = new StringBuilder(512);


    /// <summary>
    /// 发送 Post 数据
    /// </summary>
    /// <param name="data">数据</param>
    /// <returns>Json</returns>
    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();
        }
    }


    /// <summary>
    /// 发送 text 类型
    /// </summary>
    /// <param name="content">内容</param>
    /// <param name="phoneNumbers">@谁?支持多人</param>
    /// <param name="isAtAll">@所有人</param>
    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);
    }


    /// <summary>
    /// 发送 Link 类型
    /// </summary>
    /// <param name="title">标题</param>
    /// <param name="text">内容</param>
    /// <param name="imageUrl">图片链接</param>
    /// <param name="contentUrl">消息跳转链接</param>
    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);
    }


    /// <summary>
    /// 发送markdown类消息
    /// </summary>
    /// <param name="title">标题</param>
    /// <param name="text">消息主体</param>
    /// <param name="atMobiles">@人员电话</param>
    /// <param name="isAtAll">是否@群所有成员</param>
    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);
    }


    /// <summary>
    /// 整体发送ActionCard类型消息
    /// </summary>
    /// <param name="title">标题</param>
    /// <param name="imageUrl">图片Url</param>
    /// <param name="texttitle">文本标题</param>
    /// <param name="text">文本</param>
    /// <param name="btnTitle">按钮标题</param>
    /// <param name="buttonUrl">按钮Url</param>
    /// <param name="btnOrientation">按钮排列     0-按钮竖直排列,1-按钮横向排列</param>
    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); 
    }

    /// <summary>
    /// 独立发送 ActionCard类型消息
    /// </summary>
    /// <param name="title">标题</param>
    /// <param name="imageUrl">图片Url</param>
    /// <param name="texttitle">文本标题</param>
    /// <param name="text">文本</param>
    /// <param name="buttonUrl1">按钮1Url</param>
    /// <param name="buttonUrl2">按钮2Url</param>
    /// <param name="singleURL1">按钮1访问Url</param>
    /// <param name="singleURL2">按钮2访问Url</param>
    /// <param name="btnOrientation"></param>
    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); 
    }


    /// <summary>
    /// 发送 FeedCard类型消息
    /// </summary>
    /// <param name="title1">标题 单条信息文本</param>
    /// <param name="messageUrl1">点击单条信息到跳转链接</param>
    /// <param name="imageUrl1">单条信息后面图片的URL</param>
    /// <param name="title2"></param>
    /// <param name="messageUrl2"></param>
    /// <param name="imageUrl2"></param>
    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<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();

举个例子
在这里插入图片描述

在这里插入图片描述

在这里插入图片描述


支持

May Be —— 开发者,总有一天要做的事!


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

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

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

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


Chinar

END

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

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

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

相关文章
|
6月前
|
安全 机器人 API
简单几步,钉钉机器人秒变通义千问对话机器人
通过阿里云计算巢AppFlow平台,无需编码,只需简单几步,即可将钉钉机器人转化为通义千问对话机器人。首先在灵积模型服务平台获取API Key,然后在AppFlow中配置连接器,授权并保存Webhook Url。在钉钉中创建自定义机器人,选择Outgoing功能,填写签名和Webhook地址。最后,@机器人即可开始对话。此外,还提供了通过钉钉开放平台创建机器人的步骤。AppFlow简化了集成过程,加速了企业自动化服务流程。
|
6月前
|
开发工具
钉钉新版本sdk中如何获取用户手机id
钉钉新版本sdk中如何获取用户手机id
|
5月前
|
数据管理 机器人 BI
数据管理DMS产品使用合集之如何让报表自动更新推送到钉钉机器人
阿里云数据管理DMS提供了全面的数据管理、数据库运维、数据安全、数据迁移与同步等功能,助力企业高效、安全地进行数据库管理和运维工作。以下是DMS产品使用合集的详细介绍。
79 3
|
5月前
|
运维 机器人 开发者
使用阿里云百炼通过appflow模板,组合钉钉机器人搭建个人知识库评测与感想
尝试构建个人助手机制,用阿里云百炼+AppFlow+钉钉机器人,花费两午休时间解决配置问题。百炼appid复制时多出空格致错,文档未提及,耗时排查。应用创建时模型选项限于max, plus, turbo,性价比高的qwen-long未上线。期望尽快修复bug和上线新模型以降低成本。附故障排查截图。
178 1
|
6月前
|
Serverless Go API
Serverless 应用引擎产品使用之在阿里云Serverless中,我想在钉钉机器人中使用函数计算的签名认证如何解决
阿里云Serverless 应用引擎(SAE)提供了完整的微服务应用生命周期管理能力,包括应用部署、服务治理、开发运维、资源管理等功能,并通过扩展功能支持多环境管理、API Gateway、事件驱动等高级应用场景,帮助企业快速构建、部署、运维和扩展微服务架构,实现Serverless化的应用部署与运维模式。以下是对SAE产品使用合集的概述,包括应用管理、服务治理、开发运维、资源管理等方面。
|
6月前
|
监控 安全 机器人
SpringBoot 实现自定义钉钉机器人
SpringBoot 实现自定义钉钉机器人
|
存储 弹性计算 安全
成功案例-钉钉 | 学习笔记
快速学习 成功案例-钉钉
399 0
|
移动开发 物联网 Go
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例
|
移动开发 物联网 智能硬件
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例
253 0
SAP Business ByDesign 和支付宝与钉钉集成的一个原型开发案例