一、簡(jiǎn)介

cgai-DD是專(zhuān)門(mén)處理釘釘群機(jī)器人的python3 API，支持官方提供的5種格式：

1. 文本信息
2. 網(wǎng)頁(yè)鏈接
3. markdown
4. ActionCard
5. Freecard

二、安裝

pip install cgai-DD

三、創(chuàng)建并獲取群機(jī)器人Hook

1.在釘釘桌面版里找到"智能群助手"

找到智能群助手

2.點(diǎn)擊"添加機(jī)器人"

添加機(jī)器人

添加機(jī)器人

3.添加"自定義"

自定義

添加

4.自定義設(shè)置

說(shuō)明：必須要選擇一種安全設(shè)置才能添加機(jī)器人。
自定義關(guān)鍵詞：所發(fā)送的信息中必須包含該關(guān)鍵詞，無(wú)論是標(biāo)題還是內(nèi)容。
加簽名：需要HmacSHA256算法計(jì)算簽名，然后拼接到請(qǐng)求地址中，具體參考HmacSHA256算法
IP地址(段): 僅支持指定的IP或者IP段提供的請(qǐng)求

設(shè)置

5.獲取Webhook

創(chuàng)建成功后，會(huì)獲得Webhook

Webhook

四、使用案例

import cgai_DD as dd

WEBHOOK = 'https://oapi.dingtalk.com/robot/send?access_token=xxxxxx'

發(fā)送文本信息

dd.sendMessage(WEBHOOK,'發(fā)送的內(nèi)容')

發(fā)送連接

message_url = r'https://zhuanlan.zhihu.com/p/391348944'
title = 'CGAI-time'
text = 'cgai-time一個(gè)簡(jiǎn)單又實(shí)用的時(shí)間日期處理python庫(kù)'
pic_url = 'https://obohe.com/i/2021/08/06/ikclyn.jpg'

dd.sendLink(WEBHOOK,message_url,title,text,pic_url)

發(fā)送markdown

pic_url = 'https://obohe.com/i/2021/08/06/e1qrsr.png'
markdown = """
## cgai-time一個(gè)簡(jiǎn)單又實(shí)用的時(shí)間日期處理python庫(kù)
體育老師再也不用擔(dān)心我算不出時(shí)間了
![img](https://obohe.com/i/2021/08/06/ikclyn.jpg)
###### 幫助說(shuō)明 [鏈接](https://zhuanlan.zhihu.com/p/391348944)
"""
title = 'cgai-time分享'

dd.sendMarkdown(WEBHOOK,markdown,title)

發(fā)送ActionCard

markdown = """
![img](https://obohe.com/i/2021/08/06/ikclyn.jpg)
### cgai-time
"""
showTitle = 'cgai-time'
singleTitle = '閱讀文章'
url = 'https://zhuanlan.zhihu.com/p/391348944'

# 整體ActionCard
dd.sendActionCard(WEBHOOK,markdown,showTitle,singleTitle,url,btnOrientation=1)

# 獨(dú)立ActionCard
btns = [{"title":'鏈接1',"actionURL":url},{"title":'鏈接2',"actionURL":url}]
dd.sendActionsCard(WEBHOOK,markdown,showTitle,singleTitle,url,btns,btnOrientation=0)

發(fā)送Freecard

url = 'https://zhuanlan.zhihu.com/p/391348944'
pic_url = 'https://obohe.com/i/2021/08/06/ikclyn.jpg'

links = [{"title":"標(biāo)題1","messageURL":url,"picURL":pic_url},
         {"title":"標(biāo)題2","messageURL":url,"picURL":pic_url}]

dd.sendFreeCard(WEBHOOK,links)