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