Webhook,也叫Web钩子。当事件发生时,Web钩子自动发出HTTP POST请求。
一、概述
钉钉群机器人用途:
消息发送
事件通知
系统业务通知
监控报警
其它自定义消息等
二、使用方法
(1)创建群聊
发起群聊,创建任意一个3人以上的群,选择任意2个好友即可(至少2个以上)。
如果不想加入其他人,创建后再T出群就好,少于3人不能建群。
(2)添加机器人
步骤一,打开机器人管理页面。以PC端为例,打开PC端钉钉,点击头像,选择“机器人管理”。
步骤二,在机器人管理页面选择“自定义”机器人,输入机器人名字并选择要发送消息的群,同时可以为机器人设置机器人头像。
步骤三,完成必要的安全设置(至少选择一种),勾选 我已阅读并同意《自定义机器人服务及免责条款》,点击“完成”。安全设置目前有3种方式,设置说明见下文介绍。
步骤四,完成安全设置后,复制出机器人的Webhook地址,可用于向这个群发送消息,格式如下:
https://oapi.dingtalk.com/robot/send?access_token=XXXXXX
注意:请保管好此Webhook 地址,不要公布在外部网站上,泄露后有安全风险。
三、安全设置
安全设置目前有3种方式:
(1)方式一,自定义关键词
最多可以设置10个关键词,消息中至少包含其中1个关键词才可以发送成功。
例如:添加了一个自定义关键词:监控报警
则这个机器人所发送的消息,必须包含 监控报警 这个词,才能发送成功。
(2)方式二,加签
(3)方式三,IP地址(段)
设定后,只有来自IP地址范围内的请求才会被正常处理。支持两种设置方式:IP、IP段,暂不支持IPv6地址白名单,格式如下:
注意:安全设置的上述三种方式,需要至少设置其中一种,以进行安全保护。校验不通过的消息将会发送失败。
四、使用建议
同一个群,可以在群助手里添加多个机器人
建议添加3个自定义Webhook机器人,对应3种安全设置,在不同的场景用不同的接口
使用场景有:
Github、Gitlab、Gitea等可使用加签类型或自定义关键词
acme.sh 脚本可使用关键词类型webhook
宝塔等可使用IP类型的webhook
webhook接口可自定义实现