您好,歡迎來到58網(wǎng)站目錄!
當(dāng)前位置:58網(wǎng)站目錄 » 站長資訊 » 微信 » 微信公眾號 » 文章詳細(xì)

微信公眾平臺面向開發(fā)者新增個(gè)性化菜單接口

站長「蝙蝠俠」:QQ1251270088  瀏覽:2750次 時(shí)間:2015-12-17

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

微信公眾平臺面向開發(fā)者新增個(gè)性化菜單接口


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

1、用戶分組(開發(fā)者的業(yè)務(wù)需求可以借助用戶分組來完成)
2、性別
3、手機(jī)操作系統(tǒng)
4、地區(qū)
個(gè)性化菜單接口說明:

1、個(gè)性化菜單要求用戶的微信客戶端版本在iPhone6.2.2,Android 6.2.4以上。
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ì)全部刪除
個(gè)性化菜單匹配規(guī)則說明:

當(dāng)公眾號創(chuàng)建多個(gè)個(gè)性化菜單時(shí),將按照發(fā)布順序,由新到舊逐一匹配,直到用戶信息與matchrule相符合。如果全部個(gè)性化菜單都沒有匹配成功,則返回默認(rèn)菜單。
例如公眾號先后發(fā)布了默認(rèn)菜單,個(gè)性化菜單1,個(gè)性化菜單2,個(gè)性化菜單3。那么當(dāng)用戶進(jìn)入公眾號頁面時(shí),將從個(gè)性化菜單3開始匹配,如果個(gè)性化菜單3匹配成功,則直接返回個(gè)性化菜單3,否則繼續(xù)嘗試匹配個(gè)性化菜單2,直到成功匹配到一個(gè)菜單。
目錄
1 創(chuàng)建個(gè)性化菜單
2 刪除個(gè)性化菜單
3 測試個(gè)性化菜單匹配結(jié)果
4 查詢個(gè)性化菜單
5 刪除個(gè)性化菜單
創(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":{
  "group_id":"2",
  "sex":"1",
  "country":"中國",
  "province":"廣東",
  "city":"廣州",
  "client_platform_type":"2"
  }
}
參數(shù)說明

參數(shù) 是否必須 說明
button 是 一級菜單數(shù)組,個(gè)數(shù)應(yīng)為1~3個(gè)
sub_button 否 二級菜單數(shù)組,個(gè)數(shù)應(yīng)為1~5個(gè)
type 是 菜單的響應(yīng)動(dòng)作類型
name 是 菜單標(biāo)題,不超過16個(gè)字節(jié),子菜單不超過40個(gè)字節(jié)
key click等點(diǎn)擊類型必須 菜單KEY值,用于消息接口推送,不超過128字節(jié)
url view類型必須 網(wǎng)頁鏈接,用戶點(diǎn)擊菜單可打開鏈接,不超過256字節(jié)
media_id media_id類型和view_limited類型必須 調(diào)用新增永久素材接口返回的合法media_id
matchrule 是 菜單匹配規(guī)則
group_id 否 用戶分組id,可通過用戶分組管理接口獲取
sex 否 性別:男(1)女(2),不填則不做匹配
client_platform_type 否 客戶端版本,當(dāng)前只具體到系統(tǒng)型號:IOS(1), Android(2),Others(3),不填則不做匹配
country 否 國家信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
province 否 省份信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
city 否 城市信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
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í)的返回碼請見接口返回碼說明。

{"errcode":0,"errmsg":"ok"}
刪除個(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è)性化菜單信息,請見自定義菜單查詢接口的說明。

刪除個(gè)性化菜單

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


本文地址:http://quema.com.cn/artinfo/2416.html
?