钉钉群消息机器人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接口可自定义实现
- 官方开发文档：https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq
本文由 新逸Cary 创作，如果您觉得本文不错，请随意赞赏
采用 知识共享署名4.0 国际许可协议进行许可
本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名
原文链接：https://blog.xinac.cn/archives/dingtalk-webhook.html
最后更新：2020-07-03 19:16:15
![国内 Java 开发者必备的两个装备，你配置上了么？[转]](https://alicdn.xinac.net/blog/java_logo_1590060514161.jpg){kind=logo}
