章节索引 :

钉钉群机器人配置

在互联网企业中,数字化办公早已经不是什么新鲜事了,其中以钉钉为代表的工具更是其中的主力军。目前公司中钉钉的使用已经较为普及,像钉钉打卡、钉钉会议室、钉盘等。本小节将针对钉钉群机器人进行介绍,助力利用钉钉群机器人实现高效、灵活的办公。

1. 钉钉群机器人介绍

钉钉群机器人是在钉钉群中使用,群机器人是钉钉为用户提供的智能群助手,帮助群里沟通协同更加高效。在【群设置】-【智能群助手】可以找到(如下图)。目前群里支持最多添加 6 个机器人。

图片描述

在添加群机器人这里可以看到,钉钉已经为我们提供了可以添加的机器人如下图所示,也可以使用钉钉官方机器人小钉,还可以添加 Github 等机器人或添加企业机器人。

图片描述

当然如果以上这些都无法满足你的需求,你还可以自定义机器人。这也是本小节的主要内容。

通过本小节的学习,我们将自定义一个群机器人,实现信息的发送功能,如下图所示。

2. 创建一个自定义机器人

开启自定义机器人步骤,首先找到想要加入群机器人的钉钉群,在【群设置】-【智能群助手】,进入后如下图所示。

图片描述

选择【添加机器人】,进入到添加界面,如下图所示。

图片描述

在这里展示本群已加入的机器人,如需添加新的机器人,点击【添加机器人】进入到添加界面,如下图所示。

图片描述

在添加界面,选择自定义机器人,如下图所示。

图片描述

配置项解释:

  1. 机器人名字:即添加到钉钉群中的机器人所显示的名称,本小节中命名为” 小 Q“

  2. 添加到群组:即该机器人所加入的钉钉群,这里为只读显示,不可更改

  3. 安全设置

    • 自定义关键词:即当发送消息中包含至少一个指定关键词才可以发送成功,最多可以设置 10 个关键词。例如:添加了一个自定义关键词:监控报警,则这个机器人所发送的消息,必须包含 “监控报警” 这个词,才能发送成功。

    • 加签:即通过时间戳 + 密钥当做签名字符串,使用 HmacSHA256 算法计算签名,然后进行 Base64 encode,最后再把签名参数再进行 urlEncode,得到最终的签名,在发送请求时带着加密后的签名进行通信。

    • IP 地址(段):即设定后,只有来自 IP 地址范围内的请求才会被正常处理。支持两种设置方式:IP、IP 段。

本小节中采用第一种自定义关键词的形式进行添加自定义机器人小 Q,配置内容如下图所示。

图片描述

勾选服务条款,点击完成按钮,如下图所示。

图片描述

到这一步,我们就已经完成了自定义机器人的创建,但只是第一步,第二步还需要在代码中操作机器人。这里注意获取到 Webhook 地址后,用户可以向这个地址发起 HTTP 请求,即可实现给该钉钉群发送消息。

Tips:在发起 HTTP 请求时,必须将字符集编码设置成 UTF-8。

3. 结合 requests 发送消息

得到 Webhook 地址后,就可以通过自定义机器人向钉钉群中发送消息了,目前发送消息的类型支持文本 (text)、链接 (link)、markdown (markdown)、ActionCard、FeedCard,大家可以根据自己的使用场景选择合适的消息类型。

下面结合 requests 发送一条普通文本信息,代码如下所示。

import json
import requests

HEADERS = {"Content-Type": "application/json;charset=utf-8"}
url = "https://oapi.dingtalk.com/robot/send?access_token=c01697dd3c97efecd727491693a2ead2d668e8c5dabeb0c3604f545821fc72b7"
data = {
    "msgtype": "text",
    "text": {
        "content": "监测预警"+"hello world"
    },
    "isAtAll": True
}
response = requests.post(url, json.dumps(data), headers=HEADERS)

代码解释:将 Webhook 地址保存在变量 url 中,作为 request 发起 post 请求时的请求地址,传递参数 data 中,其中 msgtype 为消息类型,“text” 为普通文本,配置项第二个 text 为发送的内容,isAtAll 为布尔值,是否 @ 所有人,如果设置为 False,可以通过 atMobiles,@指定人(atMobiles 处配置手机号码)。代码执行完成后,即完成了第一条钉钉群机器人的信息发送,效果如下图所示:

图片描述

4. 小结

本节课程我们主要学习了钉钉群机器人的配置和信息发送。本节课程的重点如下:

  • 了解钉钉群机器人的作用及使用步骤;
  • 掌握结合 requests 完成文本信息的发送;

图片描述