DingtalkChatbot：让Python轻松对接钉钉机器人，10分钟实现消息自动化推送

穆千伊

958人浏览 · 2026-03-04 01:02:11

穆千伊 · 2026-03-04 01:02:11 发布

DingtalkChatbot：让Python轻松对接钉钉机器人，10分钟实现消息自动化推送

【免费下载链接】DingtalkChatbot 钉钉群自定义机器人消息Python封装项目地址: https://gitcode.com/gh_mirrors/di/DingtalkChatbot

DingtalkChatbot是一款专为Python开发者设计的钉钉群自定义机器人消息封装工具，它能够帮助开发者快速实现钉钉消息的自动化推送功能。无论是企业通知、系统告警还是日常办公提醒，都能通过这个强大的工具轻松搞定。

为什么选择DingtalkChatbot？

在日常工作中，我们经常需要将系统信息、业务数据或告警通知及时推送到钉钉群中。手动发送不仅效率低下，还容易遗漏重要信息。DingtalkChatbot的出现，正是为了解决这一痛点。它提供了简洁易用的API，让开发者能够在短短10分钟内完成钉钉机器人的对接，实现消息的自动化推送。

核心优势

简单易用：提供直观的API接口，无需深入了解钉钉机器人的底层实现细节
功能丰富：支持多种消息类型，满足不同场景的推送需求
快速集成：纯Python实现，轻松集成到现有Python项目中
稳定可靠：经过充分测试，确保消息推送的稳定性和可靠性

快速开始：10分钟上手DingtalkChatbot

环境准备

首先，你需要准备Python环境。DingtalkChatbot支持Python 3.6及以上版本。你可以通过以下命令克隆项目代码：

git clone https://gitcode.com/gh_mirrors/di/DingtalkChatbot

安装依赖

项目使用Pipfile管理依赖，你可以通过以下命令安装所需依赖：

cd DingtalkChatbot
pipenv install

创建钉钉机器人

在使用DingtalkChatbot之前，你需要在钉钉群中创建一个自定义机器人，并获取其Webhook地址。具体步骤如下：

打开钉钉群，点击群设置 -> 智能群助手 -> 添加机器人 -> 自定义机器人
填写机器人名称，设置安全设置（推荐使用加签方式）
复制生成的Webhook地址，稍后会用到

第一个示例：发送文本消息

下面我们来编写一个简单的示例，实现发送文本消息到钉钉群：

from dingtalkchatbot.chatbot import DingtalkChatbot

# 初始化机器人
webhook = '你的钉钉机器人Webhook地址'
secret = '你的机器人加签密钥'  # 如果没有设置加签，可以省略此参数
xiaoding = DingtalkChatbot(webhook, secret=secret)

# 发送文本消息
xiaoding.send_text(msg='Hello, DingtalkChatbot!')

运行这段代码，你就可以在钉钉群中收到一条"Hello, DingtalkChatbot!"的消息了。

支持的消息类型

DingtalkChatbot支持多种消息类型，满足不同场景的需求。下面我们来介绍几种常用的消息类型。

Markdown消息

Markdown消息支持富文本格式，可以展示更丰富的内容。例如，我们可以发送天气预报信息：

通过send_markdown方法，你可以轻松发送带有图片和格式化文本的消息：

xiaoding.send_markdown(title='广州天气', text='#### 广州天气\n9度，西北风1级，空气良89，相对温度73%')

如果需要@特定人员，可以在文本中使用@手机号的形式：

图文消息

FeedCard消息可以展示多张图片和对应的描述，适合用于展示产品、新闻等内容：

使用send_feed_card方法发送图文消息：

cards = [
    {
        "title": "氧眼美女",
        "message_url": "https://example.com",
        "pic_url": "http://example.com/image1.jpg"
    },
    {
        "title": "氧神美女",
        "message_url": "https://example.com",
        "pic_url": "http://example.com/image2.jpg"
    }
]
xiaoding.send_feed_card(cards)

动作卡片

动作卡片消息支持添加按钮，用户可以通过点击按钮进行相应的操作。DingtalkChatbot支持多种动作卡片样式。

全局跳转动作卡片：

独立跳转动作卡片：

多按钮动作卡片：

使用send_action_card方法发送动作卡片消息：

from dingtalkchatbot.chatbot import ActionCard

actioncard = ActionCard(
    title='故事是这样子的...',
    text='![screenshot](http://example.com/image.jpg)',
    btns=[
        {"title": "支持", "actionURL": "https://example.com/support"},
        {"title": "反对", "actionURL": "https://example.com/oppose"}
    ],
    btn_orientation=1,
    hide_avatar=0
)
xiaoding.send_action_card(actioncard)