微信公众平台的开发者文档
微信公众平台的开发者文档
  1. 使用微信公众平台开发前必读
    1. 微信公众平台开发概述
    2. 微信公众平台开发者规范
    3. 微信公众号接口权限说明
    4. 微信公众号接口调用频次限制说明
  2. 开始开发微信公众平台
    1. 微信开发者平台接入指南
    2. 微信公众平台接口域名说明
    3. 微信平台开发者获取access_token
    4. 获取微信服务器IP地址
    5. 微信平台开发报警排查指引
    6. 微信接口测试号申请
  3. 微信公众平台自定义开发
    1. 微信平台开发自定义菜单创建接口
    2. 微信公众平台自定义菜单查询接口
    3. 微信自定义菜单删除接口
    4. 微信自定义菜单事件推送
    5. 微信公众平台个性化菜单接口
    6. 微信获取自定义菜单配置接口
  4. 微信公众平台 消息管理
    1. 微信平台接收普通消息
    2. 微信平台开发接收事件推送
    3. 微信平台被动回复用户消息
    4. 微信消息加解密说明
    5. 微信公众号客服消息
    6. 微信高级群发接口
    7. 微信公众号开发模板消息接口
    8. 微信平台开发者模板消息运营规范
    9. 获取微信公众号的自动回复规则
  5. 微信网页开发
    1. 微信网页授权
    2. 微信网页开发样式库
    3. 微信JS-SDK说明文档
    4. 微信web开发者工具
  6. 微信平台素材管理
    1. 微信新增临时素材
    2. 获取微信平台临时素材
    3. 微信开发者新增永久素材
    4. 微信开发者 删除永久素材
    5. 微信开发者修改永久图文素材
    6. 获取微信公众号素材总数
    7. 获取微信公众平台的素材列表
  7. 微信平台 用户管理
    1. 微信公众号用户标签管理
    2. 微信平台开发者设置用户备注名
    3. 获取微信公众号用户的基本信息(UnionID机制)
    4. 获取微信公众号用户列表
    5. 获取微信用户地理位置
    6. 微信公众号黑名单管理
  8. 管理微信账号
    1. 微信生成带参数的二维码
    2. 微信公众号长链接转短链接接口
    3. 微信认证事件推送
  9. 微信公众号数据统计
    1. 微信用户分析数据接口
    2. 微信图文分析数据接口
    3. 微信消息分析数据接口
    4. 微信接口分析数据接口
  10. 微信卡券接口说明
    1. 微信卡券接口
    2. 微信平台开发者创建卡券
    3. 微信平台投放卡券
    4. 核销微信平台的卡券
    5. 微信公众号管理卡券
    6. 微信卡券事件推送
    7. 微信平台会员卡专区（一）
    8. 微信平台会员卡专区（二）
    9. 微信优惠券朋友的券专区
    10. 微信特殊票券
    11. 第三方微信开发者模式
    12. 微信卡券错误码
  11. 微信门店
    1. 微信门店接口
  12. 微信小店
    1. 微信小店接口
    2. 微信平台语义理解接口
  13. 微信设备功能
    1. 微信服务号设备功能介绍
    2. 微信如何新增产品型号
  14. 微信平台新版客服功能
    1. 将消息转发到微信客服
    2. 微信客服管理
    3. 微信会话控制
    4. 微信获取聊天记录
  15. 微信摇一摇周边
    1. 申请开通微信摇一摇
    2. 微信设备ID
    3. 微信摇一摇页面管理
    4. 微信摇一摇上传图片素材
    5. 微信平台管理设备与页面的关联关系
    6. 微信摇一摇数据统计
    7. 微信摇一摇关注的JSAPI
    8. 微信摇一摇事件通知
    9. 微信html5页面获取设备信息
    10. 微信摇一摇获取设备及用户信息
    11. 微信摇一摇红包介绍说明
    12. 微信摇一摇周边错误码
  16. 微信连WIFI
    1. 微信连Wi-Fi开发者指引
    2. 微信Wi-Fi硬件鉴权协议接口说明
    3. 微信Wi-Fi软件服务管理接口说明
    4. 开通微信连Wi-Fi插件
    5. 微信Wi-Fi门店管理
    6. 微信Wi-Fi设备管理
    7. 配置微信WiFi联网方式
    8. 微信商家主页管理
    9. 微信平台Wi-Fi数据统计
    10. 连网后微信公众号下发消息
    11. 微信卡券投放
    12. 微信Wi-Fi接口返回错误码
    13. 微信连网过程常见错误码
  17. 微信扫一扫
    1. 微信扫一扫接入指南
    2. 微信上进行商品创建
    3. 微信商品发布
    4. 微信商品管理
    5. 微信扫一扫事件推送
    6. 微信一物一码专区
    7. 微信扫一扫错误码
    8. 微信公众号在线帮助工具
    9. 微信扫一扫常见问题
阅读(26.4k) 书签 赞(0) 我要纠错

微信平台 接收普通消息

2019-03-14 11:40 更新

接收普通消息

当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。

请注意：

1、关于重试的消息排重，推荐使用msgid排重。

2、微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。假如服务器无法保证在五秒内处理并回复，

可以直接回复空串，微信服务器不会对此作任何处理，并且不会发起重试。详情请见“发送消息-被动回复消息”。

3、如果开发者需要对用户消息在5秒内立即做出回应，即使用“发送消息-被动回复消息”接口向用户被动回复消息时，可以在

公众平台官网的开发者中心处设置消息加密。开启加密后，用户发来的消息和开发者回复的消息都会被加密（但开发者通过客服

接口等API调用形式向用户发送消息，则不受影响）。关于消息加解密的详细说明，请见“发送消息-被动回复消息加解密说明”。

各消息类型的推送XML数据包结构如下：

文本消息

<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消息创建时间 （整型）
MsgTypetext
Content文本消息内容
MsgId消息id，64位整型

使用网页调试工具调试该接口

图片消息

<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消息创建时间 （整型）
MsgTypeimage
PicUrl图片链接（由系统生成）
MediaId图片消息媒体id，可以调用多媒体文件下载接口拉取数据。
MsgId消息id，64位整型

使用网页调试工具调试该接口

语音消息

<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，可以调用多媒体文件下载接口拉取数据。
Format语音格式，如amr，speex等
MsgID消息id，64位整型

使用网页调试工具调试该接口


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

<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>
<Recognition><![CDATA[腾讯微信团队]]></Recognition>
<MsgId>1234567890123456</MsgId>
</xml>

参数说明：

参数描述
ToUserName开发者微信号
FromUserName发送方帐号（一个OpenID）
CreateTime消息创建时间 （整型）
MsgType语音为voice
MediaID语音消息媒体id，可以调用多媒体文件下载接口拉取该媒体
Format语音格式：amr
Recognition语音识别结果，UTF8编码
MsgID消息id，64位整型

视频消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>


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

使用网页调试工具调试该接口

小视频消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[shortvideo]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>


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

使用网页调试工具调试该接口

地理位置消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[位置信息]]></Label>
<MsgId>1234567890123456</MsgId>
</xml>


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

使用网页调试工具调试该接口

链接消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公众平台官网链接]]></Title>
<Description><![CDATA[公众平台官网链接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>


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

使用网页调试工具调试该接口

网页调试工具调试

以上内容是否对您有帮助：
← 微信 获取自定义菜单配置接口
微信平台开发 接收事件推送 →
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号