cgai-DD钉钉群机器人python3 API

一、简介

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

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

二、安装

pip install cgai-DD

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

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

cgai-DD钉钉群机器人python3 API_第1张图片

2.点击"添加机器人"

cgai-DD钉钉群机器人python3 API_第2张图片

cgai-DD钉钉群机器人python3 API_第3张图片

3.添加"自定义"

cgai-DD钉钉群机器人python3 API_第4张图片

cgai-DD钉钉群机器人python3 API_第5张图片

4.自定义设置

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

5.获取Webhook

创建成功后,会获得Webhook
cgai-DD钉钉群机器人python3 API_第7张图片

四、使用案例

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)

你可能感兴趣的:(钉钉,钉钉,群机器人,python,API)