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

新逸Cary 190 0
广告

 

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

一、概述

钉钉群机器人用途:

  • 消息发送
  • 事件通知
  • 系统业务通知
  • 监控报警
  • 其它自定义消息等

二、使用方法

(1)创建群聊

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

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

(2)添加机器人

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

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

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

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

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

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

  1. 步骤四,完成安全设置后,复制出机器人的Webhook地址,可用于向这个群发送消息,格式如下:
https://oapi.dingtalk.com/robot/send?access_token=XXXXXX

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

三、安全设置

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

  • (1)方式一,自定义关键词
    最多可以设置10个关键词,消息中至少包含其中1个关键词才可以发送成功。
    例如:添加了一个自定义关键词:监控报警
    则这个机器人所发送的消息,必须包含 监控报警 这个词,才能发送成功。
  • (2)方式二,加签
  • (3)方式三,IP地址(段)
    设定后,只有来自IP地址范围内的请求才会被正常处理。支持两种设置方式:IP、IP段,暂不支持IPv6地址白名单,格式如下:

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

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

四、使用建议

  1. 同一个群,可以在群助手里添加多个机器人
  2. 建议添加3个自定义Webhook机器人,对应3种安全设置,在不同的场景用不同的接口

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

  1. 使用场景有:

本文链接:https://www.cary.tech/article/526.html

原文链接:https://blog.xinac.cn/archives/dingtalk-webhook.html


 

发表评论 取消回复
表情 图片 链接 代码

分享