公众号的关键词回复是一个最基本的功能,大部分的关键词回复可以在授权的第三方平台(微微校、腾讯微校等)去进行管理,配置开发服务器之后,微信平台的自动回复和自定义菜单会失效,而在开发服务器里面管理这些又过于繁琐,第三方平台解决了这个问题,而且第三方平台功能很多,如微信公众号上墙功能,可以去看看。
微信公众测试号
URL:验证的时候会携带参数以GET方法去请求这个url。而验证成功之后,微信公众号用户发送数据时,微信服务器会将数据以POST方法发送到这个url。
所以说我们应该写两个相同路径,请求方法不同的controller。
@RequestMapping(value="/wxserver",method={RequestMethod.GET});
@RequestMapping(value="/wxserver",produces={"application/xml;charset=UTF8;"},method={RequestMethod.POST})
普通消息
文本消息事例
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>1234567890123456</MsgId>
</xml>
参数 描述
ToUserName 开发者微信号
FromUserName 发送方帐号(OpenID)
CreateTime 消息创建时间 (整型)
MsgType 消息类型,
Content 文本消息内容
MsgId 消息id,64位整型
MsgType:消息类型,文本为text,图片为image,语音为voice等。可以去官方文档里去查看。
推送事件
菜单点击事件事例
用户点击自定义菜单后,微信会把点击事件推送给开发者,请注意,点击菜单弹出子菜单,不会产生上报。
点击菜单拉取消息时的事件推送
推送XML数据包示例:
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>
参数 描述
ToUserName 开发者微信号
FromUserName 发送方帐号(OpenID)
CreateTime 消息创建时间 (整型)
MsgType 消息类型,event
Event 事件类型,CLICK
EventKey 事件KEY值,与自定义菜单接口中KEY值对应
微信公众号工具包依赖
<!-- 微信开发工具包 -->
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-mp</artifactId>
<version>1.3.3</version>
</dependency>
<dependency>
<groupId>me.chanjar</groupId>
<artifactId>weixin-java-common</artifactId>
<version>1.3.3</version>
</dependency>
开发代码
@ResponseBody()
@RequestMapping(value="/wxserver",produces={"application/xml;charset=UTF-8;"},method={RequestMethod.POST})
public String receive(HttpServletRequest request, HttpServletResponse response) throws Exception{
//因为微信服务器返回的是xml 所以我们需要解析
//获取消息流
WxMpXmlMessage message=WxMpXmlMessage.fromXml(request.getInputStream());
//消息类型
String messageType=message.getMsgType();
if("text".equals(messageType)){
String res= wxTextReceiveService.receiveText(message);
return res;
}
else if("event".equals(messageType)){
String res= wxEventReceiveService.receiveClick(message);
return res;
}
return "";
}
自定义类WxTextReceiveService 中的处理方法
/**
* 接收微信用户发送的普通文本消息 并且回复
*/
@Override
public String receiveText(WxMpXmlMessage message) {
String str="";
String fromUserName = message.getFromUserName();
String toUserName = message.getToUserName();
//文本消息 文本内容
String content = message.getContent();
//将回复消息按格式封装成xml
//toUser(fromUserName).fromUser(toUserName) 发送者变成接受者
WxMpXmlOutTextMessage text = WxMpXmlOutTextMessage.TEXT().toUser(fromUserName).fromUser(toUserName).content("hello word"+content ).build();
str = text.toXml();
return str;
}
整个简单的交互过程就已经完成了。
如果想了解微信公众号开发其它部分,请查看我其它文章。