WeWorkBot下载WeWorkBot源代码下载

WeWorkBot

Ai源码

1.0.0

下载

WeWorkBot

为企业微信自建应用构建的机器人，能够实现对各种类型消息的被动回复和主动发送。

现支持：

接收处理文本(text)、图片(image)、语音(voice)、视频(video)、位置(location)和链接(link)等消息类型；
以文本(text)、图片(image)、语音(voice)、视频(video)、图文(news)等消息类型进行被动回复；
以文本(text)、图片(image)、语音(voice)、视频(video)、Markdown(markdown)、图文(mpnews)、图文(news)、文本卡片(textcard)、文件(file)等消息类型主动发送应用消息；
文件素材管理，包括上传临时文件、上传图片、异步上传文件、下载文件等;
发起群聊、更改群聊信息、获取群聊会话、向群聊发送应用消息等功能（具体限制请参考官方文档）；

依赖

依赖的库不多，可以参考requirements.txt。

安装

目前支持Python >= 3.9，其余版本未经测试。

Python库现已发布，可以通过pip install wwbot进行安装。

示例代码

如下示例代码展示WeWorkBot的简单使用。该示例展示了如何回复文本类型(text)的消息：

from flask import Flask
from wwbot import WWBot
from wwbot.msg import Message, TextMessage

# 注册一个文本消息的事件监听
@WWBot.on(WWBot.TEXT)
def text_handler(msg:TextMessage) -> Message:
    '''
    msg参数代表接收到的消息被解析后的实例
    '''
    # 从消息中提取消息内容字段
    # 关于接收到的消息格式具体定义，参考 https://developer.work.weixin.qq.com/document/path/90239
    msg_content:str = msg.content
    # 作为示例，直接使用接收到的消息作为回复，相当于一个 echo bot
    return TextMessage(msg.from_username, msg.to_username, msg.agent_id, msg_content)

# WeWorkBot运行在Flask框架之上
app:Flask = Flask('WWBot')
# 企业ID 
corp_id:str = 'corp_id'
# 企业自建应用的secret 可以创建自建应用后在应用详情页面查看
corp_secret:str = 'corp_secret'
# 自建应用启用API接收消息时，配置的“Token”参数
token:str = 'token'
# 自建应用启用API接收消息时，配置的“EncodingAESKey”参数
aes_key:bytes = base64.b64decode('aes_key')
# 接收消息回调时的url path部分
callback_path:str = '/wwbot'

# 配置机器人
WWBot.config(app, corp_id, corp_secret, token, aes_key, callback_path=callback_path)

if __name__ == '__main__':
    app.run('0.0.0.0', 31221)