php钉钉webhook机器人,钉钉群消息机器人Webhook接口使用方法

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接口可自定义实现