微信企业号的菜单管理

前面几篇陆续介绍了很多微信企业号的相关操作，企业号和公众号一样都可以自定义菜单，因此他们也可以通过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#管理接口定义如下所示。

 
 
    
  
  
  1. ///   
    2. 
  
  
  2.     /// 企业号菜单管理接口定义  
    3. 
  
  
  3.     ///   
    4. 
  
  
  4.     public interface ICorpMenuApi  
    5. 
  
  
  5.     {  
    6. 
  
  
  6.         ///   
    7. 
  
  
  7.         /// 获取菜单数据  
    8. 
  
  
  8.         ///   
    9. 
  
  
  9.         /// 调用接口凭证  
    10. 
  
  
  10.         ///   
    11. 
  
  
  11.         MenuListJson GetMenu(string accessToken, string agentid);  
    12. 
  
  
  12.  
    13. 
  
  
  13.         ///   
    14. 
  
  
  14.         /// 创建菜单  
    15. 
  
  
  15.         ///   
    16. 
  
  
  16.         /// 调用接口凭证  
    17. 
  
  
  17.         /// 菜单对象  
    18. 
  
  
  18.         ///   
    19. 
  
  
  19.         CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid);  
    20. 
  
  
  20.  
    21. 
  
  
  21.         ///   
    22. 
  
  
  22.         /// 删除菜单  
    23. 
  
  
  23.         ///   
    24. 
  
  
  24.         /// 调用接口凭证  
    25. 
  
  
  25.         ///   
    26. 
  
  
  26.         CommonResult DeleteMenu(string accessToken, string agentid);  
    27. 
  
  
  27.     } 
    28.

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

 
 
    
  
  
  1. ///   
    2. 
  
  
  2.         /// 创建菜单  
    3. 
  
  
  3.         ///   
    4. 
  
  
  4.         /// 调用接口凭证  
    5. 
  
  
  5.         /// 菜单对象  
    6. 
  
  
  6.         ///   
    7. 
  
  
  7.         public CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid)  
    8. 
  
  
  8.         {  
    9. 
  
  
  9.             var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token={0}&agentid={1}", accessToken, agentid);  
    10. 
  
  
  10.             string postData = menuJson.ToJson();  
    11. 
  
  
  11.  
    12. 
  
  
  12.             return Helper.GetCorpExecuteResult(url, postData);  
    13. 
  
  
  13.         } 
    14.

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

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

 
 
    
  
  
  1. private void btnMenuCreate_Click(object sender, EventArgs e)  
    2. 
  
  
  2.         {  
    3. 
  
  
  3.             MenuJson productInfo = new MenuJson("产品介绍", new MenuJson[] {   
    4. 
  
  
  4.                 new MenuJson("软件产品介绍", ButtonType.click, "event-software")  
    5. 
  
  
  5.                 , new MenuJson("框架源码产品", ButtonType.click, "event-source")  
    6. 
  
  
  6.                 , new MenuJson("软件定制开发", ButtonType.click, "event-develop")  
    7. 
  
  
  7.             });  
    8. 
  
  
  8.  
    9. 
  
  
  9.             MenuJson frameworkInfo = new MenuJson("框架产品", new MenuJson[] {   
    10. 
  
  
  10.                 new MenuJson("Win开发框架", ButtonType.click, "win"),  
    11. 
  
  
  11.                 new MenuJson("WCF开发框架", ButtonType.click, "wcf"),  
    12. 
  
  
  12.                 new MenuJson("混合式框架", ButtonType.click, "mix"),   
    13. 
  
  
  13.                 new MenuJson("Web开发框架", ButtonType.click, "web")  
    14. 
  
  
  14.                 ,new MenuJson("代码生成工具", ButtonType.click, "database2sharp")  
    15. 
  
  
  15.             });  
    16. 
  
  
  16.  
    17. 
  
  
  17.             MenuJson relatedInfo = new MenuJson("相关链接", new MenuJson[] {   
    18. 
  
  
  18.                 new MenuJson("公司介绍", ButtonType.click, "event_company"),  
    19. 
  
  
  19.                 new MenuJson("官方网站", ButtonType.view, "http://www.iqidi.com"),  
    20. 
  
  
  20.                 new MenuJson("联系我们", ButtonType.click, "event_contact"),  
    21. 
  
  
  21.                 new MenuJson("应答系统", ButtonType.click, "set-1"),      
    22. 
  
  
  22.                 new MenuJson("发邮件", ButtonType.view, "http://mail.qq.com/cgi-bin/qm_share?t=qm_mailme&email=S31yfX15fn8LOjplKCQm")  
    23. 
  
  
  23.             });  
    24. 
  
  
  24.  
    25. 
  
  
  25.             MenuListJson menuJson = new MenuListJson();  
    26. 
  
  
  26.             menuJson.button.AddRange(new MenuJson[] { productInfo, frameworkInfo, relatedInfo });  
    27. 
  
  
  27.  
    28. 
  
  
  28.             //Console.WriteLine(menuJson.ToJson());  
    29. 
  
  
  29.  
    30. 
  
  
  30.             if (MessageUtil.ShowYesNoAndWarning("您确认要创建菜单吗") == System.Windows.Forms.DialogResult.Yes)  
    31. 
  
  
  31.             {  
    32. 
  
  
  32.                 ICorpMenuApi bll = new CorpMenuApi();   
    33. 
  
  
  33.                 CommonResult result = bll.CreateMenu(token, menuJson, agentid);  
    34. 
  
  
  34.                 Console.WriteLine("创建菜单：" + (result.Success ? "成功" : "失败:" + result.ErrorMessage));  
    35. 
  
  
  35.             }  
    36. 
  
  
  36.         }  
    37. 
  
  
  37.  
    38. 
  
  
  38.         private void btnMenuGet_Click(object sender, EventArgs e)  
    39. 
  
  
  39.         {  
    40. 
  
  
  40.             ICorpMenuApi bll = new CorpMenuApi();  
    41. 
  
  
  41.             MenuListJson menu = bll.GetMenu(token, agentid);  
    42. 
  
  
  42.             if (menu != null)  
    43. 
  
  
  43.             {  
    44. 
  
  
  44.                 Console.WriteLine(menu.ToJson());  
    45. 
  
  
  45.             }  
    46. 
  
  
  46.         } 
    47.

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

原文出自：http://www.cnblogs.com/wuhuacong/p/3995678.html

文章名称：微信企业号的菜单管理
路径分享：http://www.shufengxianlan.com/qtweb/news10/44460.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

搜索引擎优化知识

分类信息网站

云主机　　 　重庆网站建设　　 　h5页面制作　　 　达州网站制作　　 　温江网站制作　　 　自贡网站建设　　 　南充做网站　　 　网站定制　　 　云主机　　 　成都展柜定制　　 　联通机房服务器托管　　 　成都做网站　　 　亮美家　　 　微信网站开发　　 　网站建设方案　　 　成都网站建设　　 　手机网站建设公司　　 　网站定制　　 　简阳机房托管　　 　香港虚拟主机腾讯云