首页 > 代码库 > C#开发微信门户及应用(20)-微信企业号的菜单管理

C#开发微信门户及应用(20)-微信企业号的菜单管理

2024-07-24 17:21:51   223人阅读

前面几篇陆续介绍了很多微信企业号的相关操作，企业号和公众号一样都可以自定义菜单，因此他们也可以通过API进行菜单的创建、获取列表、删除的操作，因此本篇继续探讨这个主体，介绍企业号的菜单管理操作。

菜单在很多情况下，能够给我们提供一个快速入口，也可以用来获取用户信息的主要入口，通过OAuth2验证接口，以及自定义的重定向菜单，我们就可以获取对应的用户ID，然后进一步获取到用户的相关数据，可以显示给客户。

1、菜单的总体介绍

菜单的事件处理如下所示，包括了单击和跳转两个操作，未来企业号可能会增加一些和公众号一样的扫码操作，拍照操作等功能的，目前只有两个。

官方的菜单定义接口包含了下面三种操作，菜单创建、列表获取和菜单删除，这点和公众号操作几乎一样了。

 

2、菜单的实体类定义和接口定义处理

我们定义菜单，包括定义它的一些属性，包含有name, type, key,url,以及一个指向自身引用的子菜单引用，因此菜单就可以循环构造多个层次，虽然严格意义上来讲，企业号的菜单和公众号菜单一样，一级三个，二级最多五个，而且没有三级菜单了。

实体类的UML图示如下所示。

菜单管理的创建操作，官方定义如下所示。

  • 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=1

请求包如下：

{   "button":[       {	           "type":"click",           "name":"今日歌曲",           "key":"V1001_TODAY_MUSIC"       },       {           "name":"菜单",           "sub_button":[               {                   "type":"view",                   "name":"搜索",                   "url":"http://www.soso.com/"               },               {                   "type":"click",                   "name":"赞一下我们",                   "key":"V1001_GOOD"               }           ]      }   ]}
  • 参数说明
参数必须说明
access_token是调用接口凭证
agentid是企业应用的id，整型。可在应用的设置页面查看
button是一级菜单数组，个数应为1~3个
sub_button否二级菜单数组，个数应为1~5个
type是菜单的响应动作类型，目前有click、view两种类型
name是菜单标题，不超过16个字节，子菜单不超过40个字节
keyclick类型必须菜单KEY值，用于消息接口推送，不超过128字节
urlview类型必须网页链接，员工点击菜单可打开链接，不超过256字节
  • 权限说明

管理员须拥有应用的管理权限，并且应用必须设置在回调模式。

返回结果

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

 

根据上面官方的定义语义，我们菜单管理的C#管理接口定义如下所示。

    /// <summary>    /// 企业号菜单管理接口定义    /// </summary>    public interface ICorpMenuApi    {        /// <summary>        /// 获取菜单数据        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <returns></returns>        MenuListJson GetMenu(string accessToken, string agentid);        /// <summary>        /// 创建菜单        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="menuJson">菜单对象</param>        /// <returns></returns>        CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid);        /// <summary>        /// 删除菜单        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <returns></returns>        CommonResult DeleteMenu(string accessToken, string agentid);    }

我们以创建菜单的实现为例来介绍微信企业号菜单的操作，其他的操作类似处理，都是返回一个公共的消息类，方便处理和读取，代码如下所示。

        /// <summary>        /// 创建菜单        /// </summary>        /// <param name="accessToken">调用接口凭证</param>        /// <param name="menuJson">菜单对象</param>        /// <returns></returns>        public CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid)        {            var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token={0}&agentid={1}", accessToken, agentid);            string postData =http://www.mamicode.com/ menuJson.ToJson();            return Helper.GetCorpExecuteResult(url, postData);        }

 

3、企业号菜单管理接口的调用和处理效果

调用的代码和效果图如下所示。

        private void btnMenuCreate_Click(object sender, EventArgs e)        {            MenuJson productInfo = new MenuJson("产品介绍", new MenuJson[] {                 new MenuJson("软件产品介绍", ButtonType.click, "event-software")                , new MenuJson("框架源码产品", ButtonType.click, "event-source")                , new MenuJson("软件定制开发", ButtonType.click, "event-develop")            });            MenuJson frameworkInfo = new MenuJson("框架产品", new MenuJson[] {                 new MenuJson("Win开发框架", ButtonType.click, "win"),                new MenuJson("WCF开发框架", ButtonType.click, "wcf"),                new MenuJson("混合式框架", ButtonType.click, "mix"),                 new MenuJson("Web开发框架", ButtonType.click, "web")                ,new MenuJson("代码生成工具", ButtonType.click, "database2sharp")            });            MenuJson relatedInfo = new MenuJson("相关链接", new MenuJson[] {                 new MenuJson("公司介绍", ButtonType.click, "event_company"),                new MenuJson("官方网站", ButtonType.view, "http://www.iqidi.com"),                new MenuJson("联系我们", ButtonType.click, "event_contact"),                new MenuJson("应答系统", ButtonType.click, "set-1"),                    new MenuJson("发邮件", ButtonType.view, "http://mail.qq.com/cgi-bin/qm_share?t=qm_mailme&email=S31yfX15fn8LOjplKCQm")            });            MenuListJson menuJson = new MenuListJson();            menuJson.button.AddRange(new MenuJson[] { productInfo, frameworkInfo, relatedInfo });            //Console.WriteLine(menuJson.ToJson());            if (MessageUtil.ShowYesNoAndWarning("您确认要创建菜单吗") == System.Windows.Forms.DialogResult.Yes)            {                ICorpMenuApi bll = new CorpMenuApi();                 CommonResult result = bll.CreateMenu(token, menuJson, agentid);                Console.WriteLine("创建菜单：" + (result.Success ? "成功" : "失败:" + result.ErrorMessage));            }        }        private void btnMenuGet_Click(object sender, EventArgs e)        {            ICorpMenuApi bll = new CorpMenuApi();            MenuListJson menu = bll.GetMenu(token, agentid);            if (menu != null)            {                Console.WriteLine(menu.ToJson());            }        }

调用代码的测试输出如下所示。

 

如果对这个《C#开发微信门户及应用》系列感兴趣，可以关注我的其他文章，系列随笔如下所示：

C#开发微信门户及应用(19)-微信企业号的消息发送（文本、图片、文件、语音、视频、图文消息等）

C#开发微信门户及应用(18)-微信企业号的通讯录管理开发之成员管理

C#开发微信门户及应用(17)-微信企业号的通讯录管理开发之部门管理

C#开发微信门户及应用(16)-微信企业号的配置和使用

C#开发微信门户及应用(15)-微信菜单增加扫一扫、发图片、发地理位置功能

 C#开发微信门户及应用(14)-在微信菜单中采用重定向获取用户数据

C#开发微信门户及应用(13)-使用地理位置扩展相关应用

C#开发微信门户及应用(12)-使用语音处理

C#开发微信门户及应用(11)--微信菜单的多种表现方式介绍

C#开发微信门户及应用(10)--在管理系统中同步微信用户分组信息

C#开发微信门户及应用(9)-微信门户菜单管理及提交到微信服务器

C#开发微信门户及应用(8)-微信门户应用管理系统功能介绍

C#开发微信门户及应用(7)-微信多客服功能及开发集成

C#开发微信门户及应用(6)--微信门户菜单的管理操作

C#开发微信门户及应用(5)--用户分组信息管理

C#开发微信门户及应用(4)--关注用户列表及详细信息管理

C#开发微信门户及应用(3)--文本消息和图文消息的应答

C#开发微信门户及应用(2)--微信消息的处理和应答

C#开发微信门户及应用(1)--开始使用微信接口

 

C#开发微信门户及应用(20)-微信企业号的菜单管理


联系
我们