消息配置

微俱聚平台负责将消息转发到“第三方应用”的消息接口,“第三方应用”按格式回复消息内容,微俱聚平台将消息回复到微信用户。

四种消息被转发到“第三方应用”

1、关键词模糊匹配(3组)

2、进入应用消息

3、退出应用消息

4、自定义菜单消息(新增)

 

 

关键词模糊匹配

公众账号收到消息时,若该消息与应用配置的消息模糊匹配,微俱聚平台将该消息转发到“第三方应用”。如应用配置了关键词“天气”,已购买并开启了该应用的公众账号收到消息:“广州天气”, 转发到应用的消息为“广州天气”,“应用”根据自身应用内容回复消息,如:“天气晴,气温28度,宜出游”

 

进入应用消息

公众账号收到进入应用的消息关键词,则30分钟内,微俱聚平台将所有消息转发到该“第三方应用”。如配置进入应用关键词“天气预报”,已购买并开启了该应用的公众账号收到消息:“天气预报”, 转发到应用的消息为“天气预报”,“应用”根据自身应用内容回复消息:如:“欢迎使用天气预报功能,请输入城市名称”。后续的半个小时内,消息将被天气预报应用接收,此时若收到消息“广州”,则应用可以回复广州相关的天气情况,若收到消息“深圳”则回复深圳相关天气情况

 

退出应用消息

公众号收到退出应用的消息关键词,可回复退出问候语等。后续的消息,除关键词模糊匹配外,其余的词将不会转发到应用。如公众号收到消息:“退出天气预报”。应用回复:“谢谢使用天气预报,欢迎下次使用”

 

自定义菜单消息(新增)

公众号配置“自定义菜单(微官网)链接”,则用户在自定义菜单和微官网模块中,可以选择第3方应用,配置节点。若为自定义菜单,则菜单消息转发到应用中;若为微官网,则直接打开配置“自定义菜单(微官网)链接”,页面参数为:wjj_uid_wuid和openid。

 

 

一、网址接入

微俱聚开放平台用户提交信息后,微俱聚服务器将发送GET请求到填写的URL上,并且带上四个参数:

参数 描述
signature 微俱聚加密签名
timestamp 时间戳
nonce 随机数
echostr 随机字符串

开发者通过检验signature对请求进行校验(下面有校验方式)。若确认此次GET请求来自微俱聚服务器,请原样返回echostr参数内容,则接入生效,否则接入失败。

signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。

加密/校验流程: 1. 将token、timestamp、nonce三个参数进行字典序排序 2. 将三个参数字符串拼接成一个字符串进行sha1加密 3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微俱聚

字典排序,php的sort方法,请加入SORT_STRING参数,默认使用字符串方式排序:sort($arr, SORT_STRING)

 

二、消息推送

当普通微信用户向公众账号发消息时,微俱聚服务器接收该消息后,将POST该消息到填写的URL上。结构如下

 

文本消息

<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 微俱聚帐号(wjj_uid_wuid,其中wjj为固定字符串前缀,uid为微俱聚账户唯一标识,wuid公众号唯一标识,如:wjj_310_15080)
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间 (整型)
MsgType text
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> <MsgId>1234567890123456</MsgId> </xml>
参数 描述
ToUserName 微俱聚帐号(wjj_uid_wuid,其中wjj为固定字符串前缀,uid为微俱聚账户唯一标识,wuid公众号唯一标识,如:wjj_310_15080)
FromUserName 发送方帐号(一个OpenID)
CreateTime 消息创建时间 (整型)
MsgType image
PicUrl 图片链接
MsgId 消息id,64位整型

 

事件消息(新增)

事件推送只支持微信4.5版本,目前开启自定义菜单接口事件推送。其余功能即将开放,敬请期待。

<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[EVENT]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> </xml>
参数 描述
ToUserName 微俱聚帐号(wjj_uid_wuid,其中wjj为固定字符串前缀,uid为微俱聚账户唯一标识,wuid公众号唯一标识,如:wjj_310_15080)
FromUserName 发送方微信号,若为普通用户,则是一个OpenID
CreateTime 消息创建时间
MsgType 消息类型,event
Event 事件类型,CLICK(自定义菜单点击事件)
EventKey 事件KEY值,与自定义菜单接口中KEY值对应

 

 

三、消息回复

对于每一个POST请求,第三方应用在响应包中返回特定xml结构,对该消息进行响应(现支持回复文本、图文)。

微俱聚服务器在五秒内收不到响应会断掉连接。回复xml结构如下:

 

回复文本消息

<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[content]]></Content> </xml>
参数 描述
ToUserName 接收方帐号(收到的OpenID)
FromUserName 微俱聚帐号(wjj_uid_wuid,其中wjj为固定字符串前缀,uid为微俱聚账户唯一标识,wuid公众号唯一标识,如:wjj_310_15080)
CreateTime 消息创建时间
MsgType text
Content 回复的消息内容,长度不超过2048字节

 

回复图文消息

<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[news]]></MsgType> <ArticleCount>2</ArticleCount> <Articles> <item> <Title><![CDATA[title1]]></Title> <Description><![CDATA[description1]]></Description> <PicUrl><![CDATA[picurl]]></PicUrl> <Url><![CDATA[url]]></Url> </item> <item> <Title><![CDATA[title]]></Title> <Description><![CDATA[description]]></Description> <PicUrl><![CDATA[picurl]]></PicUrl> <Url><![CDATA[url]]></Url> </item> </Articles> </xml>
参数 描述
ToUserName 接收方帐号(收到的OpenID)
FromUserName 微俱聚帐号(wjj_uid_wuid,其中wjj为固定字符串前缀,uid为微俱聚账户唯一标识,wuid公众号唯一标识,如:wjj_310_15080)
CreateTime 消息创建时间
MsgType news
ArticleCount 图文消息个数,限制为10条以内
Articles 多条图文消息信息,默认第一个item为大图
Title 图文消息标题
Description 图文消息描述
PicUrl 图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。
Url 点击图文消息跳转链接

 

注意事项

1.用户OpenID对一个公众号是固定唯一的串

2.请使用80端口

 

 

示例:【消息示例