官方接口 - 自定义菜单

自定义菜单创建

调用方法:.create_menu(menu_data)

参数说明:

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:{"errcode": 0, "errmsg": "ok"},一般无需理会该返回值,创建失败会抛出异常,捕获异常即可。

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:自定义菜单创建接口

自定义菜单查询

调用方法:.get_menu()

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据,因示例过长,请直接点击 自定义菜单查询接口 查看。

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:自定义菜单查询接口

自定义菜单删除

调用方法:.delete_menu()

调用前检查:App ID / App Secret

返回值:正常返回官方接口的 JSON 数据:{"errcode": 0, "errmsg": "ok"},一般无需理会该返回值,删除失败会抛出异常,捕获异常即可。

异常:当发生失败时抛出 exceptions.OfficialAPIError 异常,该异常包含了错误的代号与原因信息。

对应官方文档:自定义菜单删除接口

自定义菜单事件推送

当自定义菜单事件推送 XML 到达并经过 .parse_data() 方法解析后,你可以通过下面的代码判断该信息属于事件:

from wechat_sdk.messages import EventMessage
if isinstance(wechat.message, EventMessage):

然后你可以继续通过 wechat.message.type 来继续判断它属于下列哪种事件并获取事件内容。

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

判断代码:wechat.message.type == 'click'

判断后的信息获取:

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

判断代码:wechat.message.type == 'view'

判断后的信息获取:

scancode_push:扫码推事件的事件推送

判断代码:wechat.message.type == 'scancode_push'

判断后的信息获取:

scancode_waitmsg:扫码推事件且弹出“消息接收中”提示框的事件推送

判断代码:wechat.message.type == 'scancode_waitmsg'

判断后的信息获取:

pic_sysphoto:弹出系统拍照发图的事件推送

判断代码:wechat.message.type == 'pic_sysphoto'

判断后的信息获取:

pic_photo_or_album:弹出拍照或者相册发图的事件推送

判断代码:wechat.message.type == 'pic_photo_or_album'

判断后的信息获取:

pic_weixin:弹出微信相册发图器的事件推送

判断代码:wechat.message.type == 'pic_weixin'

判断后的信息获取:

location_select:弹出地理位置选择器的事件推送

判断代码:wechat.message.type == 'location_select'

判断后的信息获取:

个性化菜单接口

待开发

获取公众号的菜单配置

待开发