企业微信消息推送的python封装接口，让你轻松用python实现对企业微信的消息推送

👋 corpwechat-bot是一个python封装的企业机器人&应用消息推送库，通过企业微信提供的api实现。

利用本库，你可以轻松地实现从服务器端发送一条文本、图片、视频、markdown等等消息到你的微信手机端，而不依赖于其他的第三方应用，如ServerChan。

如果喜欢该项目，记得给个star，让更多人能够看到本项目 ♥️

ToC

• corpwechat-bot
  • QuickStart
  • Features
  • Usage
  • ChangeLog
  • Todo
  • Author
  • Contibutors
  • License

QuickStart

注意，本项目依赖于企业微信创建群聊机器人或应用，要想实现需要先注册一个属于你自己的企业微信号（个人免费），这十分简便，参照官方网址 即可

当你有了企业微信后，你还需要做一些配置，根据你自身的需求来做选择：

• 应用消息推送 ：应用消息推送需要在企业微信中创建一个第三方应用，参照教程
• 群聊机器人消息推送：群聊机器人消息推送需要在你已有的企业群中添加一个机器人，然后获取相应的机器人key（webhook最后面），参照教程

当确定你的配置可用后（企业微信后台尝试发送消息看手机上能否接收到），安装corpwechatbot到你的pc中，只需要一条命令：

pip install -U corpwechatbot

下面进行消息推送：

• 应用消息推送：发送一条文本消息到你设置的应用，在手机个人微信上查看接收

from corpwechatbot.app import AppMsgSender

app = AppMsgSender(corpid='',  # 你的企业id
                   corpsecret='',  # 你的应用凭证密钥
                   agentid='')   # 你的应用id
app.send_text(content="如果我是DJ，你会爱我吗？")

推送结果

• 动图演示

• 群聊机器人消息推送：发送一条文本消息到你设置了机器人的群聊

from corpwechatbot.chatbot import CorpWechatBot

bot = CorpWechatBot(key='')  # 你的机器人key，通过群聊添加机器人获取

bot.send_text(content='Hello World')

推送结果：

• 动图演示

如果你想要更多的使用技巧，请查看Usage

Features

目前实现了两种推送消息方式，应用消息推送和群聊机器人消息推送，并且在此基础上，添加了终端一条命令式上述两种消息的推送，具体如下：

• 应用消息推送：该推送会直接传至你的个人微信上，你会像收到好友消息一样收到通知信息，不需要安装企业微信，具体包括：

  • 文本消息: 最普通的消息，文字内容，最长不超过2048个字节
  • 图片消息：发送一张图片，可选jpg,png，大小不超过2MB，目前仅支持通过图片路径发送.
  • 语音消息：发送一条语音，大小不超过2MB，时长不超过60s，必须是.amr格式
  • 视频消息：发送一段视频，大小不超过10MB，必须是.mp4格式
  • 普通文件：其他类型的文件，大小不超过20MB（不小于5字节）
  • markdown消息：传输markdown类型消息
  • 图文消息：图片文字形式，带有跳转链接，适合做推广
  • mpnews图文消息：有专属页面的图文消息，支持html标签内容
  • 文本卡片消息：以卡片形式呈现的文本，包含跳转链接
  • 小程序通知消息：应用需绑定小程序才可使用，尚未实现
  • 任务卡片消息：允许用户点击做出相应反馈的卡片，需绑定回调函数，尚未实现

• 群聊机器人消息推送：该推送仅会发送消息到企业微信群聊中，经测试，个人微信的企业群聊不会收到机器人发送的消息，因此要收到消息需安装企业微信，具体包括：

  • 文本消息：普通文字消息，最长不超过2048个字节
  • 图片消息：图片大小不超过2M
  • 图文消息：图片文字形式，带有跳转链接，适合打广告
  • 文件消息：发送单个文件到群聊，大小在5B~20MB之间

• 终端一条命令式消息推送：不需要写额外的python代码，直接在终端输入一条命令cwb -t='hello world'即可推送消息到手机微信上，具体参考Usage

Usage

⚠️ 当第一种安装方式失效时，请尝试第二种

• 安装

pip install -U corpwechatbot

或者

git clone https://github.com/GentleCP/corpwechat-bot.git
cd corpwechat-bot
pip install .

• 使用

点此查看详细使用教程

ChangeLog

你可以在ChangeLog中查看最新版本提交的功能和bug修复信息 点此查看ChangeLog

Todo

后续版本待更新的内容：

• fix：token存储位置修改，初始设置保存到本地site-packages（后期将其移到site-packages/corpwechatbot目录下，方便统一）
• docs：readme和usage更新
• feat：更智能的调用接口（如所有发送用同一接口send，根据传入参数的不同自动选择）
• feat：终端快捷使用，一行命令式消息发送，例如corpwechatbot -s "hello world"直接发送一条文本消息
• refactor：核心代码优化与重构
• docs : 添加QuickStart
• feat：添加对应用消息发送到企业微信群聊的支持
• feat：添加应用消息任务卡片消息推送的功能（小程序消息暂不考虑）
• feat：允许将企业微信配置信息存储到本地文件读取
• fix: 修复在指定标签和部门后依然默认发送给全体成员的问题
• feat: 添加装饰器发送消息支持
• feat: 支持多个第三方应用消息推送
• feat: 添加对mpnews的发送支持

Author

@GentleCP

Contibutors

• @GentleCP

License

本项目遵守GPL v3开源协议