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

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

站長「蝙蝠俠」:QQ1251270088  瀏覽:2727次 時間:2015-12-17

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

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


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

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

1、個性化菜單要求用戶的微信客戶端版本在iPhone6.2.2,Android 6.2.4以上。
2、菜單的刷新策略是,在用戶進入公眾號會話頁或公眾號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)建默認菜單(默認菜單是指使用普通自定義菜單創(chuàng)建接口創(chuàng)建的菜單)。如果刪除默認菜單,個性化菜單也會全部刪除
個性化菜單匹配規(guī)則說明:

當公眾號創(chuàng)建多個個性化菜單時,將按照發(fā)布順序,由新到舊逐一匹配,直到用戶信息與matchrule相符合。如果全部個性化菜單都沒有匹配成功,則返回默認菜單。
例如公眾號先后發(fā)布了默認菜單,個性化菜單1,個性化菜單2,個性化菜單3。那么當用戶進入公眾號頁面時,將從個性化菜單3開始匹配,如果個性化菜單3匹配成功,則直接返回個性化菜單3,否則繼續(xù)嘗試匹配個性化菜單2,直到成功匹配到一個菜單。
目錄
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":"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ù)組,個數(shù)應(yīng)為1~3個
sub_button 否 二級菜單數(shù)組,個數(shù)應(yīng)為1~5個
type 是 菜單的響應(yīng)動作類型
name 是 菜單標題,不超過16個字節(jié),子菜單不超過40個字節(jié)
key click等點擊類型必須 菜單KEY值,用于消息接口推送,不超過128字節(jié)
url view類型必須 網(wǎng)頁鏈接,用戶點擊菜單可打開鏈接,不超過256字節(jié)
media_id media_id類型和view_limited類型必須 調(diào)用新增永久素材接口返回的合法media_id
matchrule 是 菜單匹配規(guī)則
group_id 否 用戶分組id,可通過用戶分組管理接口獲取
sex 否 性別:男(1)女(2),不填則不做匹配
client_platform_type 否 客戶端版本,當前只具體到系統(tǒng)型號:IOS(1), Android(2),Others(3),不填則不做匹配
country 否 國家信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
province 否 省份信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
city 否 城市信息,是用戶在微信中設(shè)置的地區(qū),具體請參考地區(qū)信息表
matchrule共六個字段,均可為空,但不能全部為空,至少要有一個匹配信息是不為空的。 country、province、city組成地區(qū)信息,將按照country、province、city的順序進行驗證,要符合地區(qū)信息表的內(nèi)容。地區(qū)信息從大到小驗證,小的可以不填,即若填寫了省份信息,則國家信息也必填并且匹配,城市信息可以不填。 例如 “中國 廣東省 廣州市”、“中國 廣東省”都是合法的地域信息,而“中國 廣州市”則不合法,因為填寫了城市信息但沒有填寫省份信息。 地區(qū)信息表請點擊下載。

返回結(jié)果

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

{"errcode":0,"errmsg":"ok"}
刪除個性化菜單


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": [ ]
        }
    ]
}
錯誤時的返回碼請見接口返回碼說明。

查詢個性化菜單

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

刪除個性化菜單

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


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

最新收錄 最新審核通過的網(wǎng)站

?