Python第三方库DingDingBot：快速集成钉钉机器人消息通知
发布时间：2026-10-13| 5人浏览过
本文介绍Python第三方库DingDingBot的使用方法。该库封装了钉钉机器人API，支持发送文本、链接和Markdown格式消息。通过pip安装后，初始化Webhook即可调用Send_Text_Msg、Send_Link_Msg等方法实现告警通知等场景的消息推送，代码简洁易上手。
DingDingBot库简介
DingDingBot是一个由社区开发者封装的Python第三方库，主要用于简化与钉钉机器人的交互。目前该库主要支持发送三种格式的消息：纯文本、链接卡片以及Markdown格式。这一功能在各类自动化运维场景中非常实用，例如系统告警通知、业务状态播报等，能够帮助开发者快速构建消息推送能力。
安装
安装与基础配置
pip install DingDingBot使用方法
核心功能代码示例
from DingDingBot.DDBOT import DingDing
# 初始话DingDingBOt webhook是钉钉机器人所必须的
dd = DingDing(webhook='https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx')
# 发送文本消息
print(dd.Send_Text_Msg(Content='test:测试数据'))
# 发送链接消息
print(dd.Send_Link_Msg(Content='test',Title='测试数据',MsgUrl='https://www.baidu.com',PicUrl='https://cn.bing.com/images/search?q=outgoing%e6%9c%ba%e5%99%a8%e4%ba%ba&id=FEE700371845D9386738AAAA51DCC43DC54911AA&FORM=IQFRBA'))
# 发送Markdown格式的消息
print(dd.Send_MardDown_Msg(Content="# 测试数据\n" + "> testone", Title='测试数据'))
源码
源码结构与实现逻辑
#!/usr/bin/python
# -*- coding: UTF-8 -*-
'''
@@@@@@@@ @@@@@@@@@ @@@@@@@@@ @@@@@@@@@ @@@@@@@@@@@@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@ @@ @@ @@
@@ @@ @@ @@ @@ @@@@@@@@@ @@
'''
import requests, json
class DingDing():
"""
# 钉钉官方文档
Refer to official documentation: https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq
"""
# 初始化
def __init__(self, webhook):
self.webhook = webhook
self.session = requests.session()
self.session.headers = {"Content-Type": "application/json;charset=utf-8"}
def Send_Text_Msg(self, Content: str, atMobiles: list = [], isAtAll: bool = False) -> dict:
"""
:param content: 要发送的内容
:param atMobiles: @指定的人，这里必须是列表，且参数为手机号
:param isAtAll: @全体成员
:return:
"""
try:
data = {
"msgtype": "text",
"text": {
"content": Content
},
"at": {
"atMobiles": atMobiles,
"isAtAll": isAtAll
}
}
response = self.session.post(self.webhook, data=json.dumps(data))
if response.status_code == '200':
result = {"status": True, "message": "Message has been sent"}
return result
else:
return response.text
except Exception as error:
result = {"status": False, "message": f"Failed to send message,Error stack:{error}"}
return result
def Send_Link_Msg(self, Content: str, Title: str, MsgUrl: str, PicUrl: str = ''):
"""
:param Content: 链接的内容
:param title: 链接的标题
:param MsgUrl: 待跳转页面的url
:param PicUrl: 消息所展示的图片
:return:
"""
try:
data = {
"msgtype": "link",
"link": {
"text": Content,
"title": Title,
"picUrl": PicUrl,
"messageUrl": MsgUrl
}
}
response = self.session.post(self.webhook, data=json.dumps(data))
if response.status_code == '200':
result = {"status": True, "message": "Message has been sent"}
return result
else:
return response.text
except Exception as error:
result = {"status": False, "message": f"Failed to send message,Error stack:{error}"}
return result
def Send_MardDown_Msg(self, Content: str, Title: str, atMobiles: list = [], isAtAll: bool = False):
"""
:param Content: Markdown格式的文本，仅支持下面的格式
'''
标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
引用
> A man who stands for nothing will fall for anything.
文字加粗、斜体
**bold**
*italic*
链接
[this is a link](http://name.com)
图片
无序列表
- item1
- item2
有序列表
1. item1
2. item2
'''
:param Title: 这个Markdown的标题
:param atMobiles: @指定的人，这里必须是列表，且参数为手机号
:param isAtAll: @全体成员
:return:
"""
try:
data = {
"msgtype": "markdown",
"markdown": {
"title": Title,
"text": Content
},
"at": {
"atMobiles": atMobiles,
"isAtAll": isAtAll
}
}
response = self.session.post(self.webhook, data=json.dumps(data))
if response.status_code == '200':
result = {"status": True, "message": "Message has been sent"}
return result
else:
return response.text
except Exception as error:
result = {"status": False, "message": f"Failed to send message,Error stack:{error}"}
return result
总结来说，DingDingBot为Python开发者提供了一种轻量级的钉钉机器人集成方案。如需了解更多相关技术细节或查看历史文章，请查阅本站过往内容或继续浏览后续章节。感谢大家的支持与关注。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
