微信企業(yè)號開發(fā)之如何使用自定義菜單
作者：51CTO整理
企業(yè)號的每個應(yīng)用都可以擁有自己的菜單，企業(yè)可以調(diào)用接口來創(chuàng)建、刪除、獲取應(yīng)用菜單。在操作應(yīng)用的菜單時，應(yīng)用必須處于回調(diào)模式；菜單最多為兩級，一級菜單最多為3個，二級菜單最多為5個。
企業(yè)號的每個應(yīng)用都可以擁有自己的菜單，企業(yè)可以調(diào)用接口來創(chuàng)建、刪除、獲取應(yīng)用菜單。
注意，在操作應(yīng)用的菜單時，應(yīng)用必須處于回調(diào)模式；菜單最多為兩級，一級菜單最多為3個，二級菜單最多為5個。
一、創(chuàng)建應(yīng)用菜單
- 請求說明
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"
- }
- ]
- }
- ]
- }
- 參數(shù)說明
| 參數(shù) | 必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| agentid | 是 | 企業(yè)應(yīng)用的id，整型?？稍趹?yīng)用的設(shè)置頁面查看 |
| button | 是 | 一級菜單數(shù)組，個數(shù)應(yīng)為1~3個 |
| sub_button | 否 | 二級菜單數(shù)組，個數(shù)應(yīng)為1~5個 |
| type | 是 | 菜單的響應(yīng)動作類型，目前有click、view兩種類型 |
| name | 是 | 菜單標(biāo)題，不超過16個字節(jié)，子菜單不超過40個字節(jié) |
| key | click類型必須 | 菜單KEY值，用于消息接口推送，不超過128字節(jié) |
| url | view類型必須 | 網(wǎng)頁鏈接，員工點(diǎn)擊菜單可打開鏈接，不超過256字節(jié) |
- 權(quán)限說明
管理員須擁有應(yīng)用的管理權(quán)限，并且應(yīng)用必須設(shè)置在回調(diào)模式。
返回結(jié)果
- {
- "errcode":0,
- "errmsg":"ok"
- }
二、刪除菜單
- 請求說明
Https請求方式：GET
https://qyapi.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN&agentid=1
- 參數(shù)說明
| 參數(shù) | 必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| agentid | 是 | 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看 |
- 權(quán)限說明
管理員須擁有應(yīng)用的管理權(quán)限，并且應(yīng)用必須設(shè)置在回調(diào)模式。
- 返回結(jié)果
- {
- "errcode":0,
- "errmsg":"ok"
- }
三、獲取菜單列表
- 請求說明
Https請求方式：GET
https://qyapi.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN&agentid=1
- 參數(shù)說明
| 參數(shù) | 必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| agentid | 是 | 企業(yè)應(yīng)用的id，整型。可在應(yīng)用的設(shè)置頁面查看 |
- 權(quán)限說明
管理員須擁有應(yīng)用的管理權(quán)限，并且應(yīng)用必須設(shè)置在回調(diào)模式。
- 返回結(jié)果
返回結(jié)果與菜單創(chuàng)建的參數(shù)一致。
責(zé)任編輯：閆佳明
來源：
51CTO
