钉钉群机器人配置

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

1. 钉钉群机器人介绍

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

图片描述

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

图片描述

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

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

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

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

图片描述

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

图片描述

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

图片描述

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

图片描述

配置项解释：

机器人名字：即添加到钉钉群中的机器人所显示的名称，本小节中命名为” 小 Q“
添加到群组：即该机器人所加入的钉钉群，这里为只读显示，不可更改
安全设置：
- 自定义关键词：即当发送消息中包含至少一个指定关键词才可以发送成功，最多可以设置 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 完成文本信息的发送；

图片描述