钉钉自定义机器人.net版

最新推荐文章于 2023-06-24 21:42:22 发布
最新推荐文章于 2023-06-24 21:42:22 发布
阅读量587 收藏 1
点赞数 1
分类专栏： C# 文章标签： dingtalk机器人 钉钉机器人 webhook 钉钉自动回复 钉钉机器人sdk
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/agoling/article/details/103893579
版权 
using System;
using System.Collections.Generic;
using System.Linq;
using UtilsCore.Result;

namespace UtilsCore
{
    /// <summary>
    /// 钉钉自定义机器人
    /// </summary>
    public class DingTalkRobot
    {
        /// <summary>
        ///  调用自定义机器人发Text类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="content">消息内容</param>
        /// <param name="atMobiles">被@人的手机号</param>
        /// <param name="isAtAll">@所有人时:true,否则为:false</param>
        /// <returns></returns>
        public static BaseResult<object> SendTextMessage(string webhook, string content, List<string> atMobiles, bool isAtAll)
        {
            var result=new BaseResult<object>();
            try
            {
                //@手机号
                var mobiles = "";
                if (!isAtAll)
                {
                    mobiles = GetAtMobiles(atMobiles);
                }
                //消息内容
                object message = new
                {
                    msgtype = "text",
                    text = new
                    {
                        content = (content+ mobiles).Trim(),
                    },
                    at = new
                    {
                        atMobiles = atMobiles,
                        isAtAll = isAtAll
                    }
                };
                return SendMessage(webhook, message);
                 
            }
            catch (Exception ex)
            {
               result.SetError(ex.Message);
               return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发Link类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="title">消息标题</param>
        /// <param name="text">消息内容(注：如果太长只会部分展示)</param>
        /// <param name="picUrl">图片url</param>
        /// <param name="messageUrl">点击消息跳转的url</param>
        /// <returns></returns>
        public static BaseResult<object> SendLinkMessage(string webhook, string title, string text,string picUrl, string messageUrl)
        {
            var result=new BaseResult<object>();
            try
            {
                object message = new
                {
                    msgtype = "link",
                    link = new
                    {
                        title = title,
                        text = text,
                        picUrl = picUrl,
                        messageUrl = messageUrl
                    },
                };
                return SendMessage(webhook, message);
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发Markdown类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="title">消息标题</param>
        /// <param name="titleType">标题类型等级</param>
        /// <param name="markdownMessages">消息内容</param>
        /// <param name="atMobiles">被@手机号</param>
        /// <param name="isAtAll">@所有人时:true,否则为:false</param>
        /// <returns></returns>
        public static BaseResult<object> SendMarkdownMessage(string webhook, string title, TitleType titleType, List<MarkdownMessage> markdownMessages, List<string> atMobiles, bool isAtAll)
        {
            var result = new BaseResult<object>();
            try
            {
                //@手机号
                var mobiles = "";
                if (!isAtAll)
                {
                    mobiles = GetAtMobiles(atMobiles);
                }
                //消息内容头部(标题+被@的人;注：自动换行)
                var textTop = GetContentGrade(titleType, title) + "\n >" + mobiles + "\n >";
                //消息内容
                var text = textTop + RestructureMessage(markdownMessages);
                object message = new
                {
                    msgtype = "markdown",
                    markdown = new
                    {
                        title = title,
                        text = text,
                    },
                    at = new
                    {
                        atMobiles = atMobiles,
                        isAtAll = isAtAll,
                    }
                };
                return SendMessage(webhook, message);
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发整体跳转ActionCard类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="title">消息标题</param>
        /// <param name="markdownMessages">消息内容</param>
        /// <param name="hideAvatar">0-正常发消息者头像,1-隐藏发消息者头像</param>
        /// <param name="btnOrientation">0-按钮竖直排列，1-按钮横向排列</param>
        /// <param name="singleTitle">单个按钮的方案。(设置此项和singleUrl后btns无效。)</param>
        /// <param name="singleUrl">点击singleTitle按钮触发的URL</param>
        /// <returns></returns>
        public static BaseResult<object> SendActionCardMessage(string webhook, string title, List<MarkdownMessage> markdownMessages, int hideAvatar, int btnOrientation, string singleTitle, string singleUrl)
        {
            var result = new BaseResult<object>();
            try
            {
                object message = new
                {
                    msgtype = "actionCard",
                    actionCard = new
                    {
                        title = title,
                        text = RestructureMessage(markdownMessages),
                        hideAvatar = hideAvatar,
                        btnOrientation = btnOrientation,
                        singleTitle = singleTitle,
                        singleURL = singleUrl
                    },
                };
                return SendMessage(webhook, message);
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发独立跳转ActionCard类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="title">消息标题</param>
        /// <param name="markdownMessages">消息内容</param>
        /// <param name="hideAvatar">0-正常发消息者头像,1-隐藏发消息者头像</param>
        /// <param name="btnOrientation">0-按钮竖直排列，1-按钮横向排列</param>
        /// <param name="btns">按钮集合</param>
        /// <returns></returns>
        public static BaseResult<object> SendSingleActionCardMessage(string webhook, string title, List<MarkdownMessage> markdownMessages, int hideAvatar, int btnOrientation, List<Btn> btns)
        {
            var result = new BaseResult<object>();
            try
            {
                var btnObjs = new List<object>();
                if (btns != null && btns.Count > 0)
                {
                    foreach (var item in btns)
                    {
                        object obj = new { title = item.Title, actionURL =item.ActionUrl };
                        btnObjs.Add(obj);
                    }
                }
                object message = new
                {
                    actionCard = new
                    {
                        title= title,
                        text = RestructureMessage(markdownMessages),
                        hideAvatar = hideAvatar,
                        btnOrientation = btnOrientation,
                        btns = btnObjs
                    },
                    msgtype = "actionCard",
                };
                return SendMessage(webhook, message);
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发FeedCard类型消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="links">图片按钮集合</param>
        /// <returns></returns>
        public static BaseResult<object> SendFeedCardMessage(string webhook, List<Link> links)
        {
            var result = new BaseResult<object>();
            try
            {
                var linkObjs = new List<object>();
                if (links != null && links.Count > 0)
                {
                    foreach (var item in links)
                    {
                        object obj = new {title = item.Title, messageURL = item.MessageUrl, picURL = item.PicUrl};
                        linkObjs.Add(obj);
                    }
                }
                object message = new
                {
                    feedCard = new
                    {
                        links = linkObjs,
                    },
                    msgtype = "feedCard"
                };
                return SendMessage(webhook, message);
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }

        /// <summary>
        /// 调用自定义机器人发消息
        /// </summary>
        /// <param name="webhook">webHook地址</param>
        /// <param name="message">消息信息</param>
        /// <returns></returns>

        private static BaseResult<object> SendMessage(string webhook, object message)
        {
            var result=new BaseResult<object>();
            try
            {
                var webHelper=new WebHelper();
                result.Result=webHelper.DoPost<object>(webhook, message, out var tips);
                result.Msg = tips;
                if (tips == "请求成功") return result;
                result.SetError(tips);
                return result;
            }
            catch (Exception ex)
            {
                result.SetError(ex.Message);
                return result;
            }
        }
        
        /// <summary>
        /// 重构消息内容
        /// </summary>
        /// <param name="markdownMessages">消息内容</param>
        /// <returns></returns>
        private static string RestructureMessage(List<MarkdownMessage> markdownMessages)
        {
            var text = "";
            foreach (var item in markdownMessages.OrderBy(x => x.Index))
            {
                switch (item.MarkdownType)
                {
                    case MarkdownType.文本:
                    {
                        switch (item.Text.ContentType)
                        {
                            case ContentType.默认:
                                item.Text.Content = item.Text.Content;
                                break;
                            case ContentType.加粗:
                                item.Text.Content = "**" + item.Text.Content + "**";
                                break;
                            case ContentType.斜体:
                                item.Text.Content = "*" + item.Text.Content + "*";
                                break;
                            default:
                                item.Text.Content = item.Text.Content;
                                break;
                        }
                        //文本等级赋值
                        item.Text.Content = GetContentGrade(item.Text.ContentGrade, item.Text.Content);
                        //判断是否换行
                        text += (item.IsLineFeed) ? item.Text.Content + "\n >" : item.Text.Content;
                        break;
                    }
                    case MarkdownType.图片:
                        text += (item.IsLineFeed) ? "![screenshot](" + item.Text.ImgUrl + ")\n >" : "![screenshot](" + item.Text.ImgUrl + ")";
                        break;
                    case MarkdownType.链接:
                        text += (item.IsLineFeed) ? "[" + item.Text.Content + "](" + item.Text.Url + ")\n >" : "[" + item.Text.Content + "](" + item.Text.Url + ")";
                        break;
                    default:
                        throw new ArgumentOutOfRangeException();
                }
            }
            return text;
        }

        /// <summary>
        /// 获取被@人的手机号
        /// </summary>
        /// <param name="atMobiles">被@人的手机号</param>
        /// <returns></returns>
        private static string GetAtMobiles(List<string> atMobiles)
        {
            var mobiles = "";
            if (atMobiles == null || atMobiles.Count <= 0) return mobiles;
            foreach (var item in atMobiles)
            {
                mobiles += "@" + item;
            }
            return mobiles;
        }

        /// <summary>
        /// 获取等级文本
        /// </summary>
        /// <param name="titleType">文本类型</param>
        /// <param name="title">文本</param>
        /// <returns></returns>
        private static string GetContentGrade(TitleType titleType, string title)
        {
            switch (titleType)
            {
                case TitleType.默认:
                    break;
                case TitleType.一级:
                    title = "# " + title;
                    break;
                case TitleType.二级:
                    title = "## " + title;
                    break;
                case TitleType.三级:
                    title = "### " + title;
                    break;
                case TitleType.四级:
                    title = "#### " + title;
                    break;
                case TitleType.五级:
                    title = "##### " + title;
                    break;
                case TitleType.六级:
                    title = "###### " + title;
                    break;
                default:
                    break;
            }
            return title;
        }
    }

    #region 公共模型

    /// <summary>
    /// Markdown消息内容类
    /// </summary>
    public class MarkdownMessage
    {
        /// <summary>
        /// 内容坐标索引
        /// </summary>
        public int Index { get; set; }

        /// <summary>
        /// 内容类型(文字、图片、链接)
        /// </summary>
        public MarkdownType MarkdownType { get; set; }

        /// <summary>
        /// 内容（注：文字类型的内容中禁止字符["#"、"*"、"["、"]"、"!"]；
        /// 图片类型和链接类型的内容传可访问的http地址即可）
        /// </summary>
        public Text Text { get; set; }

        /// <summary>
        /// 是否换行
        /// </summary>
        public bool IsLineFeed { get; set; }
    }

    /// <summary>
    /// 内容
    /// </summary>
    public class Text
    {
        /// <summary>
        /// 文本或链接显示文字
        /// </summary>
        public string Content { get; set; }

        /// <summary>
        /// 图片链接
        /// </summary>
        public string ImgUrl { get; set; }

        /// <summary>
        /// 超链接地址
        /// </summary>
        public string Url { get; set; }

        /// <summary>
        /// 文本类型
        /// </summary>
        public ContentType ContentType { get; set; }

        /// <summary>
        /// 文本等级
        /// </summary>
        public TitleType ContentGrade { get; set; }
    }

    /// <summary>
    /// 超链接按钮
    /// </summary>
    public class Btn
    {
        /// <summary>
        /// 标题
        /// </summary>
        public string Title { get; set; }

        /// <summary>
        /// 标题对应的超链接
        /// </summary>
        public string ActionUrl { get; set; }
    }

    /// <summary>
    /// 超链接按钮带图片
    /// </summary>
    public class Link
    {
        /// <summary>
        /// 标题
        /// </summary>
        public string Title { get; set; }

        /// <summary>
        /// 超链接
        /// </summary>
        public string MessageUrl { get; set; }

        /// <summary>
        /// 图片超链接
        /// </summary>
        public string PicUrl { get; set; }
    }

    #endregion

    #region 枚举

    /// <summary>
    /// 文本类型
    /// </summary>
    public enum ContentType
    {
        /// <summary>
        /// 默认
        /// </summary>
        默认=0,
        /// <summary>
        /// 加粗
        /// </summary>
        加粗 = 1,
        /// <summary>
        /// 斜体
        /// </summary>
        斜体 = 2
    }

    /// <summary>
    /// Markdown消息内容类型
    /// </summary>
    public enum MarkdownType
    {
        /// <summary>
        /// 文本
        /// </summary>
        文本 = 1,
        /// <summary>
        /// 图片
        /// </summary>
        图片 = 2,
        /// <summary>
        /// 链接
        /// </summary>
        链接 = 3,
    }

    /// <summary>
    /// 标题(文本)类型等级
    /// </summary>
    public enum TitleType
    {
        /// <summary>
        /// 默认
        /// </summary>
        默认 = 0,
        /// <summary>
        /// 一级
        /// </summary>
        一级 = 1,
        /// <summary>
        /// 二级
        /// </summary>
        二级 = 2,
        /// <summary>
        /// 三级
        /// </summary>
        三级 = 3,
        /// <summary>
        /// 四级
        /// </summary>
        四级 = 4,
        /// <summary>
        /// 五级
        /// </summary>
        五级 = 5,
        /// <summary>
        /// 六级
        /// </summary>
        六级 = 6,
    }

    #endregion
}

github源码：https://github.com/agoling/UtilsSharp.Standard

agoling
关注
专栏目录
C#实现钉钉自定义机器人发送群消息帮助类
CoffeMilk的博客
09-17 1631
在企业中，针对一些关键指标内容（如每天的生产产量、每天的设备报警信息等信息），需要同时给多人分享，此时就可以将需要查看这些数据的人员都拉到一个群中，让群里的机器人将这些关键指标内容推送到群里即可【（目前已实现在钉钉群里创建自定义机器人发送①文本文件内容到群；②发送文本文件到群且@指定人员；③发送图片内容到群；
钉钉机器人编程
syz1985的博客
01-16 1020
import requests import getpass import json headers = {'Content-Type': 'application/json;charset=utf-8'} # data = { # "msgtype": "text", # "text": { # "content": "我就是我, 是不一样的烟火@156xxxx...
使用asp.net开发钉钉群机器人全过程
04-01 820
集团是使用钉钉进行工作交流的， 发现群里有很多问题其实是重复的，就在想是不是可以使用钉钉的群机器人，虽然说的确是可以部分实现，但是感觉还是差点什么，而且公司内部很多东西也不方便放上去，所以就想开发一个群机器人，然后就看钉钉开发文档，发现是有这个功能的，就开始研究，官方文档使用的语言主要是Java,并没有c#或者asp.net的相关文档，这就意味着要从头开始开发， 所幸的是他是有c#的SDK开发包，开发包里是有DLL的，这样能省下不少事，废话不多说，上链接 https://open.dingtalk.com
dotnet-DDRobot钉钉自定义机器人消息推送
08-15
DDRobot - 钉钉自定义机器人消息推送
Asp.Net Core对接钉钉群机器人
weixin_30716725的博客
03-02 167
　　钉钉作为企业办公越来越常用的软件，对于企业内部自研系统提供接口支持，以此来打通多平台下的数据，本次先使用最简单的钉钉群机器人完成多种形式的消息推送，参考钉钉开发文档中自定义机器人环节，此次尝试所花的时间不多，但有几个地方是需要注意的。 　　 一、钉钉群中建立机器人获取WebHook地址 　　首先得有一个钉钉群，如果没有得自行创建一个了，通过群内右上角菜单中找到群机器人然后添加一个自...
C#HTTP_POST钉钉群机器人
05-07
钉钉群，建立机器人，启用代码，替换机器人webhook链接，demo中可以发送text、markdown、link等类型
Python调用钉钉自定义机器人的实现
01-20
前言：由于公司使用钉钉，之前告警都是使用邮箱，但是这种协同效率比较低，所以调用钉钉机器人来实现实时告警。 创建机器人：创建钉钉群，然后添加群机器人。 python代码如下： #1、导包 import json import ...
ding-bot-sdk:钉钉自定义机器人 sdk 封装
05-24
钉钉自定义机器人的封装 安装 npm install ding-bot-sdk # or yarn add ding-bot-sdk 初始化 import Bot from 'ding-bot-sdk' # or const Bot = require('ding-bot-sdk') // Webhook地址: ...
Asp.Net Core对接钉钉群机器人的完整步骤记录
10-17
主要给大家介绍了关于Asp.Net Core对接钉钉群机器人的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
.NET 钉钉demo与开发文档SDK
05-16
阿里钉钉办公APP、企业开发.NET demo，文档、SDK sdk，jsapi接口和top接口 项目结构 business为业务逻辑层主要是接口调用，如果需要别的接口可以自行添加 config中是配置corpid和corpsecret mode中是创建request实体和response实体 jaspi.aspx是调用接口页面
JAVA----钉钉机器人消息样式，关于PC 端与手机端文字消息样式显示不统一
Damys
08-31 1438
钉钉机器人消息样式，关于PC 端与手机端文字消息样式显示不统一
钉钉api调用
qq_41607217的博客
09-01 7392
package DingDingApiDemo; import com.alibaba.fastjson.JSONObject; import com.dingtalk.api.DefaultDingTalkClient; import com.dingtalk.api.DingTalkClient; import com.dingtalk.api.request.*; import com.dingtalk.api.response.*; import com.taobao.api.ApiExcepti
Vb.net 钉钉Webhook机器人
最新发布
Pwwwqq的博客
06-24 252
Vb.net 钉钉Webhook机器人
调用钉钉服务端API发送工作通知消息
浪子天涯行世录
02-06 2万+
需求：在业务系统中产生的通知消息，通过调用钉钉服务端API，发送到对应员工的钉钉客户端。 步骤： 目录 1.创建并配置消息发送应用 1.1登录开发者后台 1.2创建H5微应用 1.3配置H5微应用 2.调用服务端API发送消息 2.1获取access_token 2.2根据手机号获取userid 2.3发送工作通知消息 2.4查询工作通知消息的发送进度 2.5查询工作通知消...
DingTalk「开发者说」 5分钟开发钉钉应用
钉钉开发者社区
03-07 5774
DingTalk「开发者说」是钉钉开发者最新上线的开发者栏目，联合阿里云ACE团队，分享钉应用开发解决方案、技术更新、实战技巧，致力于成为钉钉与开发者的桥梁与纽带，让更多的钉钉开发者传播技术、提升技能、分享观点。在数字化变革的时代，“云钉一体”“钉钉全面开放”战略之后，希望钉钉技术可以持续激发开发者的创造力，为组织数字化赋能。分享人：石周，钉钉应用开发技术负责人
调用钉钉接口--发送工作通知消息
热门推荐
张姐姐聊编程
12-02 2万+
钉钉目前是管理公司比较常用的软件，为了完善公司的管理制度,为了加强公司的管理模式,所以现在需要调用钉钉的发送消息的接口,进行企业通知消息的发送.
.net开发_VB.NET应用钉钉接口开发(二）
weixin_39559523的博客
11-20 394
1、前言钉钉开发基本都是java做应用实例，缺乏.net开发应用实例，尤其是缺乏http://VB.NET。根据Tiobe发布2019年6月编程语言排行榜，VB.NET还排在c#。我想跟我一样一直用vb.net朋友，很希望找到类似的实例。2、LINK.ddsdk钉钉类库介绍为此我根据钉钉官方提供的c#sdk文件，重新改写成http://VB.NET开发的dll类库，方便http://vb.net用...
Python实现钉钉自定义机器人示例及加签方法
通过以上步骤，你可以在Python中成功实现与钉钉自定义机器人的交互，发送各种类型的消息到指定的钉钉群。这不仅可以提高工作效率，也能确保团队成员及时收到关键信息。在实际开发过程中，根据具体需求调整消息格式和...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值