為了幫助公眾號實(shí)現(xiàn)靈活的業(yè)務(wù)運(yùn)營，微信公眾平臺新增了個性化菜單接口，開發(fā)者可以通過該接口，讓公眾號的不同用戶群體看到不一樣的自定義菜單。該接口開放給已認(rèn)證訂閱號和已認(rèn)證服務(wù)號。

開發(fā)者可以通過以下條件來設(shè)置用戶看到的菜單：

1. 用戶標(biāo)簽（開發(fā)者的業(yè)務(wù)需求可以借助用戶標(biāo)簽來完成）
2. 性別
3. 手機(jī)操作系統(tǒng)
4. 地區(qū)（用戶在微信客戶端設(shè)置的地區(qū)）
5. 語言（用戶在微信客戶端設(shè)置的語言）

注意：為保護(hù)個人隱私，公眾號個性化菜單將不再支持對性別、地區(qū)、語言這類涉及個人隱私數(shù)據(jù)的信息進(jìn)行篩選的功能，具體調(diào)整如下：

1. 創(chuàng)建時，只要匹配條件中包含隱私信息的，將被拒絕，并返回錯誤碼 65320；
2. 已經(jīng)創(chuàng)建的，如包含隱私信息的則自動失效，不包含的則正常匹配；
3. 開發(fā)者仍然可以正常通過測試接口，獲取到粉絲看到的菜單；
4. 查詢個性化菜單時，所有規(guī)則正常顯示。

個性化菜單接口說明：

1. 個性化菜單要求用戶的微信客戶端版本在iPhone6.2.2，Android 6.2.4以上，暫時不支持其他版本微信
2. 菜單的刷新策略是，在用戶進(jìn)入公眾號會話頁或公眾號profile頁時，如果發(fā)現(xiàn)上一次拉取菜單的請求在5分鐘以前，就會拉取一下菜單，如果菜單有更新，就會刷新客戶端的菜單。測試時可以嘗試取消關(guān)注公眾賬號后再次關(guān)注，則可以看到創(chuàng)建后的效果
3. 普通公眾號的個性化菜單的新增接口每日限制次數(shù)為2000次，刪除接口也是2000次，測試個性化菜單匹配結(jié)果接口為20000次
4. 出于安全考慮，一個公眾號的所有個性化菜單，最多只能設(shè)置為跳轉(zhuǎn)到3個域名下的鏈接
5. 創(chuàng)建個性化菜單之前必須先創(chuàng)建默認(rèn)菜單（默認(rèn)菜單是指使用普通自定義菜單創(chuàng)建接口創(chuàng)建的菜單）。如果刪除默認(rèn)菜單，個性化菜單也會全部刪除
6. 個性化菜單接口支持用戶標(biāo)簽，請開發(fā)者注意，當(dāng)用戶身上的標(biāo)簽超過1個時，以最后打上的標(biāo)簽為匹配

個性化菜單匹配規(guī)則說明：

個性化菜單的更新是會被覆蓋的。 例如公眾號先后發(fā)布了默認(rèn)菜單，個性化菜單1，個性化菜單2，個性化菜單3。那么當(dāng)用戶進(jìn)入公眾號頁面時，將從個性化菜單3開始匹配，如果個性化菜單3匹配成功，則直接返回個性化菜單3，否則繼續(xù)嘗試匹配個性化菜單2，直到成功匹配到一個菜單。 根據(jù)上述匹配規(guī)則，為了避免菜單生效時間的混淆，決定不予提供個性化菜單編輯API，開發(fā)者需要更新菜單時，需將完整配置重新發(fā)布一輪。

目錄

1 創(chuàng)建個性化菜單

2 刪除個性化菜單

3 測試個性化菜單匹配結(jié)果

4 查詢個性化菜單

5 刪除所有菜單

創(chuàng)建個性化菜單

http請求方式：POST（請使用https協(xié)議）

https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN

請求示例

{
    "button": [
        {
            "type": "click", 
            "name": "今日歌曲", 
            "key": "V1001_TODAY_MUSIC"
        }, 
        {
            "name": "菜單", 
            "sub_button": [
                {
                    "type": "view", 
                    "name": "搜索", 
                    "url": "http://www.soso.com/"
                }, 
                {
                    "type": "miniprogram", 
                    "name": "wxa", 
                    "url": "http://mp.weixin.qq.com", 
                    "appid": "wx286b93c14bbf93aa", 
                    "pagepath": "pages/lunar/index"
                }, 
                {
                    "type": "click", 
                    "name": "贊一下我們", 
                    "key": "V1001_GOOD"
                }
            ]
        }
    ], 
    "matchrule": {
        "tag_id": "2", 
        "sex": "1", 
        "country": "中國", 
        "province": "廣東", 
        "city": "廣州", 
        "client_platform_type": "2", 
        "language": "zh_CN"
    }
}

參數(shù)說明

button中將不再支持圖文(news)類型永久素材的 media_id，請使用 article_id 代替 matchrule共七個字段，均可為空，但不能全部為空，至少要有一個匹配信息是不為空的。 country、province、city組成地區(qū)信息，將按照country、province、city的順序進(jìn)行驗證，要符合地區(qū)信息表的內(nèi)容。地區(qū)信息從大到小驗證，小的可以不填，即若填寫了省份信息，則國家信息也必填并且匹配，城市信息可以不填。 例如 “中國 廣東省 廣州市”、“中國 廣東省”都是合法的地域信息，而“中國 廣州市”則不合法，因為填寫了城市信息但沒有填寫省份信息。 地區(qū)信息表請 點(diǎn)擊下載。

返回結(jié)果

正確時的返回JSON數(shù)據(jù)包如下，錯誤時的返回碼請見接口返回碼說明。

{"menuid":"208379533"}

注意

請留意參數(shù)說明表中已廢止的字段，這些字段涉及公民個人隱私，如填寫這些字段，接口將返回以下結(jié)果：

{"errcode":65320,"errmsg":"match rule violates privacy"}

至于其他返回碼，請見接口返回碼說明。

刪除個性化菜單

http請求方式：POST（請使用https協(xié)議）

https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN

請求示例

{"menuid":"208379533"}

menuid為菜單id，可以通過自定義菜單查詢接口獲取。

正確時的返回JSON數(shù)據(jù)包如下，錯誤時的返回碼請見接口返回碼說明。：

{"errcode":0,"errmsg":"ok"}

測試個性化菜單匹配結(jié)果

http請求方式：POST（請使用https協(xié)議）

https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN

請求示例

{"user_id":"weixin"}

user_id可以是粉絲的OpenID，也可以是粉絲的微信號。

返回結(jié)果 該接口將返回菜單配置，示例如下：

{
    "button": [
        {
            "type": "view", 
            "name": "tx", 
            "url": "http://www.qq.com/", 
            "sub_button": [ ]
        }, 
        {
            "type": "view", 
            "name": "tx", 
            "url": "http://www.qq.com/", 
            "sub_button": [ ]
        }, 
        {
            "type": "view", 
            "name": "tx", 
            "url": "http://www.qq.com/", 
            "sub_button": [ ]
        }
    ]
}

注意 包含 已廢除字段 的菜單也將自動失效，不再被匹配。這一點(diǎn)也將體現(xiàn)在本測試接口中。

另外，錯誤時的返回碼請見接口返回碼說明。

查詢個性化菜單

使用普通自定義菜單查詢接口可以獲取默認(rèn)菜單和全部個性化菜單信息，請見自定義菜單查詢接口的說明。

注意 查詢時，包含 已廢除字段 的菜單雖然會照常返回，但不再有效。

刪除所有菜單

使用普通自定義菜單刪除接口可以刪除所有自定義菜單（包括默認(rèn)菜單和全部個性化菜單），請見自定義菜單刪除接口的說明。