CLR_Dingtalk_MessageSend 企业钉钉发送消息接口 - .Net 平台标准存储过程&函数&CLR方法

# 1 概述
调用本函数在企业钉钉中发送工作通知消息。工作通知消息是以某个应用的名义推送到员工的工作通知消息，消息格式可以有 文本、图片，文件等方式

# 2 安装 CLR

![](/media//202210/22_1665988739.png)

# 3 CLR_Dingtalk_MessageSend 接口 参数说明

```sql
@LocalWCFUrl [nvarchar](100) = N'',				-- WCFUrl地址
@Appkey [nvarchar](500) = N'',					-- 企业钉钉的 Appkey
@Appsecret [nvarchar](500) = N'',				-- 企业钉钉的 Appsecret
@FilePath [nvarchar](500) = N'',				-- 要发送的文件(在服务器上的物理路径，如：'D:\Test.png')
@JsonString [nvarchar](max),					-- 发文消息格式的Json字符串
@I_ReturnMessage [nvarchar](4000) = N'' OUTPUT	-- 返回结果
```
1）其中 **@Appkey** 和 **@Appsecret** 两个参数可以在登录企业钉钉的开放平台,然后在指定的应用中获取。

![](/media//202210/33_1665988906.png)

# 4 调用示例 
下面以发送文本、图片、文件为例，说明具体调用方法和效果。
# 4.1 文本消息 ( text ) 
```sql
declare @I_ReturnMessage nvarchar(4000)
declare @JsonString nvarchar(4000) = N'{
	"agent_id":1781557548,
	"msg":{
		"msgtype":"text",
		"text":{
			"content":"钉钉消息推 推送时间 ' + CONVERT(nvarchar(4000), GETDATE(), 121) + N'" 
		}
	},
	"userid_list":"666257365725751976"
}'

exec CLR_Dingtalk_MessageSend
@LocalWCFUrl= '',
@Appkey = 'dingtela01zudbvtkjdn',
@Appsecret = 'HB3cha614alD3YYzcbHkMj-n6iykn_99y-7GWiL1dU6A9OktEU0MD6dU_XP29oUg',
@JsonString = @JsonString,
@I_ReturnMessage = @I_ReturnMessage output

select @I_ReturnMessage
```
json属性参数 **agent_id** 就是企业钉钉中应用的 AgentId,可以在登录企业钉钉的开放平台,然后在指定的应用中获取。

![](/media//202210/44_1665989561.png)

json属性参数 **userid_list** 表示要接收消息的钉钉用户ID列表，多个用户请用","分隔,钉钉用户ID可以在企业钉钉的后台管理中获取如下图：

![](/media//202211/2022-11-29_104504.png)

发送文本后效果如图：

![](/media//202211/2022-11-29_105010.png)

# 4.2 图片消息 ( image )
```sql
declare @I_ReturnMessage nvarchar(4000)
declare @JsonString nvarchar(4000) = N'{
	"agent_id":1781557548,
	"msg":{
		"msgtype": "image",
		"image": {
			"media_id": "@media_id"
		}
	},
	"userid_list":"666257365725751976"
}'

exec CLR_Dingtalk_MessageSend
@LocalWCFUrl= '',
@Appkey = 'dingtela01zudbvtkjdn',
@Appsecret = 'HB3cha614alD3YYzcbHkMj-n6iykn_99y-7GWiL1dU6A9OktEU0MD6dU_XP29oUg',
@FilePath = 'D:\hlxt.png',
@JsonString = @JsonString,
@I_ReturnMessage = @I_ReturnMessage output

select @I_ReturnMessage
```
发送图片后效果如图：

![](/media//202211/2022-11-29_105033.png)

# 4.3 文件消息 ( file ) 
```sql
declare @I_ReturnMessage nvarchar(4000)
declare @JsonString nvarchar(4000) = N'{
	"agent_id":1781557548,
	"msg":{
		"msgtype": "file",
		"file": {
			"media_id": "@media_id"
		}
	},
	"userid_list":"666257365725751976"
}'

exec CLR_Dingtalk_MessageSend
@LocalWCFUrl= '',
@Appkey = 'dingtela01zudbvtkjdn',
@Appsecret = 'HB3cha614alD3YYzcbHkMj-n6iykn_99y-7GWiL1dU6A9OktEU0MD6dU_XP29oUg',
@FilePath = 'D:\ftp\FtpFile\202211\FTP10000026F212121.xlsx',
@JsonString = @JsonString,
@I_ReturnMessage = @I_ReturnMessage output

select @I_ReturnMessage
```
发送文件后效果如图：

![](/media//202211/2022-11-29_105050.png)