Wechat-Enter 微信企业号Python-SDK

wechat-enter是一个微信企业号开发的Python SDK，可以大幅简化微信企业号后台开发，适用于Python3。

目前已经实现的功能：

分类	功能名称	是否实现
基础	主动调用	是
基础	回调模式	是
认证接口	身份验证	Oauth验证
	成员登录授权
	单点登录授权
资源接口	管理企业号应用	是
	自定义菜单
	管理通讯录	是
	管理素材文件	是
能力接口	发消息	是
	接收消息与事件	是
	微信JS-SDK接口
	会话服务
	客服服务
	企业号微信支付
	摇一摇周边
SAAS套件接口	第三方应用授权
	通讯录权限体系
	管理后台单点登录

使用前配置

from wechat_enter import WechatConf
corp_id = "wx1234567890”
secrets = (“xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”,)
agent_dicts = [
”agentid": 1, "token": “ttttttttt”, "encoding_aes_key": “eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee”},
{“agentid": 2, "token": "ttttttttt", "encoding_aes_key": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee”},
]

wechat_conf = WechatConf(corp_id=corp_id, secrets= secrets, agent_dicts=agent_dicts)

其中： corp_id是企业号全局性的标示符，在企业号设置-基本信息-账号信息中可以找到。
secrets是企业号管理员账号的secrets，在设置-功能设置-权限管理中可以找到。使用前注意查看不同管理员的权限设置，不同管理员对通讯录和企业号应用的权限是不一样的。需要调用的管理员的secrets统一放到这个tuple中去。
agent_dicts是企业号应用的信息，在应用中心-回调模式中可以找到。每个应用的信息包括agentid、token、encoding_aes_key三个参数，需要用到的应用信息组成一个tuple。

调用

假设已经配置好了wechat_conf

from wechat_enter import Wechat  
wechat = Wechat(wechat_conf)

回调URL验证

text = wechat.url_validator.validate(msg_signature, timestamp, nonce, echostr)
#再用最简单的HttpResponse返回这个text即可完成验证

获取通讯录用户列表

user_list = wechat.users.list()

获取通讯录部门列表

depart_list = wechat.departments.list()

发送文本消息

body = {
    "touser" : userid,
    "text"   : {
        "content": content
    },
}
wechat.message_sender.send_text(body)

接受消息和事件

message=wechat.message_receiver.parse(msg_signature, timestamp, nonce, msg_body)
if message.type == “text”:
	print(message.content)
elif message.type == “Event” and message.EVENT == “Location”:
	print(message.Latitude, message.Longitude)

Contribute

如果要新增功能，原则上需要引入WechatObejcts(这是一个发消息的基类)。
继承这个基类之后，调用send函数即可。
以获取自定义菜单列表为例，微信标准API是：
https://qyapi.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN&agentid=AGENTID
菜单类应该写为：

class WechatMenu(WechatObjects):
    def get(self, agentid):
	query_dict = {
	    "agentid":agentid
	}
    return self.send("menu/get", query_dict = query_dict)

To Do List

AccessToken持久化

stars615/wechat_enter