微信公眾號開發：自定義菜單

来源:https://www.cnblogs.com/i3yuan/archive/2019/05/19/10888418.html
-Advertisement-
Play Games

前言: 回顧之前的微信公眾號配置和消息處理的內容，我們已經掌握瞭如何配置伺服器與微信公眾號建立連接，也掌握了通過消息管理的方式，對用戶的信息進行處理，完成公眾號消息回覆功能，實現公眾號與用戶之間的完整對話。而在本文將針對自定義菜單做簡單的開發應用，微信公眾平臺具有自定義菜單的功能。開發者可利用該功能 ...


前言:

      回顧之前的微信公眾號配置和消息處理的內容，我們已經掌握瞭如何配置伺服器與微信公眾號建立連接，也掌握了通過消息管理的方式，對用戶的信息進行處理，完成公眾號消息回覆功能，實現公眾號與用戶之間的完整對話。而在本文將針對自定義菜單做簡單的開發應用，微信公眾平臺具有自定義菜單的功能。開發者可利用該功能為公眾賬號的會話界面底部增加自定義菜單，用戶點擊菜單中的選項，可以調出相應的回覆信息或網頁鏈接。自定義菜單介面將為公眾賬號的信息展示空間提供更多可能性。

說明：

  1、自定義菜單最多包括3個一級菜單，每個一級菜單最多包含5個二級菜單。
  2、一級菜單最多4個漢字，二級菜單最多7個漢字，多出來的部分將會以“...”代替。
  3、創建自定義菜單後，菜單的刷新策略是，在用戶進入公眾號會話頁或公眾號profile頁時，如果發現上一次拉取菜單的請求在5分鐘以前，就會拉取一下菜單，如果菜單有更新，就會刷新客戶端的菜單。測試時可以嘗試取消關註公眾賬號後再次關註，則可以看到創建後的效果。

類型:

      自定義菜單介面可實現多種類型按鈕，如下：

  1、click：點擊推事件用戶點擊click類型按鈕後，微信伺服器會通過消息介面推送消息類型為event的結構給開發者（參考消息介面指南），並且帶上按鈕中開發者填寫的key值，開發者可以通過自定義的key值與用戶進行交互；
  2、view：跳轉URL用戶點擊view類型按鈕後，微信客戶端將會打開開發者在按鈕中填寫的網頁URL，可與網頁授權獲取用戶基本信息介面結合，獲得用戶基本信息。
  3、scancode_push：掃碼推事件用戶點擊按鈕後，微信客戶端將調起掃一掃工具，完成掃碼操作後顯示掃描結果（如果是URL，將進入URL），且會將掃碼的結果傳給開發者，開發者可以下發消息。
  4、scancode_waitmsg：掃碼推事件且彈出“消息接收中”提示框用戶點擊按鈕後，微信客戶端將調起掃一掃工具，完成掃碼操作後，將掃碼的結果傳給開發者，同時收起掃一掃工具，然後彈出“消息接收中”提示框，隨後可能會收到開發者下發的消息。
  5、pic_sysphoto：彈出系統拍照發圖用戶點擊按鈕後，微信客戶端將調起系統相機，完成拍照操作後，會將拍攝的相片發送給開發者，並推送事件給開發者，同時收起系統相機，隨後可能會收到開發者下發的消息。
  6、pic_photo_or_album：彈出拍照或者相冊發圖用戶點擊按鈕後，微信客戶端將彈出選擇器供用戶選擇“拍照”或者“從手機相冊選擇”。用戶選擇後即走其他兩種流程。
  7、pic_weixin：彈出微信相冊發圖器用戶點擊按鈕後，微信客戶端將調起微信相冊，完成選擇操作後，將選擇的相片發送給開發者的伺服器，並推送事件給開發者，同時收起相冊，隨後可能會收到開發者下發的消息。
  8、location_select：彈出地理位置選擇器用戶點擊按鈕後，微信客戶端將調起地理位置選擇工具，完成選擇操作後，將選擇的地理位置發送給開發者的伺服器，同時收起位置選擇工具，隨後可能會收到開發者下發的消息。
  9、media_id：下發消息（除文本消息）用戶點擊media_id類型按鈕後，微信伺服器會將開發者填寫的永久素材id對應的素材下發給用戶，永久素材類型可以是圖片、音頻、視頻、圖文消息。請註意：永久素材id必須是在“素材管理/新增永久素材”介面上傳後獲得的合法id。
  10、view_limited：跳轉圖文消息URL用戶點擊view_limited類型按鈕後，微信客戶端將打開開發者在按鈕中填寫的永久素材id對應的圖文消息URL，永久素材類型只支持圖文消息。請註意：永久素材id必須是在“素材管理/新增永久素材”介面上傳後獲得的合法id。

 資源：

  1、藉助Senparc.Weixin SDK

  2、只需要前端和控制器，不需要資料庫

開始:

控制器：

      新建一個UserMessageHandler.cs，實現編輯菜單，獲取菜單，刪除菜單

1、編輯(新增)菜單

        /// <summary>
        /// 編輯新增菜單
        /// </summary>
        /// <param name="resultFull">獲取菜單的完整結果</param>
        /// <param name="MenuMatchRule">個性化菜單規則</param>
        /// <returns></returns>
        [HttpPost]
        public ActionResult CreateMenu(GetMenuResultFull resultFull, MenuMatchRule MenuMatchRule)
        {
            // 使用appid 和appsecret 向微信憑證獲取介面請求access_token
            string AccessToken = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetToken(AppId, AppSecret).access_token;  //獲取AccessToken值
            var IsAddCondidional = MenuMatchRule != null && !MenuMatchRule.CheckAllNull();
            var apiName = string.Format("使用介面：{0}。", (IsAddCondidional ? "個性化菜單介面" : "普通自定義菜單介面"));
            try
            {
                //重新整理按鈕信息
                WxJsonResult result = null;
                IButtonGroupBase buttonGroup = null;
                if (IsAddCondidional)
                {
                    //個性化介面
                    //微信公眾平臺新增了個性化菜單介面，開發者可以通過該介面，讓公眾號的不同用戶群體看到不一樣的自定義菜單
                    buttonGroup = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetMenuFromJsonResult(resultFull, new ConditionalButtonGroup()).menu;
                    var ConditionalButtonGroup = buttonGroup as ConditionalButtonGroup;
                    ConditionalButtonGroup.matchrule = MenuMatchRule;
                    result = Senparc.Weixin.MP.CommonAPIs.CommonApi.CreateMenuConditional(AccessToken, ConditionalButtonGroup);
                    apiName += string.Format("menuid：{0}。", (result as CreateMenuConditionalResult).menuid);
                }
                else
                {
                    //普通介面
                    buttonGroup = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetMenuFromJsonResult(resultFull, new ButtonGroup()).menu;
                    result = Senparc.Weixin.MP.CommonAPIs.CommonApi.CreateMenu(AccessToken, buttonGroup);
                }

                var json = new
                {
                    Success = result.errmsg == "ok",
                    Message = "菜單更新成功。" + apiName
                };
                return Json(json);
            }
            catch (Exception ex)
            {
                var json = new { Success = false, Message = string.Format("更新失敗：{0}。{1}", ex.Message, apiName) };
                return Json(json);
            }
        }

2、獲取菜單

        /// <summary>
        /// 獲取菜單
        /// </summary>
        /// <returns></returns>
        public ActionResult GetMenu()
        {
            string AccessToken = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetToken(AppId, AppSecret).access_token;  //獲取AccessToken值
            var result = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetMenu(AccessToken);
            if (result == null)
            {
                return Json(new { error = "菜單不存在或驗證失敗！" }, JsonRequestBehavior.AllowGet);
            }
            return Json(result, JsonRequestBehavior.AllowGet);
        }

3、刪除菜單

        /// <summary>
        /// 刪除菜單
        /// </summary>
        /// <returns></returns>
        public ActionResult DeleteMenu()
        {
            try
            {
                string AccessToken = Senparc.Weixin.MP.CommonAPIs.CommonApi.GetToken(AppId, AppSecret).access_token;  //獲取AccessToken值
                var result = Senparc.Weixin.MP.CommonAPIs.CommonApi.DeleteMenu(AccessToken);
                var json = new
                {
                    Success = result.errmsg == "ok",
                    Message = result.errmsg
                };
                return Json(json, JsonRequestBehavior.AllowGet);
            }
            catch (Exception ex)
            {
                var json = new { Success = false, Message = ex.Message };
                return Json(json, JsonRequestBehavior.AllowGet);
            }
        }
    }

藉助Senparc.Weixin SDK，快速的完成了對普通菜單和個性化菜單的實現。

前端界面：

在前端頁面中，我們可以將頁面設計為這種佈局的樣式

請求示例：

{
    "button": [
        {
            "name": "灌籃高手",
            "sub_button": [
                {
                    "type": "view",
                    "url": "https://www.cnblogs.com/i3yuan/",
                    "name": "陵南高中"
                },
                {
                    "type": "view",
                    "url": "https://www.cnblogs.com/i3yuan/",
                    "name": "海南高中"
                },
                {
                    "type": "view",
                    "url": "https://www.cnblogs.com/i3yuan/",
                    "name": "湘北高中"
                }
            ]
        },
        {
            "name": "漫畫集",
            "sub_button": [
                {
                    "type": "view",
                    "url": "https://www.cnblogs.com/i3yuan/",
                    "name": "趣味漫畫"
                }
            ]
        },
        {
            "type": "view",
            "url": "",
            "name": "個人中心"
        }
    ]
}

 效果：

總結：

1.公眾號菜單分為個性化菜單和普通菜單，普通菜單是關註之後就可以查看的，而個性化菜單是根據條件才能看到的（條件：用戶標簽、性別、手機操作系統、地區、語言），個性化菜單更好實現靈活的業務運營

2.通過開源項目中的Senparc.Weixin SDK，快速的完成菜單的編輯、獲取、刪除，只需將前端生成的菜單內容轉換為對應的json格式，後臺獲取內容，實現菜單功能

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Python中的列表
    1.什麼是列表？ 列表是由一組按特定順序排列的元素組成。 2.如何表示？ 在Python中用方括弧（[ ]）來表示列表。慄子如下： 控制台列印如下： 沒錯，它將列印列表的內部表示，包括方括弧。 3.如何去訪問列表元素？ console(控制台): 所以說訪問列表的元素，可以在列表名後加方括弧，方括弧 ...
  • AJPFX簡述Scanner類的特點
    hasNextInt() ：判斷是否還有下一個輸入項,其中Xxx可以是Int,Double等。如果需要判斷是否包含下一個字元串，則可以省略Xxx nextInt(): 獲取下一個輸入項。Xxx的含義和上個方法中的Xxx相同,預設情況下，Scanner使用空格，回車等作為分隔符 public stat ...
  • ArrayList和LinkedList區別（螞蟻金服面試題）
    1. 是否保證線程安全： ArrayList 和 LinkedList 都是不同步的，也就是不保證線程安全； 2. 底層數據結構： Arraylist 底層使用的是Object數組；LinkedList 底層使用的是雙向鏈表數據結構（JDK1.6之前為迴圈鏈表，JDK1.7取消了迴圈。註意雙向鏈表和 ...
  • [WPF自定義控制項庫]瞭解如何自定義ItemsControl
    1. 前言 對WPF來說ContentControl和 "ItemsControl" 是最重要的兩個控制項。 顧名思義，ItemsControl表示可用於呈現一組Item的控制項。大部分時候我們並不需要自定義ItemsControl，因為WPF提供了一大堆ItemsControl的派生類：Headere ...
  • 【轉載】Sqlserver使用Right函數從最右邊向前截取固定長度字元串
    在SQL語句查詢過程中，Sqlserver支持使用LEFT()、RIGHT()、SUBSTRING()等幾個函數對字元串進行截取操作，其中Left函數表示從開始字元向後截取多少個字元，Right函數表示從最後位置向前截取多少個字元，SUBSTRING()則可指定截取的起始位置以及截取長度。此文著重介 ...
  • 【轉載】C#使用Trim方法去除字元串前後的所有空格
    在C#語言程式開發過程中，很多時候需要對字元串對象的前後空格進行去除，此時就需要使用到Trim()方法來實現這個功能，Trim()方法可以快速去除字元串前端和後端的所有空格。 例如有個字元：string str=" Abc "; 則需要去除字元串前後空格的話，則可以採用：str=str.Trim() ...
  • Dapper的正確使用姿勢
    Dapper優勢和缺點 優點 高性能、易排查、易運維、靈活可控 缺點 和EF相比，手寫sql當修改表結構不易發現bug。 習慣了EF後再來使用Dapper，會很難適應那種沒有了強類型的安全感。不過可以用單元測和心細來避免。 資料庫連接 問題：IDbConnection需不需要手動Open打開連接 答 ...
  • .NET Core 3.0之深入源碼理解Configuration(三)
    寫在前面 上一篇文章討論了文件型配置的基本內容，本篇內容討論JSON型配置的實現方式，理解了這一種配置類型的實現方式，那麼其他類型的配置實現方式基本可以觸類旁通。看過了上一篇文章的朋友，應該看得出來似曾相識。此圖主要表達了文件型配置的實現，當然其他配置，包括自定義配置，都會按照這樣的方式去實現。 J... ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類