cgai-DD钉钉群机器人python3 API

一、简介

cgai-DD是专门处理钉钉群机器人的python3 API，支持官方提供的5种格式：

1. 文本信息
2. 网页链接
3. markdown
4. ActionCard
5. Freecard

二、安装

pip install cgai-DD

三、创建并获取群机器人Hook

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

找到智能群助手

2.点击"添加机器人"

添加机器人 添加机器人

3.添加"自定义"

自定义 添加

4.自定义设置

说明：必须要选择一种安全设置才能添加机器人。
自定义关键词：所发送的信息中必须包含该关键词，无论是标题还是内容。
加签名：需要HmacSHA256算法计算签名，然后拼接到请求地址中，具体参考HmacSHA256算法
IP地址(段): 仅支持指定的IP或者IP段提供的请求

设置

5.获取Webhook

创建成功后，会获得Webhook

Webhook

四、使用案例

import cgai_DD as dd

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

发送文本信息

dd.sendMessage(WEBHOOK,'发送的内容')

发送连接

message_url = r'https://zhuanlan.zhihu.com/p/391348944'
title = 'CGAI-time'
text = 'cgai-time一个简单又实用的时间日期处理python库'
pic_url = 'https://obohe.com/i/2021/08/06/ikclyn.jpg'

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

发送markdown

pic_url = 'https://obohe.com/i/2021/08/06/e1qrsr.png'
markdown = """
## cgai-time一个简单又实用的时间日期处理python库
体育老师再也不用担心我算不出时间了
![img](https://obohe.com/i/2021/08/06/ikclyn.jpg)
###### 帮助说明 [链接](https://zhuanlan.zhihu.com/p/391348944)
"""
title = 'cgai-time分享'

dd.sendMarkdown(WEBHOOK,markdown,title)

发送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)

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

发送Freecard

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

links = [{"title":"标题1","messageURL":url,"picURL":pic_url},
         {"title":"标题2","messageURL":url,"picURL":pic_url}]

dd.sendFreeCard(WEBHOOK,links)