微信企业号开发之如何使用自定义菜单

移动开发 移动应用
企业号的每个应用都可以拥有自己的菜单,企业可以调用接口来创建、删除、获取应用菜单。在操作应用的菜单时,应用必须处于回调模式;菜单最多为两级,一级菜单最多为3个,二级菜单最多为5个。

企业号的每个应用都可以拥有自己的菜单,企业可以调用接口来创建、删除、获取应用菜单。

注意,在操作应用的菜单时,应用必须处于回调模式;菜单最多为两级,一级菜单最多为3个,二级菜单最多为5个

一、创建应用菜单

  • 请求说明

Https请求方式: POST

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

请求包如下:

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

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

返回结果

  1.    "errcode":0
  2.    "errmsg":"ok" 
  3. }

二、删除菜单

  • 请求说明

Https请求方式:GET

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

  • 参数说明
参数 必须 说明
access_token 调用接口凭证
agentid 企业应用的id,整型。可在应用的设置页面查看
  • 权限说明

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

  • 返回结果
  1.    "errcode":0
  2.    "errmsg":"ok" 
  3. }

三、获取菜单列表

  • 请求说明

Https请求方式:GET

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

  • 参数说明
参数 必须 说明
access_token 调用接口凭证
agentid 企业应用的id,整型。可在应用的设置页面查看
  • 权限说明

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

  • 返回结果

返回结果与菜单创建的参数一致。

责任编辑:闫佳明 来源: 51CTO
相关推荐

2013-11-13 00:51:22

微信微信公号微信公众账号

2014-09-24 09:59:23

微信企业号开发

2014-09-24 11:32:21

微信企业号开发

2014-09-24 11:11:08

微信企业号开发

2014-09-28 22:38:21

微信企业号

2013-04-10 18:40:59

微信公众平台接口开发

2014-09-24 10:29:14

微信企业号开发

2021-03-04 00:06:16

微信开发自定义

2015-02-12 15:33:43

微信SDK

2015-02-12 15:38:26

微信SDK

2014-09-24 11:04:31

微信企业号开发

2013-03-28 11:32:07

微信菜单轻App

2013-03-25 17:26:09

2014-09-24 13:11:34

信企业号

2014-09-24 11:47:41

微信企业号开发

2014-09-25 15:48:51

微信企业号申请认证

2014-09-28 22:22:25

微信企业号

2021-11-04 09:55:50

鸿蒙HarmonyOS应用

2014-09-28 22:26:11

微信企业号

2014-09-24 11:52:37

微信企业号开发
点赞
收藏

51CTO技术栈公众号