发送消息给dingtalk机器人
dingdingrobot的Python项目详细描述
功能
- 发送消息到钉钉机器人。
- 支持所有钉钉机器人消息类型。
- 钉钉机器人支持多种安全设置,建议在设置时选择IP地址。
- 钉钉机器人开发文档
安装
1. 安装该模块
pip install dingdingrobot
使用
获取钉钉机器人的
access_token
创建机器人时,会返回一个
webhook
的地址,如https://oapi.dingtalk.com/robot/send?access_token=053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9
,则access_token
为053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9
使用
key='053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9'importdingdingrobotdtrobot=dingdingrobot.DingtalkRobot(key)
发送文本消息
# 签名dtrobot.send_text(content,at_mobiles=None)# content 为要发送的文本内容# at_mobiles 需要 @ 人的手机号,可以是列表或字符串。如果要 @所有人,则设置 at_mobiles='all'。# @ 多个人时,指定 at_mobiles=['18600000000', '18600000001'] 或 at_mobiles='18600000000,18600000001'
发送
markdown
消息# 签名dtrobot.send_markdown(title,contents,at_mobiles=None)# title 指定markdwon消息显示的标题# contents 为可迭代对象,如列表、元组等。每一行为一个 markdown 格式的字符串。# at_mobiles 需要@人的手机号,参考 send_text 中的 at_mobiles# 支持的格式参考:https://ding-doc.dingtalk.com/document#/org-dev-guide/qf2nxq/9e91d73c
发送
link
类型# 签名dtrobot.send_link(title,text,jump_url,picurl=None)# title 消息标题# text 消息内容# jump_url 点击消息跳转的url# picurl 图片的url
发送
actionCard
# 签名dtrobot.send_actioncard(title,text,btn_info,btns=False,btn_orientation=0)# title 指定 action card的标题# text 指定 action card的文本内容# btn_info 指定 button 的信息。格式为:[{'btn_title': 'title', 'btn_url': 'button url'}]# btns False整体跳转, True 独立跳转。默认是 False# btn_orientation button的排列方式。0按钮竖直排列,1按钮水平排列
发送
feedCard
# 签名dtrobot.send_feedcard(links)# links 格式为:[{'link_title': 'link title', 'message_url': 'message url', 'pic_url': 'pictur url'}]
示例
key='you access token'dtrobot=dingdingrobot.DingdingRobot(key)# 发送 text 消息dtrobot.send_text('123'))# 发送 markdown 消息dtrobot.send_markdown(title='123',contents=['# hello world','> 1','> 2','> 3','4'],at_mobiles='18600010001,18655750614,all')# 发送 link 消息dtrobot.send_link(title='MAKA做出好设计',text='MAKA做出好设计',jump_url='https://www.maka.im',picurl='https://img1.maka.im/template/T_XM3SO6TE_t1.jpg'))# 发送 actionCarddtrobot.send_actioncard(title='MAKA做出好设计',text='MAKA做出好设计',btn_info=[{'btn_title':'MAKA官网','btn_url':'https://www.maka.im'},{'btn_title':'MAKA做出好设计','btn_url':'https://maka.im'}],btns=True),1)# 发送 feedCarddtrobot.send_feedcard([{'link_title':'MAKA做出好设计','message_url':'https://www.maka.im','pic_url':'https://res.maka.im/platV5Cms/homepage/icon/Group22%402x.png?x-oss-process=image/format,webp'},{'link_title':'link title','message_url':'https://www.maka.im/muban','pic_url':'https://img1.maka.im/template/T_XM3SO6TE_t1.jpg'}])
- 项目
标签: