自定义菜单事件推送

跳转到: 导航, 搜索

用户点击自定义菜单后,微博会把点击事件推送给开发者,请注意,点击菜单弹出子菜单,不会产生上报。

点击菜单拉取消息时的事件推送

点击Click菜单事件,推送的JSON格式如下:

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "自定义菜单点击事件消息",
    "data": {
        "subtype": "click",
        "key": "EVENT_KEY"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案,subtype为click时为 "自定义菜单点击事件消息";
data string 消息内容
data:subtype string click, 自定义菜单点击事件
data:key string 被点击的自定义菜单的key值

点击菜单跳转链接时的事件推送

点击View菜单事件,推送的JSON格式如下:

{
    "type": "event",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "自定义菜单跳转链接事件消息",
    "data": {
        "subtype": "view",
        "key": "url"
    }
}
返回值说明
属性 值的类型 说明描述
type string event
receiver_id int64 消息的接收者
sender_id int64 消息的发送者
created_at string 消息创建时间
text string 默认文案,subtype为view时为 "自定义菜单跳转链接事件消息";
data string 消息内容
data:subtype string view, 自定义菜单跳转链接事件消息
data:key string 该按钮设置的url

微信XML格式兼容

微博消息推送服务完全兼容“微信XML格式”,以方便基于微信公众平台做了开发的第三方能够更为顺畅得迁移; 第三方可以通过http://open.weibo.com/wiki/Eps/push/set_format 接口来选择自己需要的格式是XML还是JSON;

自定义菜单事件推送的XML格式如下:

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>
返回值说明
XML参数 在JSON格式中对应的参数 说明描述
ToUserName receiver_id 消息的接收者
FromUserName sender_id 消息的发送者
CreateTime created_at 消息创建时间
MsgType type event
Event data:subtype click为自定义菜单点击事件,view为自定义菜单跳转链接事件。
EventKey data:key click事件时为被点击的自定义菜单的key值,view事件时为该按钮设置的url。
文档更新时间: 2014-06-03