【corpwechat-bot】一个好用的企业微信消息推送python接口库

前言

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

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

Requirements

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

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

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

Result

下面是部分项目演示效果:

  • 应用消息推送

  • 群聊机器人消息推送
    image-20220425093834045

  • 应用群聊消息推送

  • 应用回调

Features

应用消息推送

该推送会直接传至你的个人微信上,你会像收到好友消息一样收到通知信息,不需要安装企业微信

  • 文本消息: 最普通的消息,文字内容,最长不超过2048个字节
  • 图片消息:发送一张图片,可选jpg,png,大小不超过2MB,目前仅支持通过图片路径发送
  • 语音消息:发送一条语音,大小不超过2MB,时长不超过60s,必须是.amr格式
  • 视频消息:发送一段视频,大小不超过10MB,必须是.mp4格式
  • 普通文件:其他类型的文件,大小不超过20MB(不小于5字节)
  • markdown消息:传输markdown类型消息
  • 图文消息:图片文字形式,带有跳转链接,适合做推广
  • mpnews图文消息:有专属页面的图文消息,支持html标签内容
  • 文本卡片消息:以卡片形式呈现的文本,包含跳转链接
  • 任务卡片消息:应用与用户交互的卡片,需要配置回调
  • 应用消息回调:实现移动端到服务端的交互,具体看使用教程

群聊机器人消息推送

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

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

终端一条命令式消息推送

直接在终端发送消息,仅支持文本与markdown

应用群聊消息推送

应用消息推送的拓展,可以让应用发送消息到群聊中,让群聊中每个人都能看到,支持除任务卡片和小程序消息以外的所有应用消息推送。

Usage

更多的使用教程请查看:corpwechatbot: 企业微信消息推送助手 (gentlecp.com)

同时,本项目已开源在github,地址:https://github.com/GentleCP/corpwechat-bot , 欢迎提交PR和star :)