[[385026]]

概述

自定義菜單能夠幫助公眾號豐富界面，讓用戶更好更快地理解公眾號的功能。

文檔定義

接口調用請求說明

http請求方式：POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

click和view的請求示例

{ 
     "button":[ 
     {   
          "type":"click", 
          "name":"今日歌曲", 
          "key":"V1001_TODAY_MUSIC" 
      }, 
      { 
           "name":"菜單", 
           "sub_button":[ 
           {   
               "type":"view", 
               "name":"搜索", 
               "url":"http://www.soso.com/" 
            }, 
            { 
                 "type":"miniprogram", 
                 "name":"wxa", 
                 "url":"http://mp.weixin.qq.com", 
                 "appid":"wx286b93c14bbf93aa", 
                 "pagepath":"pages/lunar/index" 
             }, 
            { 
               "type":"click", 
               "name":"贊一下我們", 
               "key":"V1001_GOOD" 
            }] 
       }] 
 } 

實現方式

1、定義菜單json文檔

{ 
  "button": [ 
 
    { 
      "name": "運營提升", 
      "sub_button": [ 
        { 
          "type": "view", 
          "name": "免費試用", 
          "url": "https://acc.bqool.cn/freetrial" 
        }, 
        { 
          "type": "view", 
          "name": "新 AI調價", 
          "url": "https://www.bqool.cn/products/repricing-central/" 
        }, 
        { 
          "type": "view", 
          "name": "熱 賣家酷", 
          "url": "https://www.bqool.cn/bigcentral/" 
        }, 
 
        { 
          "type": "view", 
          "name": "熱 選品酷", 
          "url": "https://www.bqool.cn/products/chrome-extension/" 
        }, 
        { 
          "type": "view", 
          "name": "更多產品..", 
          "url": "https://www.bqool.cn/" 
        } 
      ] 
    }, 
    { 
      "name": "酷仔部落", 
      "sub_button": [ 
        { 
          "type": "view", 
          "name": "限時福利", 
          "url": "https://mp.weixin.qq.com/mp/video?__biz=MzIzMjc1NTY3MQ==&mid=100007240&sn=04973c15f924fc78a78fec50cd75d706&vid=wxv_1500216251938308102&idx=1&vidsn=a27a0d1d9503802f9f9095534d4d2507&fromid=1&xtrack=1&scene=0&subscene=10000&clicktime=1600054770&enterid=1600054770#wechat_redirect" 
        }, 
        { 
          "type": "view", 
          "name": "成功案例", 
          "url": "https://www.bqool.cn/user-stories/" 
        }, 
        { 
          "type": "view", 
          "name": "教學視頻", 
          "url": "https://www.bqool.cn/video-tutorial/" 
        }, 
        { 
          "type": "view", 
          "name": "部落文章", 
          "url": "https://mp.weixin.qq.com/mp/homepage?__biz=MzIzMjc1NTY3MQ==&hid=1&sn=db4536a338f0e128ce2e5db089f381e1&scene=18" 
        } 
 
      ] 
    }, 
    { 
      "name": "權益中心", 
      "sub_button": [ 
        { 
          "type": "view", 
          "name": "簽到抽獎", 
          "url": "http://u135069.s.24hwpro.com/web/game/game_id/1220189859" 
        }, 
        { 
          "type": "view", 
          "name": "商務合作", 
          "url": "https://h5.eqxiul.com/ls/EyOfmUXk" 
        }, 
        { 
          "type": "view", 
          "name": "電商服務", 
          "url": "https://www.bqool.cn/seller-services/" 
        }, 
        { 
          "type": "view", 
          "name": "聯系酷仔", 
          "url": "https://admin.qidian.qq.com/template/blue/mp/menu/qr-code-jump.html?linkType=0&env=ol&kfuin=2852161981&fid=95&key=71d05b6c5e0a545f0be22ec831f9d7af&cate=1&type=16&ftype=1&_type=wpa&qidian=true" 
        } 
      ] 
    } 
  ] 
} 

2、讀取json文件

/// <summary> 
        /// 自定義菜單 
        /// </summary> 
        /// <param name="OPENID"></param> 
        /// <param name="template_id"></param> 
        /// <returns></returns> 
        [BQoolException] 
        [HttpPost] 
        public ApiResult CustomMenus(string CustomMenusPwd) 
        { 
            if (!string.IsNullOrWhiteSpace(CustomMenusPwd) && CustomMenusPwd.Trim() == MvcTools.GetAppSetting("WeixinCustomMenus")) 
            { 
                CustomMenusParam param = new CustomMenusParam() { Account = "sys", UpdateUser = "sys" }; 
                param.Jsonstr = WeiXinHelper.ReadAccess(HttpRuntime.AppDomainAppPath.ToString() + "/App_Data/WeChat/Custom_Menus.json"); 
                ApiResult result = _weChatAlertsService.CustomMenus(param, AppId, Appsecret); 
                return result; 
            } 
            else 
            { 
                return new ApiResult() { Success = false, Code = ApiResultCode.InvalidError, ErrorMessage = ApiResultCode.ErrorMessages[ApiResultCode.InvalidError] }; 
            } 
        } 

3、post提交數據到微信服務器

private static Tuple<WxBaseInfo, string, string> CustomMenus(string AppId, string Appsecret, string jsonstr, bool isResh) 
        { 
            var accessToken = TryGetAccessToken(AppId, Appsecret, isResh); 
            string url = APIConfig.Custom_Menus(accessToken); 
            string str = APIConfig.CreatePostHttpResponse(url, jsonstr); 
            _logger.Debug("自定義菜單\r\n" + "輸入：" + url + "\r\n" + jsonstr + "\r\n輸出：" + str); 
            return new Tuple<WxBaseInfo, string, string>(JsonConvert.DeserializeObject<WxBaseInfo>(str), url, jsonstr); 
        } 

public static string WEIXIN_URL = "https://api.weixin.qq.com/"; 
 
        public static string Custom_Menus(string token) 
        { 
            return String.Format(WEIXIN_URL + "cgi-bin/menu/create?access_token={0}", token); 
        } 

備注：一般情況下，不管是創建或者修改菜單，使用 "cgi-bin/menu/create這個接口即可。