2024年3月8日发(作者：)
微信消息接口指南
出自开放平台
跳转到： 导航, 搜索
目录
[隐藏]
1 简介
2 申请消息接口
3 网址接入
4 消息推送
o
4.1 文本消息
o
4.2 图片消息
o
4.3 地理位置消息
o
4.4 链接消息
o
4.5 事件推送
5 消息回复
o
5.1 回复文本消息
o
5.2 回复音乐消息
o
5.3 回复图文消息
6 注意事项
7 示例代码
简介
公众平台消息接口为开发者提供了一种新的消息处理方式。
申请消息接口
点击申请，填写网址url和token，其中token可由开发者可以任意填写，用作生成签名。
网址接入
公众平台用户提交信息后，微信服务器将发送GET请求到填写的URL上，并且带上四个参数：
参数
signature
timestamp
nonce
echostr
微信加密签名
时间戳
随机数
随机字符串
描述
开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，否则接入失败。
signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
加密/校验流程：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
消息推送
当普通微信用户向公众账号发消息时，微信服务器将POST该消息到填写的URL上。结构如下：
文本消息
参数
ToUserName
FromUserName
CreateTime
MsgType
Content
MsgId
开发者微信号
发送方帐号（一个OpenID）
消息创建时间 （整型）
text
文本消息内容
消息id，64位整型
描述
图片消息
参数
ToUserName
FromUserName
CreateTime
MsgType
PicUrl
MsgId
开发者微信号
发送方帐号（一个OpenID）
消息创建时间 （整型）
image
图片链接
消息id，64位整型
描述
地理位置消息
参数
ToUserName
FromUserName
CreateTime
MsgType
Location_X
Location_Y
Scale
Label
开发者微信号
发送方帐号（一个OpenID）
消息创建时间 （整型）
location
地理位置维度
地理位置精度
地图缩放大小
地理位置信息
描述
MsgId
消息id，64位整型
链接消息
参数
ToUserName
FromUserName
CreateTime
MsgType
Title
Description
Url
MsgId
接收方微信号
发送方微信号，若为普通用户，则是一个OpenID
消息创建时间
消息类型，link
消息标题
消息描述
消息链接
消息id，64位整型
描述
事件推送
事件推送只支持微信4.5版本，即将开放，敬请期待。
参数
ToUserName
FromUserName
CreateTime
MsgType
Event
Latitude
Longitude
Precision
接收方微信号
发送方微信号，若为普通用户，则是一个OpenID
消息创建时间
消息类型，event
事件类型，有ENTER(进入会话)和LOCATION(地理位置)
地理位置维度，事件类型为LOCATION的时存在
地理位置经度，事件类型为LOCATION的时存在
地理位置精度，事件类型为LOCATION的时存在
描述
消息回复
对于每一个POST请求，开发者在响应包中返回特定xml结构，对该消息进行响应（现支持回复文本、图文、语音、视频、音乐和对收到的消息进行星标操作）。
微信服务器在五秒内收不到响应会断掉连接。
回复xml结构如下：
回复文本消息
参数
ToUserName
FromUserName
描述
接收方帐号（收到的OpenID）
开发者微信号
CreateTime
MsgType
Content
FuncFlag
消息创建时间
text
回复的消息内容
位0x0001被标志时，星标刚收到的消息。
回复音乐消息
参数
ToUserName
FromUserName
CreateTime
MsgType
MusicUrl
HQMusicUrl
FuncFlag
描述
接收方帐号（收到的OpenID）
开发者微信号
消息创建时间
music
音乐链接
高质量音乐链接，WIFI环境优先使用该链接播放音乐
位0x0001被标志时，星标刚收到的消息。
回复图文消息
参数
ToUserName
FromUserName
CreateTime
MsgType
ArticleCount
Articles
Title
Description
PicUrl
Url
描述
接收方帐号（收到的OpenID）
开发者微信号
消息创建时间
news
图文消息个数，限制为10条以内
多条图文消息信息，默认第一个item为大图
图文消息标题
图文消息描述
图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80，限制图片链接的域名需要与开发者填写的基本资料中的Url一致
点击图文消息跳转链接
注意事项
1.用户OpenID对一个公众号是固定唯一的串
2.请使用80端口
3.用户关注公众号，微信公众平台服务器推送一条内容为Hello2BizUser的文本消息到第三方服务器
示例代码
PHP：下载
发布评论