釘釘群機(jī)器人配置

在互聯(lián)網(wǎng)企業(yè)中，數(shù)字化辦公早已經(jīng)不是什么新鮮事了，其中以釘釘為代表的工具更是其中的主力軍。目前公司中釘釘?shù)氖褂靡呀?jīng)較為普及，像釘釘打卡、釘釘會(huì)議室、釘盤等。本小節(jié)將針對(duì)釘釘群機(jī)器人進(jìn)行介紹，助力利用釘釘群機(jī)器人實(shí)現(xiàn)高效、靈活的辦公。

1. 釘釘群機(jī)器人介紹

釘釘群機(jī)器人是在釘釘群中使用，群機(jī)器人是釘釘為用戶提供的智能群助手，幫助群里溝通協(xié)同更加高效。在【群設(shè)置】-【智能群助手】可以找到（如下圖）。目前群里支持最多添加 6 個(gè)機(jī)器人。

在添加群機(jī)器人這里可以看到，釘釘已經(jīng)為我們提供了可以添加的機(jī)器人如下圖所示，也可以使用釘釘官方機(jī)器人小釘，還可以添加 Github 等機(jī)器人或添加企業(yè)機(jī)器人。

當(dāng)然如果以上這些都無(wú)法滿足你的需求，你還可以自定義機(jī)器人。這也是本小節(jié)的主要內(nèi)容。

通過(guò)本小節(jié)的學(xué)習(xí)，我們將自定義一個(gè)群機(jī)器人，實(shí)現(xiàn)信息的發(fā)送功能，如下圖所示。

2. 創(chuàng)建一個(gè)自定義機(jī)器人

開(kāi)啟自定義機(jī)器人步驟，首先找到想要加入群機(jī)器人的釘釘群，在【群設(shè)置】-【智能群助手】，進(jìn)入后如下圖所示。

選擇【添加機(jī)器人】，進(jìn)入到添加界面，如下圖所示。

在這里展示本群已加入的機(jī)器人，如需添加新的機(jī)器人，點(diǎn)擊【添加機(jī)器人】進(jìn)入到添加界面，如下圖所示。

在添加界面，選擇自定義機(jī)器人，如下圖所示。

配置項(xiàng)解釋：

1. 機(jī)器人名字：即添加到釘釘群中的機(jī)器人所顯示的名稱，本小節(jié)中命名為” 小 Q“

2. 添加到群組：即該機(jī)器人所加入的釘釘群，這里為只讀顯示，不可更改

3. 安全設(shè)置：

   • 自定義關(guān)鍵詞：即當(dāng)發(fā)送消息中包含至少一個(gè)指定關(guān)鍵詞才可以發(fā)送成功，最多可以設(shè)置 10 個(gè)關(guān)鍵詞。例如：添加了一個(gè)自定義關(guān)鍵詞：監(jiān)控報(bào)警，則這個(gè)機(jī)器人所發(fā)送的消息，必須包含 “監(jiān)控報(bào)警” 這個(gè)詞，才能發(fā)送成功。

   • 加簽：即通過(guò)時(shí)間戳 + 密鑰當(dāng)做簽名字符串，使用 HmacSHA256 算法計(jì)算簽名，然后進(jìn)行 Base64 encode，最后再把簽名參數(shù)再進(jìn)行 urlEncode，得到最終的簽名，在發(fā)送請(qǐng)求時(shí)帶著加密后的簽名進(jìn)行通信。

   • IP 地址（段）：即設(shè)定后，只有來(lái)自 IP 地址范圍內(nèi)的請(qǐng)求才會(huì)被正常處理。支持兩種設(shè)置方式：IP、IP 段。

本小節(jié)中采用第一種自定義關(guān)鍵詞的形式進(jìn)行添加自定義機(jī)器人小 Q，配置內(nèi)容如下圖所示。

勾選服務(wù)條款，點(diǎn)擊完成按鈕，如下圖所示。

到這一步，我們就已經(jīng)完成了自定義機(jī)器人的創(chuàng)建，但只是第一步，第二步還需要在代碼中操作機(jī)器人。這里注意獲取到 Webhook 地址后，用戶可以向這個(gè)地址發(fā)起 HTTP 請(qǐng)求，即可實(shí)現(xiàn)給該釘釘群發(fā)送消息。

Tips：在發(fā)起 HTTP 請(qǐng)求時(shí)，必須將字符集編碼設(shè)置成 UTF-8。

3. 結(jié)合 requests 發(fā)送消息

得到 Webhook 地址后，就可以通過(guò)自定義機(jī)器人向釘釘群中發(fā)送消息了，目前發(fā)送消息的類型支持文本 (text)、鏈接 (link)、markdown (markdown)、ActionCard、FeedCard，大家可以根據(jù)自己的使用場(chǎng)景選擇合適的消息類型。

下面結(jié)合 requests 發(fā)送一條普通文本信息，代碼如下所示。

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": "監(jiān)測(cè)預(yù)警"+"hello world"
    },
    "isAtAll": True
}
response = requests.post(url, json.dumps(data), headers=HEADERS)

代碼解釋：將 Webhook 地址保存在變量 url 中，作為 request 發(fā)起 post 請(qǐng)求時(shí)的請(qǐng)求地址，傳遞參數(shù) data 中，其中 msgtype 為消息類型，“text” 為普通文本，配置項(xiàng)第二個(gè) text 為發(fā)送的內(nèi)容，isAtAll 為布爾值，是否 @ 所有人，如果設(shè)置為 False，可以通過(guò) atMobiles，@指定人（atMobiles 處配置手機(jī)號(hào)碼）。代碼執(zhí)行完成后，即完成了第一條釘釘群機(jī)器人的信息發(fā)送，效果如下圖所示：

4. 小結(jié)

本節(jié)課程我們主要學(xué)習(xí)了釘釘群機(jī)器人的配置和信息發(fā)送。本節(jié)課程的重點(diǎn)如下：

• 了解釘釘群機(jī)器人的作用及使用步驟；
• 掌握結(jié)合 requests 完成文本信息的發(fā)送；