接收普通消息

当普通用户向公众号发消息时,公众平台服务器将POST消息的XML数据包到开发者填写的URL上。各消息类型的推送XML数据包结构如下。
公众平台服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次
关于重试的消息排重,推荐使用msgid排重。
假如服务器无法保证在五秒内处理并回复,可以直接回复空串,公众平台服务器不会对此作任何处理,并且不会发起重试。
文本消息
公众平台文本消息是指开发者接收到的消息体是由文本组成。具体内容可能包括以下几种内容:
纯文字消息
纯系统表情(例如:/大笑)
链接或文字超链
文字+系统表情(例如:今天真开心。/大笑)
文字+链接或文字超链
链接或文字超链+系统表情
文字+链接或文字超链+系统表情
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName> 
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(文本为text)
Content 文本消息内容
MsgId 消息id,64位整型
-->
单图片消息
公众平台单图片消息是指开发者接收到消息体是由单张图片组成,
图片格式支持:jpg/png/jpeg/gif/bmp
图片大小:最大不超过10M
图片尺寸:包括长和宽,单位pix
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[this is a url]]></PicUrl>
<MediaId><![CDATA[media_id]]></MediaId>
<MsgId>1234567890123456</MsgId>
</xml>
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(单图片为image)
PicUrl 图片链接
MediaID 图片消息媒体ID,可以调用多媒体文件下载接口拉取数据。
MsgId 消息id,64位整型
-->
语音消息
公众平台语音消息是指开发者接收到消息体是由一段语音组成
语音文件格式:amr
语音时长:最长60s
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(语音为voice)
MediaID 语音文件媒体ID,可以调用多媒体文件下载接口拉取数据。
MsgId 消息id,64位整型
-->
视频消息
公众平台视频消息是指开发者接收到消息体是由一段视频组成
视频文件格式:mp4
视频时长:最长60s
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<MediaUrl><![CDATA[mediaurl]]></MediaUrl>
<MsgId>1234567890123456</MsgId>
</xml>
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(视频为video)
MediaID 视频文件媒体ID,可以调用多媒体文件下载接口拉取数据。
MsgId 消息id,64位整型
-->
地理位置消息
公众平台地理位置消息是指开发者接收到消息体是由一个位置消息组成
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(地理位置为location)
Location_X 地理位置纬度
Location_Y 地理位置经度
Label 地理位置信息(文字)
MsgId 消息id,64位整型
-->
客户端开启会话通知
用户每次打开PC飞信客户端的开发者公众号的会话窗口时,或者用户在手机飞信客户端首次打开开发者公众号的会话窗口时,或者用户在手机客户端打开的公众号会话窗口没有任何历史内容时,客户端都会向公众平台上行客户端开启会话通知,公众平台都会向开发者传递该通知,开发者接收到该通知后,可以进行下发欢迎语等操作。
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(客户端开启会话通知为OpenConversation)
MsgId 消息id,64位整型
客户端关闭会话通知
用户每次关闭PC飞信客户端的开发者公众号的会话窗口时,公众平台都会向开发者传递客户端关闭会话通知。
参数说明
参数 说明
ToUserName 开发者公众号
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间(整型)
MsgType 消息体(客户端开启会话通知为CloseConversation)
MsgId 消息id,64位整型
-->-->