自定義菜單能夠幫助公眾號豐富界面，讓用戶更好更快地理解公眾號的功能。開啟自定義菜單后，公眾號界面如圖所示：
目前自定義菜單最多包括3個一級菜單，每個一級菜單最多包含5個二級菜單。一級菜單最多4個漢字，二級菜單最多7個漢字，多出來的部分將會以“...”代替。請注意，創建自定義菜單后，由於微信客戶端緩存，需要24小時微信客戶端才會展現出來。建議測試時可以嘗試取消關注公眾賬號后再次關注，則可以看到創建后的效果。
目前自定義菜單接口可實現兩種類型按鈕，如下：
click： 用戶點擊click類型按鈕后，微信服務器會通過消息接口推送消息類型為event 的結構給開發者（參考消息接口指南），並且帶上按鈕中開發者填寫的key值，開發者可以通過自定義的key值與用戶進行交互； view： 用戶點擊view類型按鈕后，微信客戶端將會打開開發者在按鈕中填寫的url值 （即網頁鏈接），達到打開網頁的目的，建議與網頁授權獲取用戶基本信息接口結合，獲得用戶的登入個人信息。
接口調用請求說明
http請求方式：POST（請使用https協議） https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
請求示例
{
"button":[
{
"type":"click",
"name":"今日歌曲",
"key":"V1001_TODAY_MUSIC"
},
{
"type":"click",
"name":"歌手簡介",
"key":"V1001_TODAY_SINGER"
},
{
"name":"菜單",
"sub_button":[
{
"type":"view",
"name":"搜索",
"url":"http://www.soso.com/"
},
{
"type":"view",
"name":"視頻",
"url":"http://v.qq.com/"
},
{
"type":"click",
"name":"贊一下我們",
"key":"V1001_GOOD"
}]
}]
}
參數說明
| 參數 | 是否必須 | 說明 |
|---|---|---|
| button | 是 | 一級菜單數組，個數應為1~3個 |
| sub_button | 否 | 二級菜單數組，個數應為1~5個 |
| type | 是 | 菜單的響應動作類型，目前有click、view兩種類型 |
| name | 是 | 菜單標題，不超過16個字節，子菜單不超過40個字節 |
| key | click類型必須 | 菜單KEY值，用於消息接口推送，不超過128字節 |
| url | view類型必須 | 網頁鏈接，用戶點擊菜單可打開鏈接，不超過256字節 |
返回結果
正確時的返回JSON數據包如下：
{"errcode":0,"errmsg":"ok"}
錯誤時的返回JSON數據包如下（示例為無效菜單名長度）：
{"errcode":40018,"errmsg":"invalid button name size"}