一、简介
cgai-DD是专门处理钉钉群机器人的python3 API，支持官方提供的5种格式：
- 文本信息
- 网页链接
- markdown
- ActionCard
- 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库
体育老师再也不用担心我算不出时间了
###### 帮助说明 [链接](https://zhuanlan.zhihu.com/p/391348944)
"""
title = 'cgai-time分享'
dd.sendMarkdown(WEBHOOK,markdown,title)
发送ActionCard
markdown = """
### 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)
