自定义菜单能够帮助公众号丰富界面,让用户更好更快地理解公众号的功能。
- 自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。
- 一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。
- 创建自定义菜单后,菜单的刷新策略是,在用户进入公众号会话页或公众号profile页时,如果发现上一次拉取菜单的请求在5分钟以前,就会拉取一下菜单,如果菜单有更新,就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果
自定义菜单接口可实现多种类型按钮:
- click: 点击推事件: 微信推消息类型为event的结构给开发者,并带上按钮中开发者填写的key值.开发者可以通过自定义的key值与用户进行交互. 微信公众平台会把此次单击事件推送给接口程序。
<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>
- view: 跳转URL. 微信客户端打开开发者在按钮中填写的网页URL. 微信公众平台不会上报单击事件,而是直接跳转到对应的URL.
- scancode_push: 扫码推事件。 微信客户端将调用扫一扫工具,完成扫码操作后显示扫码结果(如果是URL,将进入URL)
接口程序会收到XML数据包,但用户收不到这个消息,而是直接运行解码后的内容<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[scancode_push]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> <ScanCodeInfo> <ScanType><![CDATA[qrcode]]></ScanType> <ScanResult><![CDATA[http://www.baidu.com]]></ScanResult> <EventKey><![CDATA[EVENTKEY]]></EventKey> </ScanCodeInfo> </xml>
- scancode_waitmsg: 扫码推事件且弹出 ‘消息接收中’的提示框
微信客户端将调用扫一扫工具,完成扫码操作后,将扫码的结果传送给开发者,同时收起‘扫一扫’功能,然后弹出‘消息接收中’的提示框<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[scancode_waitmsg]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> <ScanCodeInfo> <ScanType><![CDATA[qrcode]]></ScanType> <ScanResult><![CDATA[http://www.baidu.com]]></ScanResult> <EventKey><![CDATA[EVENTKEY]]></EventKey> </ScanCodeInfo> </xml>
- pic_sysphoto: 弹出系统拍照发图。 将拍摄的照片发送给开发者,并推送事件给开发者。
单击这个类型的菜单后,没有XML数据推送过来,而拍照以后再发过来时,就收到一个图片消息:(推送什么样的事件消息,后面验证后再贴图)<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>
- pic_photo_or_album:弹出拍照或相册发图:
先推送事件,再推送图片消息<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[pic_photo_or_album]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> <SendPicsInfo> <Count><![CDATA[1]]></Count> <PicList> <item> <PicMd5Sum><![CDATA[58f4xxxxxxxxxx]]></PicMd5Sum> </item> </PicList> </SendPicsInfo> </xml> <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>
- pic_weixin:弹出微信相册发图
先推送事件,再推送图片消息<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[pic_weixin]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> <SendPicsInfo> <Count><![CDATA[3]]></Count> <PicList> <item> <PicMd5Sum><![CDATA[58f4xxxxxxxxxx]]></PicMd5Sum> </item> <item> <PicMd5Sum><![CDATA[58f4xxxxxxxxxx]]></PicMd5Sum> </item> <item> <PicMd5Sum><![CDATA[58f4xxxxxxxxxx]]></PicMd5Sum> </item> </PicList> </SendPicsInfo> </xml> <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>123456789012345x</MsgId> </xml> <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> <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> 对于上述每个图片的消息,后台收到都能进行单独回应
- location_select: 弹出地理位置选择器。 调用地理位置选择功能。
在用户发送位置后,会再推送一个地理位置消息功能给用户<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[location_select]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> <SendLocationInfo> <Location_X><![CDATA[23.134521]]></Location_X> <Location_Y><![CDATA[113.358803]]></Location_Y> <Scale><![CDATA[20]]></Scale> <Label><![CDATA[位置信息]]></Label> <Poiname><![CDATA[]]></Poiname> <EventKey><![CDATA[EVENTKEY]]></EventKey> </SendLocationInfo> </xml> <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>
- media_id: 下发消息(除文本消息)用户点击media_id类型按钮后,微信服务器将开发者填写的永久素材id 对应的素材下发给用户。永久素材类型可以是图片、音频、视频、图文消息。请注意:永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。
- view_limited: 跳转图文消息URL 。微信客户端将打开开发者在按钮中填写的永久素材id对应的图文消息URL,永久素材类型只支持图文消息。请注意:永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。 ?
9和10,是专门给第三方平台旗下未微信认证(具体而言,是资质认证未通过)的订阅号准备的事件类型,它们是没有事件推送的,能力相对受限,其他类型的公众号不必使用。
创建菜单:
接口: http请求方式:POST(请使用https协议) https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
返回:{"errcode":0,"errmsg":"ok"} 或
{"errcode":40018,"errmsg":"invalid button name size"}
def create_menu(access_token,json_menu): print(json_menu) headers = { ‘content_type‘: "application/json" } json_menu = json.dumps(json_menu,ensure_ascii=False) create_url = ‘https://api.weixin.qq.com/cgi-bin/menu/create?access_token={0}‘.format(access_token) response = requests.post(create_url,json_menu.encode(‘utf-8‘),headers=headers) return json.loads(response.text)
注意:这个debug了好久。首先需要将 python的 dict转化为json 数据,然后在传入post 参数时进行 utf-8封装。不然 就是创建不成功,总是返回:{‘errcode‘: 40016, ‘errmsg‘: ‘invalid button size hint
menu_data:
menu_data = { "button": [ { "name": "新手", "sub_button": [ { "type": "click", "name": "点击拉歌曲", "key": "click_music" }, { "type": "view", "name": "查看百度", "url": "http://www.baidu.com" }, { "type": "scancode_waitmsg", "name": "扫码等消息", "key": "scancode_waitmsg_event" }, { "type": "pic_sysphoto", "name": "系统相册", "key": "pic_sysphoto_event" } ] }, { "name": "其他", "sub_button": [ { "type": "scancode_push", "name": "扫码推事件", "key": "scancode_push_event" }, { "type": "pic_photo_or_album", "name": "拍照或选照片", "key": "pic_photo_or_album_event" }, { "type": "pic_weixin", "name": "微信相册", "key": "pic_weixin_event" }, { "type": "location_select", "name": "发送位置", "key": "location_select_event" } ] } ] }
查询菜单:
接口: http请求方式: GET(请使用https协议)https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info?access_token=ACCESS_TOKEN
返回:https://developers.weixin.qq.com/doc/offiaccount/Custom_Menus/Querying_Custom_Menus.html
alue、url、key等字段 对于不同的菜单类型,value的值意义不同。官网上设置的自定义菜单: Text:保存文字到value; Img、voice:保存mediaID到value; Video:保存视频下载链接到value; News:保存图文消息到news_info,同时保存mediaID到value; View:保存链接到url。 使用API设置的自定义菜单: click、scancode_push、scancode_waitmsg、pic_sysphoto、pic_photo_or_album、 pic_weixin、location_select:保存值到key;view:保存链接到url
def query_menu(access_token): query_url = ‘https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info?access_token=%s‘% access_token response = requests.get(query_url) return json.loads(response.content)
删除菜单:
接口: http请求方式:GET https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
返回:对应创建接口,正确的Json返回结果:
{"errcode":0,"errmsg":"ok"}
注意: 在个性化菜单时,调用此接口会删除默认菜单及全部个性化菜单。
def delete_menu(access_token): delete_url = ‘https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=%s‘% access_token response = requests.get(delete_url) return json.loads(response.text)
原文地址:https://www.cnblogs.com/ahMay/p/12047826.html