文章目录
前言
本文同步发表在blog.gentlecp.com
corpwechat-bot
是一个python
封装的企业机器人&应用消息推送库,通过企业微信提供的api实现。
利用本库,你可以轻松地实现从服务器端发送一条文本、图片、视频、markdown
等等消息到你的微信手机端,而不依赖于其他的第三方应用,如ServerChan
。
Requirements
注意,本项目依赖于企业微信创建群聊机器人或应用,要想实现需要先注册一个属于你自己的企业微信号,这十分简便,参照官方网址即可
当你有了企业微信后,你还需要做一些配置,根据你自身的需求来做选择:
Result
下面是部分项目演示效果:
-
应用消息推送
-
群聊机器人消息推送
Features
目前实现了两种推送消息方式,应用消息推送和群聊机器人消息推送
-
应用消息推送:该推送会直接传至你的个人微信上,你会像收到好友消息一样收到通知信息,不需要安装企业微信,具体包括:
- 文本消息: 最普通的消息,文字内容,最长不超过2048个字节
-
图片消息:发送一张图片,可选
jpg,png
,大小不超过2MB,目前仅支持通过图片路径发送. -
语音消息:发送一条语音,大小不超过2MB,时长不超过60s,必须是
.amr
格式 -
视频消息:发送一段视频,大小不超过10MB,必须是
.mp4
格式 - 普通文件:其他类型的文件,大小不超过20MB(不小于5字节)
- markdown消息:传输markdown类型消息
- 图文消息:图片文字形式,带有跳转链接,适合做推广
- 文本卡片消息:以卡片形式呈现的文本,包含跳转链接
- 小程序通知消息:应用需绑定小程序才可使用,尚未实现
- 任务卡片消息:允许用户点击做出相应反馈的卡片,需绑定回调函数,尚未实现
-
群聊机器人消息推送:该推送仅会发送消息到企业微信群聊中,经测试,个人微信的企业群聊不会收到机器人发送的消息,因此要收到消息需安装企业微信,具体包括:
- 文本消息:普通文字消息,最长不超过2048个字节
- 图片消息:图片大小不超过2M
- 图文消息:图片文字形式,带有跳转链接,适合打广告
-
文件消息:发送单个文件到群聊,大小在
5B~20MB
之间
Usage
本项目已开源在github,github传送门,更多使用方法参考github,欢迎提交PR和star