将纸壳CMS通知通过WebHook发送到钉钉
ZKEASOFT March 21, 2023
纸壳CMS支持将评论、留言、表单提交、订阅等通知,通过WebHook发送到第三方平台,比如钉钉。
创建钉钉WebHook
需要在钉钉群中创建自定义机器人,具体方法可以参考钉钉的官方文档:
需要注意的是,在安全设置中不要使用加签,使用自定义关键字即可。在发送的消息中,只要包含这个关键字,就可以了,例如:
创建成功后,就可以到得一个类似这样的地址,复制这个地址,后面会用到它:
https://oapi.dingtalk.com/robot/send?access_token=47bcxxxxafb436854557
事件通知
接下来需要到CMS中创建一个事件通知。我们打开事件通知菜单下的通知,并点击新建
然后输入标题:通知发送到钉钉,事件选择:当留言板提交时,动作定义使用以下代码,POST后面就是刚才得到的钉钉WebHook地址
actions: #操作定义,支持多个
- name: http request (web hook) #当前执行操作的名称
uses: actions/http #使用HTTP请求
with: #参数定义
request: | #http请求定义
POST https://oapi.dingtalk.com/robot/send?access_token=47bcxxxxafb436854557
Content-Type: application/json
{"msgtype": "text","text": {"content":"收到新留言, {{this.Model.Title}}, {{this.Model.Email}}, {{this.Model.PostMessage}}"}}
如下图所示:
然后点击保存即可。
动作定义说明
动作定义里面使用的是YAML语法对事件将会执行的动作进行描述,可以执行多个动作,比如发邮件。
- uses: actions/http 表示使用HTTP发送请求
- with 是请求的参数
- request 是对请求的描述。
注意:通知不是即时的,会有0-1分钟左右的延迟。