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