当普通微信用户向公众账号发消息时,微信服务器将POST消息的XML数据包到开发者填写的URL上。
请注意:
1、关于重试的消息排重,推荐使用msgid排重。
2、微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。假如服务器无法保证在五秒内处理并回复,
可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。详情请见“发送消息-被动回复消息”。
3、如果开发者需要对用户消息在5秒内立即做出回应,即使用“发送消息-被动回复消息”接口向用户被动回复消息时,可以在
公众平台官网的开发者中心处设置消息加密。开启加密后,用户发来的消息和开发者回复的消息都会被加密(但开发者通过客服
接口等API调用形式向用户发送消息,则不受影响)。关于消息加解密的详细说明,请见“发送消息-被动回复消息加解密说明”。
各消息类型的推送XML数据包结构如下:
文本消息
1348831860 1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
text |
| Content |
文本消息内容 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
图片消息
1348831860
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
image |
| PicUrl |
图片链接(由系统生成) |
| MediaId |
图片消息媒体id,可以调用多媒体文件下载接口拉取数据。 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
语音消息
1357290913
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
语音为voice |
| MediaId |
语音消息媒体id,可以调用多媒体文件下载接口拉取数据。 |
| Format |
语音格式,如amr,speex等 |
| MsgID |
消息id,64位整型 |
使用网页调试工具调试该接口
请注意,开通语音识别后,用户每次发送语音给公众号时,微信会在推送的语音消息XML数据包中,增加一个Recongnition字段(注:由于客户端缓存,开发者开启或者关闭语音识别功能,对新关注者立刻生效,对已关注用户需要24小时生效。开发者可以重新关注此帐号进行测试)。开启语音识别后的语音XML数据包如下:
1357290913
1234567890123456
|
参数说明:
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
语音为voice |
| MediaID |
语音消息媒体id,可以调用多媒体文件下载接口拉取该媒体 |
| Format |
语音格式:amr |
| Recognition |
语音识别结果,UTF8编码 |
| MsgID |
消息id,64位整型 |
视频消息
1357290913
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
视频为video |
| MediaId |
视频消息媒体id,可以调用多媒体文件下载接口拉取数据。 |
| ThumbMediaId |
视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
小视频消息
1357290913
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
小视频为shortvideo |
| MediaId |
视频消息媒体id,可以调用多媒体文件下载接口拉取数据。 |
| ThumbMediaId |
视频消息缩略图的媒体id,可以调用多媒体文件下载接口拉取数据。 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
地理位置消息
1351776360
23.134521
113.358803
20
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
开发者微信号 |
| FromUserName |
发送方帐号(一个OpenID) |
| CreateTime |
消息创建时间 (整型) |
| MsgType |
location |
| Location_X |
地理位置维度 |
| Location_Y |
地理位置经度 |
| Scale |
地图缩放大小 |
| Label |
地理位置信息 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
链接消息
1351776360
1234567890123456
|
| 参数 |
描述 |
| ToUserName |
接收方微信号 |
| FromUserName |
发送方微信号,若为普通用户,则是一个OpenID |
| CreateTime |
消息创建时间 |
| MsgType |
消息类型,link |
| Title |
消息标题 |
| Description |
消息描述 |
| Url |
消息链接 |
| MsgId |
消息id,64位整型 |
使用网页调试工具调试该接口
