阿里云-云小站（无限量代金券发放中）
【腾讯云】云服务器、云数据库、COS、CDN、短信等热卖云产品特惠抢购

微信公众号-自定义菜单

221次阅读
没有评论

共计 11556 个字符，预计需要花费 29 分钟才能阅读完成。

一、菜单介绍

自定义菜单能够帮助公众号丰富界面，让用户更好更快地理解公众号的功能。开启自定义菜单后，公众号界面如图所示

微信公众号 - 自定义菜单

关于菜单：

  • 自定义菜单最多包括 3 个一级菜单，每个一级菜单最多包含 5 个二级菜单
  • 一级菜单最多 4 个汉字，二级菜单最多 7 个汉字，多出来的部分将会以“…”代替
  • 创建自定义菜单后，菜单的刷新策略是，在用户进入公众号会话页或公众号 profile 页时，如果发现上一次拉取菜单的请求在 5 分钟以前，就会拉取一下菜单，如果菜单有更新，就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果

自定义菜单接口可实现多种类型按钮：

  1. click

    点击推事件用户点击 click 类型按钮后，微信服务器会通过消息接口推送消息类型为 event 的结构给开发者（参考消息接口指南），并且带上按钮中开发者填写的 key 值，开发者可以通过自定义的 key 值与用户进行交互

  2. view

跳转 URL 用户点击 view 类型按钮后，微信客户端将会打开开发者在按钮中填写的网页 URL，可与网页授权获取用户基本信息接口结合，获得用户基本信息

  1. scancode_push

扫码推事件用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后显示扫描结果（如果是 URL，将进入 URL），且会将扫码的结果传给开发者，开发者可以下发消息

  1. scancode_waitmsg

扫码推事件且弹出“消息接收中”提示框用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后，将扫码的结果传给开发者，同时收起扫一扫工具，然后弹出“消息接收中”提示框，随后可能会收到开发者下发的消息

  1. pic_sysphoto

弹出系统拍照发图用户点击按钮后，微信客户端将调起系统相机，完成拍照操作后，会将拍摄的相片发送给开发者，并推送事件给开发者，同时收起系统相机，随后可能会收到开发者下发的消息

  1. pic_photo_or_album

弹出拍照或者相册发图用户点击按钮后，微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程

  1. pic_weixin

弹出微信相册发图器用户点击按钮后，微信客户端将调起微信相册，完成选择操作后，将选择的相片发送给开发者的服务器，并推送事件给开发者，同时收起相册，随后可能会收到开发者下发的消息

  1. location_select

弹出地理位置选择器用户点击按钮后，微信客户端将调起地理位置选择工具，完成选择操作后，将选择的地理位置发送给开发者的服务器，同时收起位置选择工具，随后可能会收到开发者下发的消息

  1. media_id

下发消息（除文本消息）用户点击 media_id 类型按钮后，微信服务器会将开发者填写的永久素材 id 对应的素材下发给用户，永久素材类型可以是图片、音频、视频、图文消息。请注意：永久素材 id 必须是在“素材管理 / 新增永久素材”接口上传后获得的合法 id

  1. view_limited

跳转图文消息 URL 用户点击 view_limited 类型按钮后，微信客户端将打开开发者在按钮中填写的永久素材 id 对应的图文消息 URL，永久素材类型只支持图文消息。请注意：永久素材 id 必须是在“素材管理 / 新增永久素材”接口上传后获得的合法 id

注意：3 到 8 的所有事件，仅支持微信 iPhone5.4.1 以上版本，和 Android5.4 以上版本的微信用户，旧版本微信用户点击后将没有回应，开发者也不能正常接收到事件推送。9 和 10，是专门给第三方平台旗下未微信认证（具体而言，是资质认证未通过）的订阅号准备的事件类型，它们是没有事件推送的，能力相对受限，其他类型的公众号不必使用

二、定制菜单

接口调用请求说明

http 请求方式：POST（请使用 https 协议）https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

menu_data 示例

    menu_data = {"button": [
            {"type": "click",
                "name": "sunck",
                "key": "V1001_SUNCK"
            },
            {"type": "view",
                "name": "主页",
                "url": "http://39.107.226.105/index/"
            },
            {"name": "佳丽",
                "sub_button": [
                    {"type": "click",
                        "name": "林志玲",
                        "key": "V1002_MASSAGE_BEAUTIFUL01"
                    },
                    {"type": "click",
                        "name": "范冰冰",
                        "key": "V1002_MASSAGE_BEAUTIFUL02"
                    },
                    {"type": "click",
                        "name": "关之琳",
                        "key": "V1002_MASSAGE_BEAUTIFUL03"
                    }，{"type": "view",
                        "name": "更多佳丽",
                        "url": "http://www.baidu.com/"
                    }
                ]
            }
        ]
    }
参数 是否必须 说明
button 是 一级菜单数组，个数应为 1~3 个
sub_button 否 二级菜单数组，个数应为 1~5 个
type 是 菜单的响应动作类型，view 表示网页类型，click 表示点击类型，miniprogram 表示小程序类型
name 是 菜单标题，不超过 16 个字节，子菜单不超过 60 个字节
key click 等点击类型必须 菜单 KEY 值，用于消息接口推送，不超过 128 字节
url view、miniprogram 类型必须 网页 链接，用户点击菜单可打开链接，不超过 1024 字节。type 为 miniprogram 时，不支持小程序的老版本客户端将打开本 url
media_id media_id 类型和 view_limited 类型必须 调用新增永久素材接口返回的合法 media_id
appid miniprogram 类型必须 小程序的 appid（仅认证公众号可配置）
pagepath miniprogram 类型必须 小程序的页面路径

正确时的返回 JSON 数据包

{"errcode":0,"errmsg":"ok"}

错误时的返回 JSON 数据包（示例为无效菜单名长度）

{"errcode":40018,"errmsg":"invalid button name size"}

myApp/urls.py

from django.urls import path, re_path
from myApp import views

urlpatterns = [path(r'index/', views.index),
    path(r'weixin/', views.weixin),
    path(r'access/', views.access),
    path(r'menu/', views.menu),
]

myApp/views.py

from django.shortcuts import render, HttpResponse
from django.views.decorators.csrf import csrf_exempt

import hashlib
import xmltodict
import time
import json
import requests

from myApp.accessToken import AccessToken

def index(request):
    pass
def responseXML(ToUserName, FromUserName, MsgType, **kwargs):
    pass
@csrf_exempt
def weixin(request):
    pass
def access(request):
    pass

def menu(request):
    access_toke = AccessToken.getAccessToken("client_credential", "wxffde55b11cc79754", "84e86527f090d6238ea1c0b96f5fc753")

    url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=%s"%access_toke
    menu_data = {"button": [
            {"type": "click",
                "name": "sunck",
                "key": "V1001_SUNCK"
            },
            {"type": "view",
                "name": "主页",
                "url": "http://39.107.226.105/index/"
            },
            {"name": "佳丽",
                "sub_button": [
                    {"type": "click",
                        "name": "林志玲",
                        "key": "V1002_MASSAGE_BEAUTIFUL01"
                    },
                    {"type": "click",
                        "name": "范冰冰",
                        "key": "V1002_MASSAGE_BEAUTIFUL02"
                    },
                    {"type": "click",
                        "name": "关之琳",
                        "key": "V1002_MASSAGE_BEAUTIFUL03"
                    },
                    {"type": "view",
                        "name": "更多佳丽",
                        "url": "http://www.baidu.com/"
                    }
                ]
            }
        ]
    }

    data = json.dumps(menu_data, ensure_ascii=False).encode()
    res = requests.post(url, data, "json")

    resDict = json.loads(res.content)
    if resDict.get("errcode") == 0:
        return HttpResponse("菜单修改成功")
    else:
        return HttpResponse("菜单修改失败")

浏览器地址栏输入：http://39.107.226.105/menu/

微信公众号 - 自定义菜单

微信公众号 - 自定义菜单

点击 主页

微信公众号 - 自定义菜单

点击 更多佳丽

微信公众号 - 自定义菜单

三、事件推送

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

微信公众号 - 自定义菜单

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

    <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>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，CLICK
    EventKey 事件 KEY 值，与自定义菜单接口中 KEY 值对应

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

    <xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[VIEW]]></Event>
<EventKey><![CDATA[www.qq.com]]></EventKey>
<MenuId>MENUID</MenuId>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，VIEW
    EventKey 事件 KEY 值，设置的跳转 URL
    MenuID 指菜单 ID，如果是个性化菜单，则可以通过这个字段，知道是哪个规则的菜单被点击了

  • scancode_push：扫码推事件的事件推送

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090502</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[scancode_push]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<ScanCodeInfo><ScanType><![CDATA[qrcode]]></ScanType>
<ScanResult><![CDATA[1]]></ScanResult>
</ScanCodeInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，scancode_push
    EventKey 事件 KEY 值，由开发者在创建菜单时设定
    ScanCodeInfo 扫描信息
    ScanType 扫描类型，一般是 qrcode
    ScanResult 扫描结果，即二维码对应的字符串信息

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

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090606</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[scancode_waitmsg]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<ScanCodeInfo><ScanType><![CDATA[qrcode]]></ScanType>
<ScanResult><![CDATA[2]]></ScanResult>
</ScanCodeInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，scancode_waitmsg
    EventKey 事件 KEY 值，与自定义菜单接口中 KEY 值对应
    ScanCodeInfo 扫描信息
    ScanType 扫描类型，一般是 qrcode
    ScanResult 扫描结果，即二维码对应的字符串信息

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

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090651</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_sysphoto]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[1b5f7c23b5bf75682a53e7b6d163e185]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，pic_sysphoto
    Event 事件类型，CLICK
    EventKey 事件 KEY 值，由开发者在创建菜单时设定
    SendPicsInfo 发送的图片信息
    Count 发送的图片数量
    PicList 图片列表
    PicMd5Sum 图片的 MD5 值，开发者若需要，可用于验证接收到图片

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

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090816</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_photo_or_album]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[5a75aaca956d97be686719218f275c6b]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，pic_photo_or_album
    EventKey 事件 KEY 值，由开发者在创建菜单时设定
    SendPicsInfo 发送的图片信息
    Count 发送的图片数量
    PicList 图片列表
    PicMd5Sum 图片的 MD5 值，开发者若需要，可用于验证接收到图片

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

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408090816</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[pic_weixin]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendPicsInfo><Count>1</Count>
<PicList><item><PicMd5Sum><![CDATA[5a75aaca956d97be686719218f275c6b]]></PicMd5Sum>
</item>
</PicList>
</SendPicsInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，pic_weixin
    EventKey 事件 KEY 值，由开发者在创建菜单时设定
    SendPicsInfo 发送的图片信息
    Count 发送的图片数量
    PicList 图片列表
    PicMd5Sum 图片的 MD5 值，开发者若需要，可用于验证接收到图片

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

    <xml><ToUserName><![CDATA[gh_e136c6e50636]]></ToUserName>
<FromUserName><![CDATA[oMgHVjngRipVsoxg6TuX3vz6glDg]]></FromUserName>
<CreateTime>1408091189</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[location_select]]></Event>
<EventKey><![CDATA[6]]></EventKey>
<SendLocationInfo><Location_X><![CDATA[23]]></Location_X>
<Location_Y><![CDATA[113]]></Location_Y>
<Scale><![CDATA[15]]></Scale>
<Label><![CDATA[ 广州市海珠区客村艺苑路 106 号]]></Label>
<Poiname><![CDATA[]]></Poiname>
</SendLocationInfo>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，location_select
    EventKey 事件 KEY 值，由开发者在创建菜单时设定
    SendLocationInfo 发送的位置信息
    Location_X X 坐标信息
    Location_Y Y 坐标信息
    Scale 精度，可理解为精度或者比例尺、越精细的话 scale 越高
    Label 地理位置的字符串信息
    Poiname 朋友圈 POI 的名字，可能为空

  • 点击菜单跳转小程序的事件推送

    <xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[view_miniprogram]]></Event>
<EventKey><![CDATA[pages/index/index]]></EventKey>
<MenuId>MENUID</MenuId>
</xml>
    参数 说明
    ToUserName 开发者 微信号
    FromUserName 发送方帐号（一个 OpenID）
    CreateTime 消息创建时间（整型）
    MsgType 消息类型，event
    Event 事件类型，view_miniprogram
    EventKey 事件 KEY 值，跳转的小程序路径
    MenuID 菜单 ID，如果是个性化菜单，则可以通过这个字段，知道是哪个规则的菜单被点击了 
from django.shortcuts import render, HttpResponse, redirect
from django.views.decorators.csrf import csrf_exempt

import hashlib
import xmltodict
import time
import json
import requests

from myApp.accessToken import AccessToken

def index(request):
    pass
def responseXML(ToUserName, FromUserName, MsgType, **kwargs):
    pass

@csrf_exempt
def weixin(request):
    if request.method == "GET":
        pass
    else:
        pass

        if MsgType == "text":
            pass
        elif MsgType == "event":
            Event = reqDict.get("Event")
            EventKey = reqDict.get("EventKey")
            print("-----------Event:", Event)
            print("-----------EventKey:", EventKey)
            if Event == "subscribe":
                pass
            elif Event == "unsubscribe":
                pass
            elif Event == "CLICK":
                Content = ""
                if EventKey == "V1001_SUNCK":
                    Content = "sunck is a good man"
                elif EventKey == "V1002_MASSAGE_BEAUTIFUL01":
                    Content = "林志玲为您服务"
                elif EventKey == "V1002_MASSAGE_BEAUTIFUL02":
                    Content = "范冰冰为您服务"
                elif EventKey == "V1002_MASSAGE_BEAUTIFUL03":
                    Content = "关之琳为您服务"
                resXml = responseXML(FromUserName, ToUserName, "text", Content=Content)
                return HttpResponse(resXml)
            elif Event == "VIEW":
                return HttpResponse("")
        elif MsgType == "image":
            pass
        elif MsgType == "voice":
            pass
        else:
            pass

def access(request):
    pass
def menu(request):
    pass

微信公众号 - 自定义菜单

四、删除接口

使用接口创建自定义菜单后，开发者还可使用接口删除当前使用的自定义菜单。另请注意，在个性化菜单时，调用此接口会删除默认菜单及全部个性化菜单

请求说明

http 请求方式：GET https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

返回说明：对应创建接口，正确的 Json 返回结果

{"errcode":0,"errmsg":"ok"}

myApp/urls.py

from django.urls import path, re_path
from myApp import views

urlpatterns = [path(r'index/', views.index),
    path(r'weixin/', views.weixin),
    path(r'access/', views.access),
    path(r'menu/', views.menu),
    path(r'dlmenu/', views.dlmenu),
]

myApp/views.py

from django.shortcuts import render, HttpResponse, redirect
from django.views.decorators.csrf import csrf_exempt

import hashlib
import xmltodict
import time
import json
import requests

from myApp.accessToken import AccessToken

def index(request):
    pass
def responseXML(ToUserName, FromUserName, MsgType, **kwargs):
    pass
@csrf_exempt
def weixin(request):
    pass
def access(request):
    pass
def menu(request):
    pass

def dlmenu(request):
    access_toke = AccessToken.getAccessToken("client_credential", "wxffde55b11cc79754", "84e86527f090d6238ea1c0b96f5fc753")

    url = "https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=%s"%access_toke
    res = requests.get(url)
    resDict = json.loads(res.content)
    if resDict.get("errcode") == 0:
        return HttpResponse("菜单删除成功")
    else:
        return HttpResponse("菜单删除失败")

正文完
星哥玩云-微信公众号
post-qrcode
微信公众号-自定义菜单
发表至： python语言
2022-05-26
 0
星锅
版权声明：本站原创文章，由 星锅 于2022-05-26发表，共计11556字。
转载说明：除特殊说明外本站文章皆由CC-4.0协议发布，转载请注明出处。
【腾讯云】推广者专属福利，新客户无门槛领取总价值高达2860元代金券，每种代金券限量500张，先到先得。
面向对象-枚举与垃圾回收
使用SQLite
使用模板
数据库数据查询
Python进程管理
返回函数
WSGI接口
流程控制-循环控制
阿里云-最新活动爆款每日限量供应
评论（没有评论）
验证码
星哥说事
星哥说事
分享互联网知识
阅读量
3386466
评论数
4
文章搜索
热门文章
基于开源MaxKB构建大语言模型的本地知识库系统

基于开源MaxKB构建大语言模型的本地知识库系统

基于开源 MaxKB 构建大语言模型的本地知识库系统 什么是 MaxKB MaxKB 是一款基于 LLM（La...
获取各大人工智能AI工具通过API和KEY调用的方法

获取各大人工智能AI工具通过API和KEY调用的方法

获取各大人工智能 AI 工具通过 API 和 KEY 调用的方法 前言 随着人工智能技术的飞速发展，AI 工具...
安装开源软件ChatALL（齐叨）来聚合各大人工智能工具

安装开源软件ChatALL（齐叨）来聚合各大人工智能工具

安装开源软件 ChatALL（齐叨）来聚合各大人工智能工具 前言 如果你跟我一样无论遇到什么问题都要询问人工智...
给你的NAS无限可能，安装小晓雅全家桶影音库

给你的NAS无限可能，安装小晓雅全家桶影音库

给你的 NAS 无限可能，安装小晓雅全家桶影音库 家庭存储和娱乐的需求日益增长。无论是高清电影、电视剧，还是音...
Python历史

Python历史

Python 是著名的“龟叔”Guido van Rossum 在 1989 年圣诞节期间，为了打发无聊的圣诞...
CDN
阿里云CDN-提高用户访问的响应速度和成功率
随机文章
介绍ansible的Ad-hoc与commands模块

介绍ansible的Ad-hoc与commands模块

Ad-Hoc 是指 ansible 下临时执行的一条命令，并且不需要保存的命令，对于复杂的命令后面会说 pla...
使用文本编辑器

使用文本编辑器

在 Python 的交互式命令行写程序，好处是一下就能得到结果，坏处是没法保存，下次还想运行的时候，还得再敲一...
自建一款开源音乐服务-Navidrome

自建一款开源音乐服务-Navidrome

自建一款开源音乐服务 -Navidrome Navidrome，一个开源的音乐服务器和播放器，提供了一个优雅且...
详解：Git 常用基本命令使用方法一览

详解：Git 常用基本命令使用方法一览

创建版本库 $ git clone #克隆远程版本库 $ git init #初始化本地版本库 修改 &...
定制类

定制类

看到类似 __slots__ 这种形如 __xxx__ 的变量或者函数名就要注意，这些在 Python 中是有...
一言一句话
-「」
【腾讯云】云服务器、云数据库、COS、CDN、短信等云产品特惠热卖中