Webhook,也叫Web钩子。当事件发生时,Web钩子自动发出HTTP POST请求。

一、概述

钉钉群机器人用途:

消息发送

事件通知

系统业务通知

监控报警

其它自定义消息等

二、使用方法

(1)创建群聊

发起群聊,创建任意一个3人以上的群,选择任意2个好友即可(至少2个以上)。

如果不想加入其他人,创建后再T出群就好,少于3人不能建群。

(2)添加机器人

步骤一,打开机器人管理页面。以PC端为例,打开PC端钉钉,点击头像,选择“机器人管理”。

钉钉人员架构获取接口 钉钉构架权限在哪儿_IP

步骤二,在机器人管理页面选择“自定义”机器人,输入机器人名字并选择要发送消息的群,同时可以为机器人设置机器人头像。

钉钉人员架构获取接口 钉钉构架权限在哪儿_Web_02

步骤三,完成必要的安全设置(至少选择一种),勾选 我已阅读并同意《自定义机器人服务及免责条款》,点击“完成”。安全设置目前有3种方式,设置说明见下文介绍。

钉钉人员架构获取接口 钉钉构架权限在哪儿_php钉钉webhook机器人_03

步骤四,完成安全设置后,复制出机器人的Webhook地址,可用于向这个群发送消息,格式如下:

https://oapi.dingtalk.com/robot/send?access_token=XXXXXX

注意:请保管好此Webhook 地址,不要公布在外部网站上,泄露后有安全风险。

三、安全设置

安全设置目前有3种方式:

(1)方式一,自定义关键词

最多可以设置10个关键词,消息中至少包含其中1个关键词才可以发送成功。

例如:添加了一个自定义关键词:监控报警

则这个机器人所发送的消息,必须包含 监控报警 这个词,才能发送成功。

(2)方式二,加签

(3)方式三,IP地址(段)

设定后,只有来自IP地址范围内的请求才会被正常处理。支持两种设置方式:IP、IP段,暂不支持IPv6地址白名单,格式如下:

钉钉人员架构获取接口 钉钉构架权限在哪儿_php钉钉webhook机器人_04

注意:安全设置的上述三种方式,需要至少设置其中一种,以进行安全保护。校验不通过的消息将会发送失败。

四、使用建议

同一个群,可以在群助手里添加多个机器人

建议添加3个自定义Webhook机器人,对应3种安全设置,在不同的场景用不同的接口

钉钉人员架构获取接口 钉钉构架权限在哪儿_钉钉人员架构获取接口_05

使用场景有:

Github、Gitlab、Gitea等可使用加签类型或自定义关键词

acme.sh 脚本可使用关键词类型webhook

宝塔等可使用IP类型的webhook

webhook接口可自定义实现