send message to dingtalk robot
Project description
功能
- 发送消息到钉钉机器人。
- 支持所有钉钉机器人消息类型。
- 钉钉机器人支持多种安全设置,建议在设置时选择IP地址。
- 钉钉机器人开发文档
安装
1. 安装该模块
pip install dingdingrobot
使用
-
获取钉钉机器人的
access_token
创建机器人时,会返回一个
webhook
的地址,如https://oapi.dingtalk.com/robot/send?access_token=053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9
,则access_token
为053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9
-
使用
key = '053e5481723dbe9b2e7765ece20118fa5963909d50f05ea6ae58214e9' import dingdingrobot dtrobot = 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
-
发送图片
# 签名 dtrobot.send_image(image_path) # image_path 支持 HTTP、HTTPS、FTP,互联网上的图片URL。也支持本地的图片路径。 # 如 dtrobot.send_image('https://img1.maka.im/template/T_G29KRHKN_t1.jpg')
-
发送
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'))
# 发送 actionCard
dtrobot.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)
# 发送 feedCard
dtrobot.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'}
]
)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for dingdingrobot-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7983c76342c09b4f09c5e66e9823fb453cbe5e17fe15d44da32fb5cc9ef34b30 |
|
MD5 | 0e6a9447e83ef2e364d640087b24ac00 |
|
BLAKE2b-256 | ae05c149581266205622abc72e3671bd9eb612ec158308d7088a260e32b15d77 |