Asp.NetCore對接釘釘群機(jī)器人的示例分析-創(chuàng)新互聯(lián)

這篇文章主要介紹了Asp.Net Core對接釘釘群機(jī)器人的示例分析，具有一定借鑒價(jià)值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

專注于為中小企業(yè)提供成都網(wǎng)站設(shè)計(jì)、成都網(wǎng)站建設(shè)服務(wù),電腦端+手機(jī)端+微信端的三站合一,更高效的管理,為中小企業(yè)富陽免費(fèi)做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都，凝聚了一批互聯(lián)網(wǎng)行業(yè)人才，有力地推動了上1000家企業(yè)的穩(wěn)健成長，幫助中小企業(yè)通過網(wǎng)站建設(shè)實(shí)現(xiàn)規(guī)模擴(kuò)充和轉(zhuǎn)變。

前言

釘釘作為企業(yè)辦公越來越常用的軟件，對于企業(yè)內(nèi)部自研系統(tǒng)提供接口支持，以此來打通多平臺下的數(shù)據(jù)，本次先使用最簡單的釘釘群機(jī)器人完成多種形式的消息推送，參考釘釘開發(fā)文檔中自定義機(jī)器人環(huán)節(jié)，此次嘗試所花的時(shí)間不多，但有幾個(gè)地方是需要注意的。

一、釘釘群中建立機(jī)器人獲取WebHook地址

首先得有一個(gè)釘釘群，如果沒有得自行創(chuàng)建一個(gè)了，通過群內(nèi)右上角菜單中找到群機(jī)器人然后添加一個(gè)自定義機(jī)器人

并設(shè)置消息推送開啟(默認(rèn)是開啟)，復(fù)制下一行的webhook地址，該地址將作為后面消息推送的地址

完成即可，如果不確定該地址是否有效可以用命令測試一下，比如在Linux平臺下，通過該命令并將自己的webhook_token替換

curl 'https://oapi.dingtalk.com/robot/send?access_token=cd1eb120c459ced6a65491af7b1eebbc84790fb672077a969bae8bb203aa1c52' \
 -H 'Content-Type: application/json' \
 -d '
 {"msgtype": "text", 
 "text": {
  "content": "我就是我, 是不一樣的煙火"
  }
 }'

然后回車進(jìn)行測試，即刻收到群機(jī)器人推送的消息　　

二、參考文檔完成基礎(chǔ)類的封裝并處理相關(guān)字段

接下來開始在代碼中完成對WebHook地址的調(diào)用，可以先分析一下群機(jī)器人的文檔，可以獲悉有五種消息類型：文本 (text)、連接 (link)、markdown(markdown)、ActionCard、FeedCard消息類型，其中的actionCard分整體和獨(dú)立兩類。針對這些類型及給出的參數(shù)要求完成基礎(chǔ)類的設(shè)計(jì)和封裝，以text類型為例：

其中的msgtype是五種消息類型的字符串，因此針對該部分設(shè)計(jì)一個(gè)枚舉，作為消息類型的區(qū)分。

/// <summary>
/// 釘釘群機(jī)器人消息類型枚舉
/// </summary>
public enum MsgTypeEnum
{
 text,
 link,
 markdown,
 actionCard,
 feedCard
}

設(shè)計(jì)一個(gè)text類并給定一個(gè)屬性Content，在設(shè)計(jì)時(shí)我們喜歡使用帕斯卡命名法，但是釘釘接口卻不允許，如果不做一些處理，直接使用Content屬性將會調(diào)用不通接口，這點(diǎn)需要注意，使用Newtonjson提供的打包成json時(shí)用指定的名稱替換來滿足釘釘接口需求。

/// <summary>
/// 文本類型
/// </summary>
public class Text
{
 /// <summary>
 /// 文本內(nèi)容
 /// </summary>
 [JsonProperty(PropertyName = "content")]
 public string Content { get; set; }
}

其次對指定人群做一個(gè)類的封裝，同樣需要處理其中的屬性在序列化時(shí)的替換名稱。

/// <summary>
/// @指定人
/// </summary>
public class At
{
 /// <summary>
 /// @的聯(lián)系人
 /// </summary>
 [JsonProperty(PropertyName = "atMobiles")]
 public List<string> AtMobiles { set; get; }

 /// <summary>
 /// 是否@所有人
 /// </summary>
 [JsonProperty(PropertyName = "isAtAll")]
 public bool IsAtAll { set; get; }
}

通過分析五種消息類型，其中的一些參數(shù)可以完成共用，對自定義釘釘機(jī)器人文檔的一系列挖掘后，確定了這幾個(gè)類和枚舉

接下來可以完成對機(jī)器人調(diào)用了并使用不同消息類型推送到釘釘群中。

三、完成對釘釘群機(jī)器人的調(diào)用

首先在ConfigureService方法中完成對HttpClientFactory的注入

本次直接在Asp.Net Core WebApi下完成機(jī)器人的調(diào)用，新建一個(gè)DingTalk的控制器，然后完成對IHttpClientFactory的注入工作，便開始接下來的服務(wù)調(diào)用了，對于釘釘?shù)腤ebHook_Token的存放可以選擇配置文件或是如果只是嘗試，可以直接用一個(gè)變量保存即可。

/// <summary>
/// 發(fā)送釘釘消息接口
/// </summary>
[Route("api/[controller]")]
[ApiController]
public class DingTalkController : ControllerBase
{
 private readonly string WebHook_Token = "https://oapi.dingtalk.com/robot/send?access_token=cd1eb120c459ced6a65491af7b1eebbc84790fb672077a969bae8bb203aa1c52";

 private readonly IHttpClientFactory _httpClientFactory;

 public DingTalkController(IHttpClientFactory httpClientFactory)
 {
  _httpClientFactory = httpClientFactory;
 }
}

再次以text文本為例并完成文本消息的推送，建立一個(gè)action，用來發(fā)送文本消息，在其中完成對釘釘接口需要參數(shù)的組裝工作，最終使用統(tǒng)一的發(fā)送方法完成消息推送。

/// <summary>
/// 調(diào)用釘釘機(jī)器人發(fā)送文本內(nèi)容
/// </summary>
/// <returns></returns>
[HttpGet]
[Route(nameof(TextContent))]
public async Task<ActionResult> TextContent()
{
 //消息類型
 var msgtype = MsgTypeEnum.text.ToString();

 //文本內(nèi)容
 var text = new Text
 {
  Content = "看萬山紅遍，層林盡染；漫江碧透，百舸爭流@15675120617"
 };

 //指定目標(biāo)人群
 var at = new At()
 {
  AtMobiles = new List<string>() { "15675120617" },
  IsAtAll = false
 };

 var response = await SendDingTalkMessage(new { msgtype, text, at });

 return Ok(response);
}

對于發(fā)送方法內(nèi)需要根據(jù)釘釘文檔的一些要求完成設(shè)計(jì)，如文檔指明需要使用Post提交請求并使用UTF8編碼，我直接在控制器內(nèi)新建了一個(gè)方法(盡管不太合理)，首先對內(nèi)容進(jìn)行序列化并封裝，然后通過HttpClientFactory新建client并完成發(fā)送消息。

/// <summary>
/// 執(zhí)行發(fā)送消息
/// </summary>
/// <param name="sendMessage"></param>
/// <returns></returns>
private async Task<HttpResponseMessage> SendDingTalkMessage(object value)
{
 var sendMessage = JsonConvert.SerializeObject(value);

 var request = new HttpRequestMessage(HttpMethod.Post, WebHook_Token)
 {
  //釘釘文檔需指定UTF8編碼
  Content = new StringContent(sendMessage, Encoding.UTF8, "application/json")
 };

 var client = _httpClientFactory.CreateClient();
 var response = await client.SendAsync(request);

 return response;
}

啟動程序并通過url訪問控制器內(nèi)的相應(yīng)方法完成消息推送，注意各屬性的命名方式或通過特性轉(zhuǎn)換后的命名方式需要滿足釘釘接口文檔(文檔中FeedCard類型后兩個(gè)參數(shù)不太標(biāo)準(zhǔn))。

感謝你能夠認(rèn)真閱讀完這篇文章，希望小編分享的“Asp.Net Core對接釘釘群機(jī)器人的示例分析”這篇文章對大家有幫助，同時(shí)也希望大家多多支持創(chuàng)新互聯(lián)網(wǎng)站建設(shè)公司，，關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道，更多相關(guān)知識等著你來學(xué)習(xí)!

網(wǎng)頁題目：Asp.NetCore對接釘釘群機(jī)器人的示例分析-創(chuàng)新互聯(lián)
URL標(biāo)題：http://bm7419.com/article16/dihdgg.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供商城網(wǎng)站、面包屑導(dǎo)航、小程序開發(fā)、企業(yè)建站、電子商務(wù)、網(wǎng)站營銷

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源： 創(chuàng)新互聯(lián)