群晖NAS发送钉钉群消息通知教程

群晖NAS可以发送邮件通知和短信通知，用于系统消息发送和系统出现故障时发送通知等用途。DSM系统提供了几个默认的短信服务商，都是大家没见过的，使用体验也不好。不过DSM系统可以新增短信服务商，这样就有的玩了。

利用DSM系统的自定义短信服务功能，我们可以把通知消息发送到钉钉群。实际上就是发送一个GET/POST请求到指定的服务器。默认直接发送到钉钉的消息是无法被接收的，因为需要有对应的参数、正确的消息签名和正确的消息格式，钉钉才能处理消息并发送到钉钉群里。

作者自建了一个服务接口，可以将收到的消息直接转发到对应的钉钉群，下边是使用方法。

1、准备工作

创建钉钉群，并加入自定义群机器人。[钉钉群消息机器人Webhook接口使用方法]

2、新建短信服务提供商

3、填写名称和网址

名称：任意字符

网址：

https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&keyword=<keyword>

方法：GET/POST

4、HTTP请求标题

此处可填写token和secret的值。在此设置后，url中不需要再次设置相应参数。

此处可不填写，需要将所有参数放到url中。

5、网址参数映射类型

下拉可以选择参数类型，发件人、短信内容、电话号码是必须要选的。

短信内容必须是 text=hello world，其中hello world是DSM系统要识别的内容，text为api接口要接收的内容，后续收到消息时，dsm系统会将hello world替换为对应的消息内容发送至api接口。

6、测试短信发送

点击应用保存，回到短信设置界面。发件人和主要电话号码必须填写。

点击应用，然后点击寄送测试短信按钮，正常情况下可收到钉钉群的消息。

7、api接口参数说明

接口网址：https://api.xinac.net/dingtalk

token：<access_token>，钉钉自定义机器人的access_token，必填

text：消息内容字符串，必填，DSM系统中固定为  hello world

keyword：钉钉消息关键字，与 secret 选填一个

secret：钉钉消息签名密钥，与 keyword 选填一个

最终格式为：

https://api.xinac.net/dingtalk?token=<access_token>&text=<text>&keyword=<keyword>

或：

https://api.xinac.net/dingtalk?token=<access_token>&text=<text>&secret=<secret>

用于dsm系统短信发送的网址示例：

https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&keyword=<keyword>

或：

https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&secret=<secret>

GitHub：xinac721/api_dingtalk

使用说明：https://api.xinac.net/dingtalk