微信公众号被动回复方案梳理

微信公众号机器人客服回复方案预梳理

一、微信公众平台开发接入指南

接入微信公众平台开发，需要按照如下步骤完成：

1、填写服务器配置

登录微信公众平台官网后，在公众平台后台管理页面 - 开发者中心页，点击“修改配置”按钮，填写服务器地址（URL）、Token和EncodingAESKey，其中URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者可以任意填写，用作生成签名（该Token会和接口URL中包含的Token进行比对，从而验证安全性）。EncodingAESKey由开发者手动填写或随机生成，将用作消息体加解密密钥。

2、验证服务器地址的有效性

开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带四个参数：

参数	描述
signature	微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
timestamp	时间戳
nonce	随机数
echostr	随机字符串

3、依据接口文档实现业务逻辑

验证URL有效性成功后即接入生效，成为开发者。如果公众号类型为服务号（订阅号只能使用普通消息接口），可以在公众平台网站中申请认证，认证成功的服务号将获得众多接口权限，以满足开发者需求。此后用户每次向公众号发送消息、或者产生自定义菜单点击事件时，开发者填写的服务器配置URL将得到微信服务器推送过来的消息和事件，然后开发者可以依据自身业务逻辑进行响应，例如回复消息等。公众号调用各接口时，一般会获得正确的结果，具体结果可见对应接口的说明。返回错误时，可根据返回码来查询错误原因。全局返回码说明用户向公众号发送消息时，公众号方收到的消息发送者是一个OpenID，是使用用户微信号加密后的结果，每个用户对每个公众号有一个唯一的OpenID。

三、微信服务器向公众号服务器推送消息的类型

当用户发送消息给公众号时（或某些特定的用户操作引发的事件推送时），会产生一个POST请求，开发者可以在响应包（Get）中返回特定XML结构，来对该消息进行响应（现支持回复文本、图片、图文、语音、视频、音乐）。严格来说，发送被动响应消息其实并不是一种接口，而是对微信服务器发过来消息的一次回复。

微信服务器在将用户的消息发给公众号的开发者服务器地址（开发者中心处配置）后，微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次，如果在调试中，发现用户无法收到响应的消息，可以检查是否消息处理超时。关于重试的消息排重，有msgid的消息推荐使用msgid排重。事件类型消息推荐使用FromUserName + CreateTime 排重。

微信服务器推送消息类型的XML数据包结构

文本消息

<xml>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	text
Content	文本消息内容
MsgId	消息id，64位整型

图片消息

<xml>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	image
PicUrl	图片链接
MediaId	图片消息媒体id，可以调用多媒体文件下载接口拉取数据。
MsgId	消息id，64位整型

语音消息

<xml>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	语音为voice
MediaId	语音消息媒体id，可以调用多媒体文件下载接口拉取数据。
Format	语音格式，如amr，speex等
MsgID	消息id，64位整型

请注意，开通语音识别后，用户每次发送语音给公众号时，微信会在推送的语音消息XML数据包中，增加一个Recongnition字段（注：由于客户端缓存，开发者开启或者关闭语音识别功能，对新关注者立刻生效，对已关注用户需要24小时生效。开发者可以重新关注此帐号进行测试）。开启语音识别后的语音XML数据包如下：

<xml>

</xml>

多出的字段中，Format为语音格式，一般为amr，Recognition为语音识别结果，使用UTF8编码。

视频消息

<xml>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	视频为video
MediaId	视频消息媒体id，可以调用多媒体文件下载接口拉取数据。
ThumbMediaId	视频消息缩略图的媒体id，可以调用多媒体文件下载接口拉取数据。
MsgId	消息id，64位整型

小视频消息

<xml>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	小视频为shortvideo
MediaId	视频消息媒体id，可以调用多媒体文件下载接口拉取数据。
ThumbMediaId	视频消息缩略图的媒体id，可以调用多媒体文件下载接口拉取数据。
MsgId	消息id，64位整型

地理位置消息

<xml>

<Location_X>23.134521</Location_X>

<Location_Y>113.358803</Location_Y>

</xml>

参数	描述
ToUserName	开发者微信号
FromUserName	发送方帐号（一个OpenID）
CreateTime	消息创建时间（整型）
MsgType	location
Location_X	地理位置维度
Location_Y	地理位置经度
Scale	地图缩放大小
Label	地理位置信息
MsgId	消息id，64位整型

链接消息

<xml>

</xml>

参数	描述
ToUserName	接收方微信号
FromUserName	发送方微信号，若为普通用户，则是一个OpenID
CreateTime	消息创建时间
MsgType	消息类型，link
Title	消息标题
Description	消息描述
Url	消息链接
MsgId	消息id，64位整型

示例代码（Java版）

首先接收微信服务器POST请求数据, 代码如下:接收微信服务器POST请求数据, 代码如下:

1. /**

2. * 微信公众平台所有接口入口

3. *

4. * @param request

5. * the request send by the client to the server

6. * @param response

7. * the response send by the server to the client

8. * @throws ServletException

9. * if an error occurred

10. * @throws IOException

11. * if an error occurred

12. */

13. public void doPost(HttpServletRequest request, HttpServletResponse response)

14. throws ServletException, IOException {

15. response.setCharacterEncoding("UTF-8");

16. request.setCharacterEncoding("UTF-8");

17. PrintWriter out = response.getWriter();

18. try {

19. InputStream is = request.getInputStream();

20. PushManage push = new PushManage();

21. String getXml = push.PushManageXml(is);

22. out.print(getXml);

23. } catch (JDOMException e) {

24. e.printStackTrace();

25. out.print("");

26. } catch (Exception e) {

27. out.print("");

28. } finally {

29. if(out!=null) {

30. out.flush();

31. out.close();

32. }

33. }

34. }

四、被动回复用户消息格式

假如服务器无法保证在五秒内处理并回复，必须做出下述回复，这样微信服务器才不会对此作任何处理，并且不会发起重试（这种情况下，可以使用客服消息接口进行异步回复），否则，将出现严重的错误提示。详见下面说明：

1、（推荐方式）直接回复success

2、直接回复空串（指字节长度为0的空字符串，而不是XML结构体中content字段的内容为空）

回复文本消息

<xml>

</xml>

参数	是否必须	描述
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间（整型）
MsgType	是	text
Content	是	回复的消息内容（换行：在content中能够换行，微信客户端就支持换行显示）

回复图片消息

<xml>

<Image>

</Image>

</xml>

参数	是否必须	说明
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间（整型）
MsgType	是	image
MediaId	是	通过素材管理接口上传多媒体文件，得到的id。

回复语音消息

<xml>

<Voice>

</Voice>

</xml>

参数	是否必须	说明
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间戳（整型）
MsgType	是	语音，voice
MediaId	是	通过素材管理接口上传多媒体文件，得到的id

回复视频消息

<xml>

<Video>

</Video>

</xml>

参数	是否必须	说明
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间（整型）
MsgType	是	video
MediaId	是	通过素材管理接口上传多媒体文件，得到的id
Title	否	视频消息的标题
Description	否	视频消息的描述

回复音乐消息

<xml>

<Music>

</Music>

</xml>

参数	是否必须	说明
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间（整型）
MsgType	是	music
Title	否	音乐标题
Description	否	音乐描述
MusicURL	否	音乐链接
HQMusicUrl	否	高质量音乐链接，WIFI环境优先使用该链接播放音乐
ThumbMediaId	否	缩略图的媒体id，通过素材管理接口上传多媒体文件，得到的id

回复图文消息

<xml>

<item>

</item>

<item>

</item>

</Articles>

</xml>

参数	是否必须	说明
ToUserName	是	接收方帐号（收到的OpenID）
FromUserName	是	开发者微信号
CreateTime	是	消息创建时间（整型）
MsgType	是	news
ArticleCount	是	图文消息个数，限制为10条以内
Articles	是	多条图文消息信息，默认第一个item为大图,注意，如果图文数超过10，则将会无响应
Title	否	图文消息标题
Description	否	图文消息描述
PicUrl	否	图片链接，支持JPG、PNG格式，较好的效果为大图360200，小图200200
Url	否	点击图文消息跳转链接

根据POST请求的XML数据解析并响应相关信息，代码如下

1. package cn.wuzhuti.weixin.utils;

3. import java.io.IOException;

4. import java.io.InputStream;

5. import java.text.SimpleDateFormat;

6. import java.util.Date;

7. import java.util.List;

8. import org.jdom2.Document;

9. import org.jdom2.Element;

10. import org.jdom2.JDOMException;

11. import org.jdom2.input.SAXBuilder;

12. import org.jdom2.output.XMLOutputter;

13.

14. public class PushManage {

15.

16. public String PushManageXml(InputStream is) throws JDOMException {

17.

18. String returnStr = ""; // 反回Servlet字符串

19. String toName = ""; // 开发者微信号

20. String fromName = ""; // 发送方帐号（一个OpenID）

21. String type = ""; // 请求类型

22. String con = ""; // 消息内容(接收)

23. String event = ""; // 自定义按钮事件请求

24. String eKey = ""; // 事件请求key值

25.

26. try {

27.

28. SAXBuilder sax = new SAXBuilder();

29. Document doc = sax.build(is);

30. // 获得文件的根元素

31. Element root = doc.getRootElement();

32.

33. // 获得根元素的第一级子节点

34. List list = root.getChildren();

35. for (int j = 0; j < list.size(); j++) {

36. // 获得结点

37. Element first = (Element) list.get(j);

38.

39. if (first.getName().equals("ToUserName")) {

40. toName = first.getValue().trim();

41. } else if (first.getName().equals("FromUserName")) {

42. fromName = first.getValue().trim();

43. } else if (first.getName().equals("MsgType")) {

44. type = first.getValue().trim();

45. } else if (first.getName().equals("Content")) {

46. con = first.getValue().trim();

47. } else if (first.getName().equals("Event")) {

48. event = first.getValue().trim();

49. } else if (first.getName().equals("EventKey")) {

50. eKey = first.getValue().trim();

51. }

52. }

53. } catch (IOException e) {

54. //异常

55. }

56.

57. if (type.equals("event")) { //此为事件

58. if (event.equals("subscribe")) {// 此为关注事件

59.

60. } else if (event.equals("unsubscribe")) { //此为取消关注事件

61.

62. } else if (event.equals("CLICK")) { //此为自定义菜单按钮点击事件

63. // 以下为自定义按钮事件

64. if (eKey.equals("V1")) { //菜单1

65. returnStr = getBackXMLTypeText(toName,fromName,"点击了菜单1");

66. } else if (eKey.equals("V2")) { //菜单2

67. returnStr = getBackXMLTypeText(toName,fromName,"点击了菜单2");

68. }

69. }

70. } else if (type.equals("text")) { // 此为文本信息

71. returnStr = getBackXMLTypeText(toName,fromName,"输入了:"+con);

72. }

73.

74. return returnStr;

75. }

76.

77.

78. /**

79. * 编译文本信息

80. *

81. * @author xiaowu

82. * @since 2013-9-27

83. * @param toName

84. * @param FromName

85. * @param content

86. * @return

87. */

88. private String getBackXMLTypeText(String toName, String fromName,

89. String content) {

90.

91. String returnStr = "";

92.

93. SimpleDateFormat format = new SimpleDateFormat("yyyyMMddHHmmss");

94. String times = format.format(new Date());

95.

96. Element rootXML = new Element("xml");

97.

98. rootXML.addContent(new Element("ToUserName").setText(fromName));

99. rootXML.addContent(new Element("FromUserName").setText(toName));

100. rootXML.addContent(new Element("CreateTime").setText(times));

101. rootXML.addContent(new Element("MsgType").setText("text"));

102. rootXML.addContent(new Element("Content").setText(content));

103.

104. Document doc = new Document(rootXML);

105.

106. XMLOutputter XMLOut = new XMLOutputter();

107. returnStr = XMLOut.outputString(doc);

108.

109. return returnStr;

110. }

111.

112. /**

113. * 编译图片信息(单图模式)

114. *

115. * @author xiaowu

116. * @since 2013-9-27

117. * @param toName

118. * @param FromName

119. * @param content

120. * @return

121. */

122. private String getBackXMLTypeImg(String toName, String fromName,

123. String title, String content, String url, String pUrl) {

124.

125. String returnStr = "";

126.

127. SimpleDateFormat format = new SimpleDateFormat("yyyyMMddHHmmss");

128. String times = format.format(new Date());

129.

130. Element rootXML = new Element("xml");

131.

132. rootXML.addContent(new Element("ToUserName").setText(fromName));

133. rootXML.addContent(new Element("FromUserName").setText(toName));

134. rootXML.addContent(new Element("CreateTime").setText(times));

135. rootXML.addContent(new Element("MsgType").setText("news"));

136. rootXML.addContent(new Element("ArticleCount").setText("1"));

137.

138. Element fXML = new Element("Articles");

139. Element mXML = null;

140.

141. mXML = new Element("item");

142. mXML.addContent(new Element("Title").setText(title));

143. mXML.addContent(new Element("Description").setText(content));

144. mXML.addContent(new Element("PicUrl").setText(pUrl));

145. mXML.addContent(new Element("Url").setText(url));

146. fXML.addContent(mXML);

147. rootXML.addContent(fXML);

148.

149. Document doc = new Document(rootXML);

150.

151. XMLOutputter XMLOut = new XMLOutputter();

152. returnStr = XMLOut.outputString(doc);

153.

154. return returnStr;

155. }

156. /**

157. * 编译图片信息(无图模式)

158. *

159. * @author xiaowu

160. * @since 2013-9-27

161. * @param toName

162. * @param FromName

163. * @param content

164. * @return

165. */

166. private String getBackXMLTypeImg(String toName, String fromName,

167. String title, String content, String url) {

168.

169. String returnStr = "";

170.

171. SimpleDateFormat format = new SimpleDateFormat("yyyyMMddHHmmss");

172. String times = format.format(new Date());

173.

174. Element rootXML = new Element("xml");

175.

176. rootXML.addContent(new Element("ToUserName").setText(fromName));

177. rootXML.addContent(new Element("FromUserName").setText(toName));

178. rootXML.addContent(new Element("CreateTime").setText(times));

179. rootXML.addContent(new Element("MsgType").setText("news"));

180. rootXML.addContent(new Element("ArticleCount").setText("1"));

181.

182. Element fXML = new Element("Articles");

183. Element mXML = null;

184.

185. //String url = "";

186. String ss = "";

187. mXML = new Element("item");

188. mXML.addContent(new Element("Title").setText(title));

189. mXML.addContent(new Element("Description").setText(content));

190. mXML.addContent(new Element("PicUrl").setText(ss));

191. mXML.addContent(new Element("Url").setText(url));

192. fXML.addContent(mXML);

193. rootXML.addContent(fXML);

194.

195. Document doc = new Document(rootXML);

196.

197. XMLOutputter XMLOut = new XMLOutputter();

198. returnStr = XMLOut.outputString(doc);

199.

200. return returnStr;

201. }

202.

203. /**

204. * 编译音乐信息

205. *

206. * @author xiaowu

207. * @since 2013-9-27

208. * @param toName

209. * @param FromName

210. * @param content

211. * @return

212. */

213. @SuppressWarnings("unused")

214. private String getBackXMLTypeMusic(String toName, String fromName,

215. String content) {

216.

217. String returnStr = "";

218.

219. SimpleDateFormat format = new SimpleDateFormat("yyyyMMddHHmmss");

220. String times = format.format(new Date());

221.

222. Element rootXML = new Element("xml");

223.

224. rootXML.addContent(new Element("ToUserName").setText(fromName));

225. rootXML.addContent(new Element("FromUserName").setText(toName));

226. rootXML.addContent(new Element("CreateTime").setText(times));

227. rootXML.addContent(new Element("MsgType").setText("music"));

228.

229. Element mXML = new Element("Music");

230.

231. mXML.addContent(new Element("Title").setText("音乐"));

232. mXML.addContent(new Element("Description").setText("音乐让人心情舒畅！"));

233. mXML.addContent(new Element("MusicUrl").setText(content));

234. mXML.addContent(new Element("HQMusicUrl").setText(content));

235.

236. rootXML.addContent(mXML);

237.

238. Document doc = new Document(rootXML);

239.

240. XMLOutputter XMLOut = new XMLOutputter();

241. returnStr = XMLOut.outputString(doc);

242.

243. return returnStr;

244. }

245. }