前言
使用python语言,django web框架,以及wechatpy,快速完成微信公众号后台服务的简易搭建,做记录于此。
wechatpy是一个python的微信公众平台sdk,封装了被动消息和主动推送的各种api,做公众平台开发时只需关注消息内容,无需处理xml解析等工作。
项目地址:https://github.com/jxtech/wechatpy
文档地址:http://docs.wechatpy.org/
开始搭建
环境配置
首先当然是安装django,安装wechatpy。
可参照 http://docs.wechatpy.org/zh_CN/master/install.html 完成wechatpy及其依赖的安装。
配置url和view
项目urls.py中配置相应url,指定到自己的名为mywechat应用中,如
urlpatterns = [
url(r\'^wx/\', include(\'mywechat.urls\')),
]
mywechat应用中配置url指定到某个view:
urlpatterns = [
url(r\'\', views.handle_wx, name="wx"),
]
view处理微信请求
views.py中写一个handle_wx方法,用于处理微信请求:
from django.http import HttpResponse, HttpResponseRedirect
from django.views.decorators.csrf import csrf_exempt
from wechatpy import parse_message, create_reply
from wechatpy.utils import check_signature
from wechatpy.exceptions import InvalidSignatureException
from wechatpy.replies import BaseReply
# 以下两个是自己定义的模块,位于wechat.util包下,分别处理文本和事件消息
from mywechat.util import reply_text, reply_event
TOKEN = \'xxxxx\' # 这里要指定一个token,后续填入到微信平台中
@csrf_exempt
def handle_wx(request):
# GET方式用于微信公众平台绑定验证
if request.method == \'GET\':
signature = request.GET.get(\'signature\', \'\')
timestamp = request.GET.get(\'timestamp\', \'\')
nonce = request.GET.get(\'nonce\', \'\')
echo_str = request.GET.get(\'echostr\', \'\')
try:
check_signature(TOKEN, signature, timestamp, nonce)
except InvalidSignatureException:
echo_str = \'error\'
response = HttpResponse(echo_str, content_type="text/plain")
return response
# POST方式用于接受和返回请求
else:
reply = None
msg = parse_message(request.body)
# 判断消息类型,文本消息则调用reply_text进行处理
if msg.type == \'text\':
reply = reply_text.do_reply(msg)
elif msg.type == \'event\':
reply = reply_event.do_reply(msg)
else:
pass
if not reply or not isinstance(reply, BaseReply):
reply = create_reply(\'暂不支持您所发送的消息类型哟~ 回复“帮助”查看使用说明。\', msg)
response = HttpResponse(reply.render(), content_type="application/xml")
return response
文本、图片、语音等很多消息类型均支持,详情参见:http://docs.wechatpy.org/zh_CN/master/messages.html#
处理文本请求
新建reply_text.py,用于处理文本类消息。
from wechatpy import parse_message, create_reply
from wechatpy.replies import TextReply, ArticlesReply
from wechatpy.utils import check_signature
from wechatpy.exceptions import InvalidSignatureException
def do_reply(msg):
reply = None
try:
if msg.content == \'天气\':
# msg.content即为消息内容
reply = create_reply(\'相关回复文本\', msg)
else:
reply = create_reply(\'没有此关键词\', msg)
except Exception as e:
print \'error:\', e
return reply
处理事件请求
可以对用户的关注、取关等事件进行处理。如果消息类型为event,则会被view调用reply_event.py进行处理。
from wechatpy import create_reply
# 响应用户关注/取关事件
def do_reply(msg):
reply = None
try:
# 关注事件
if msg.event == \'subscribe\':
reply = create_reply(\'你好呀\', msg)
elif msg.event == \'unsubscribe\':
# 用户取关
pass
else:
reply = create_reply(\'暂不支持您发送的内容\', msg)
except Exception as e:
print(\'error:\', e)
reply = create_reply(\'出错了\', msg)
return reply
支持更多类型的事件,详细可以查看wechatpy的文档:http://docs.wechatpy.org/zh_CN/master/events.html
调试环境下的外网映射
完成以上代码后,可以处理简单的关注和取关事件,并响应文字消息了。此时,需要先将调试环境映射到外网,可以用花生壳这个软件:http://hsk.oray.com/ , 可免费用来在测试程序时将本地服务映射到外网。
比如,绑定了 testwx.imwork.net 的域名(端口为80),映射到 127.0.0.1:8000.
配置公众号后台
公众号后台也需要进行配置,进入“开发——基本配置”,填写服务器配置。
url写为刚才申请到的域名,并注意后面与django中的url一样,即应当写为 http://testwx.imwork.net/wx/。
令牌(token)则是与上面view中的token相同。
可选择明文方式的消息,也可根据需要选择加密消息。
配置完成后,点击保存时,公众号后台会向指定的url发送一次GET请求,如果代码没问题的话,则程序会返回预定的值,无误后即完成绑定。
然后在公众号中回复文字,就能收到相应的消息了,公众号后台最基础的开发就完成了。
这里只简略写了最基本的配置,如果需要支持更多类型的事件或消息,或者主动通过api接口向公众平台推送,请参阅wechatpy的文档吧,同时,有的操作也需要公众号具有相应的权限才可以。