群晖NAS可以发送邮件通知和短信通知,用于系统消息发送和系统出现故障时发送通知等用途。DSM系统提供了几个默认的短信服务商,都是大家没见过的,使用体验也不好。不过DSM系统可以新增短信服务商,这样就有的玩了。文章源自新逸网络-https://www.xinac.net/9210.html
利用DSM系统的自定义短信服务功能,我们可以把通知消息发送到钉钉群。实际上就是发送一个GET/POST请求到指定的服务器。默认直接发送到钉钉的消息是无法被接收的,因为需要有对应的参数、正确的消息签名和正确的消息格式,钉钉才能处理消息并发送到钉钉群里。文章源自新逸网络-https://www.xinac.net/9210.html
作者自建了一个服务接口,可以将收到的消息直接转发到对应的钉钉群,下边是使用方法。文章源自新逸网络-https://www.xinac.net/9210.html
文章源自新逸网络-https://www.xinac.net/9210.html
1、准备工作
创建钉钉群,并加入自定义群机器人。[钉钉群消息机器人Webhook接口使用方法]文章源自新逸网络-https://www.xinac.net/9210.html
2、新建短信服务提供商
文章源自新逸网络-https://www.xinac.net/9210.html
3、填写名称和网址
名称:任意字符文章源自新逸网络-https://www.xinac.net/9210.html
网址:文章源自新逸网络-https://www.xinac.net/9210.html
https://api.xinac.net/dingtalk?token=<access_token>&text=hello world&desp=text&number=0&keyword=<keyword>
方法:GET/POST文章源自新逸网络-https://www.xinac.net/9210.html
文章源自新逸网络-https://www.xinac.net/9210.html
4、HTTP请求标题
此处可填写token
和secret
的值。在此设置后,url中不需要再次设置相应参数。文章源自新逸网络-https://www.xinac.net/9210.html
此处可不填写,需要将所有参数放到url中。文章源自新逸网络-https://www.xinac.net/9210.html
文章源自新逸网络-https://www.xinac.net/9210.html
5、网址参数映射类型
下拉可以选择参数类型,发件人、短信内容、电话号码是必须要选的。文章源自新逸网络-https://www.xinac.net/9210.html
短信内容必须是 text=hello world
,其中hello world
是DSM系统要识别的内容,text
为api接口要接收的内容,后续收到消息时,dsm系统会将hello world
替换为对应的消息内容发送至api接口。文章源自新逸网络-https://www.xinac.net/9210.html
文章源自新逸网络-https://www.xinac.net/9210.html
6、测试短信发送
点击应用保存,回到短信设置界面。发件人和主要电话号码必须填写。文章源自新逸网络-https://www.xinac.net/9210.html
点击应用,然后点击寄送测试短信按钮,正常情况下可收到钉钉群的消息。文章源自新逸网络-https://www.xinac.net/9210.html
文章源自新逸网络-https://www.xinac.net/9210.html
7、api接口参数说明
接口网址:https://api.xinac.net/dingtalk
文章源自新逸网络-https://www.xinac.net/9210.html
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
- v1.1
1. 支持在 header 头中传递 token 和 secret 参数
2. 增加接口首页 html 页面
3. 支持发送 GET 和 POST 请求
- v1.2
1. 支持发送固定IP消息,需在钉钉机器人中设置固定IP(`固定IP可通过 nslookup api.xinac.net 命令查询`)
2. 支持直接向API发送钉钉 text 格式的消息体,可用于BT面板等消息通知
3F
v1.3.0版本已使用Flask重写,一直想加入页面调试功能,页面没做出来。待后台再稳定一下开源。
2F
好用,666
1F
你好,我用的办法已经成功了,但是想问一下 我如何能搭建你这样的接口接口网址:https://api.xinac.net/dingtalk
怕你说明时候停止服务了
B1
@ JIAN 同求,1.3的搭建
B2
@ sam457 摸索了下,用flask搭建了个webhook中转服务器,ok。