微信公眾平臺 個(gè)性化菜單接口

個(gè)性化菜單接口

為了幫助公眾號實(shí)現(xiàn)靈活的業(yè)務(wù)運(yùn)營，微信公眾平臺新增了個(gè)性化菜單接口，開發(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è)置的語言）

個(gè)性化菜單接口說明：

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

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

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

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

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":"view",
			"name":"視頻",
			"url":"http://v.qq.com/"
		},
		{
			"type":"click",
			"name":"贊一下我們",
			"key":"V1001_GOOD"
		}]
 }],
"matchrule":{
  "tag_id":"2",
  "sex":"1",
  "country":"中國",
  "province":"廣東",
  "city":"廣州",
  "client_platform_type":"2",
  "language":"zh_CN"
  }
}

參數(shù)說明

matchrule共六個(gè)字段，均可為空，但不能全部為空，至少要有一個(gè)匹配信息是不為空的。 country、province、city組成地區(qū)信息，將按照country、province、city的順序進(jìn)行驗(yàn)證，要符合地區(qū)信息表的內(nèi)容。地區(qū)信息從大到小驗(yàn)證，小的可以不填，即若填寫了省份信息，則國家信息也必填并且匹配，城市信息可以不填。 例如 “中國 廣東省 廣州市”、“中國 廣東省”都是合法的地域信息，而“中國 廣州市”則不合法，因?yàn)樘顚懥顺鞘行畔⒌珱]有填寫省份信息。 地區(qū)信息表請點(diǎn)擊下載。

返回結(jié)果

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

{
	"menuid":"208379533"
}

刪除個(gè)性化菜單

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

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

請求示例

{
	"menuid":"208379533"
}

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

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

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

測試個(gè)性化菜單匹配結(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": [ ]
        }
    ]
}

錯(cuò)誤時(shí)的返回碼請見接口返回碼說明。

查詢個(gè)性化菜單

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

刪除所有菜單

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