微信公眾平台新增獲取自動回復和自定義菜單配置接口


  微信公眾平台自動回復功能可以為運營者減少了重復回復消息的次數,但如果自動回復的數量多的話管理就比較麻煩;自定義菜單相當於你這個公眾號的導航,但有些公眾號會限制不能添加外部鏈接。現在好了,公眾平台開發者接口更新,新增獲取自動回復和自定義菜單配置接口,對所有公眾號開放。

  

新增的接口具體是:

1. 獲取自動回復規則接口

該接口可以獲取公眾號設置的自動回復規則,包括關注后自動回復、消息自動回復和關鍵詞自動回復。

開發者可以通過該接口,獲取公眾號當前使用的自動回復規則,包括關注后自動回復、消息自動回復(60分鍾內觸發一次)、關鍵詞自動回復。

請注意:

1、第三方平台開發者可以通過本接口,在旗下公眾號將業務授權給你后,立即通過本接口檢測公眾號的自動回復配置,並通過接口再次給公眾號設置好自動回復規則,以提升公眾號運營者的業務體驗。
2、本接口僅能獲取公眾號在公眾平台官網的自動回復功能中設置的自動回復規則,若公眾號自行開發實現自動回復,或通過第三方平台開發者來實現,則無法獲取。
3、認證/未認證的服務號/訂閱號,以及接口測試號,均擁有該接口權限。
4、從第三方平台的公眾號登錄授權機制上來說,該接口從屬於消息與菜單權限集。
5、本接口中返回的mediaID均為臨時素材(通過素材管理-獲取臨時素材接口來獲取這些素材),每次接口調用返回的mediaID都是臨時的、不同的,在每次接口調用后3天有效,若需永久使用該素材,需使用素材管理接口中的永久素材。

接口調用請求說明

http請求方式: GET(請使用https協議)
https://api.weixin.qq.com/cgi-bin/get_current_autoreply_info?access_token=ACCESS_TOKEN

返回結果說明

返回的JSON格式樣例:(注意,格式化前的json使用‘\’作為轉義符)

{ 
   "is_add_friend_reply_open": 1, 
   "is_autoreply_open": 1, 
   "add_friend_autoreply_info": { 
       "type": "text", 
       "content": "Thanks for your attention!"
   }, 
   "message_default_autoreply_info": { 
       "type": "text", 
       "content": "Hello, this is autoreply!"
   }, 
   "keyword_autoreply_info": { 
       "list": [ 
           { 
               "rule_name": "autoreply-news", 
               "create_time": 1423028166, 
               "reply_mode": "reply_all", 
               "keyword_list_info": [ 
                   { 
                       "type": "text", 
                       "match_mode": "contain", 
                       "content": "news測試"//此處content即為關鍵詞內容
                   }
               ], 
               "reply_list_info": [ 
                   { 
                       "type": "news", 
                       "news_info": { 
                           "list": [ 
                               { 
                                   "title": "it's news", 
                                   "author": "jim", 
                                   "digest": "it's digest", 
                                   "show_cover": 1, 
                                   "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfKbE8sWdt2DDcL0dMfQWJWTVn1N8DxI0gcRmrtqBOuwQHeuPKmFLK0ZQ/0", 
                                   "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=203929886&idx=1&sn=628f964cf0c6d84c026881b6959aea8b#rd", 
                                   "source_url": "http://www.url.com"
                               }
                           ]
                       }
                   }, 
                   { 
                       "type": "news", 
                       "news_info": { 
                           "list": [ 
                               { 
                                   "title": "MULTI_NEWS", 
                                   "author": "JIMZHENG", 
                                   "digest": "text", 
                                   "show_cover": 0, 
                                   "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfK0HKuBIa1A1cypS0uY1wickv70iaY1gf3I1DTszuJoS3lAVLvhTcm9sDA/0", 
                                   "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=1&sn=80ce6d9abcb832237bf86c87e50fda15#rd", 
                                   "source_url": ""
                               },
                               { 
                                   "title": "MULTI_NEWS4", 
                                   "author": "JIMZHENG", 
                                   "digest": "MULTI_NEWSMULTI_NEWSMULTI_NEWSMULTI_NEWSMULTI_NEWSMULT", 
                                   "show_cover": 1, 
                                   "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfKbE8sWdt2DDcL0dMfQWJWTVn1N8DxI0gcRmrtqBOuwQHeuPKmFLK0ZQ/0", 
                                   "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=5&sn=b4ef73a915e7c2265e437096582774af#rd", 
                                   "source_url": ""
                               }
                           ]
                       }
                   }
               ]
           }, 
           { 
               "rule_name": "autoreply-voice", 
               "create_time": 1423027971, 
               "reply_mode": "random_one", 
               "keyword_list_info": [ 
                   { 
                       "type": "text", 
                       "match_mode": "contain", 
                       "content": "voice測試"
                   }
               ], 
               "reply_list_info": [ 
                   { 
                       "type": "voice", 
                       "content": "NESsxgHEvAcg3egJTtYj4uG1PTL6iPhratdWKDLAXYErhN6oEEfMdVyblWtBY5vp"
                   }
               ]
           }, 
           { 
               "rule_name": "autoreply-text", 
               "create_time": 1423027926, 
               "reply_mode": "random_one", 
               "keyword_list_info": [ 
                   { 
                       "type": "text", 
                       "match_mode": "contain", 
                       "content": "text測試"
                   }
               ], 
               "reply_list_info": [ 
                   { 
                       "type": "text", 
                       "content": "hello!text!"
                   }
               ]
           }, 
           { 
               "rule_name": "autoreply-video", 
               "create_time": 1423027801, 
               "reply_mode": "random_one", 
               "keyword_list_info": [ 
                   { 
                       "type": "text", 
                       "match_mode": "equal", 
                       "content": "video測試"
                   }
               ], 
               "reply_list_info": [ 
                   { 
                       "type": "video", 
                       "content": "http://61.182.133.153/vweixinp.tc.qq.com/1007_114bcede9a2244eeb5ab7f76d951df5f.f10.mp4?vkey=7183E5C952B16C3AB1991BA8138673DE1037CB82A29801A504B64A77F691BF9DF7AD054A9B7FE683&sha=0&save=1"
                   }
               ]
           }
       ]
   }
}

參數說明

參數 說明
is_add_friend_reply_open 關注后自動回復是否開啟,0代表未開啟,1代表開啟
is_autoreply_open 消息自動回復是否開啟,0代表未開啟,1代表開啟
add_friend_autoreply_info 關注后自動回復的信息
type 自動回復的類型。關注后自動回復和消息自動回復的類型僅支持文本(text)、圖片(img)、語音(voice)、視頻(video),關鍵詞自動回復則還多了圖文消息
content 對於文本類型,content是文本內容,對於圖片、語音、視頻類型,content是mediaID
message_default_autoreply_info 消息自動回復的信息
keyword_autoreply_info 關鍵詞自動回復的信息
rule_name 規則名稱
create_time 創建時間
reply_mode 回復模式,reply_all代表全部回復,random_one代表隨機回復其中一條
keyword_list_info 匹配的關鍵詞列表
match_mode 匹配模式,contain代表消息中含有該關鍵詞即可,equal表示消息內容必須和關鍵詞嚴格相同
news_info 圖文消息的信息
title 圖文消息的標題
digest 摘要
author 作者
show_cover 是否顯示封面,0為不顯示,1為顯示
cover_url 封面圖片的URL
content_url 正文的URL
source_url 原文的URL,若置空則無查看原文入口

2. 獲取自定義菜單配置接口

該接口可以獲取公眾號的自定義菜單配置。如果公眾號是在公眾平台官網上發布的菜單,則本接口返回官網上的菜單配置;而如果公眾號是通過API調用設置的菜單,則返回菜單的開發配置。

 

本接口將會提供公眾號當前使用的自定義菜單的配置,如果公眾號是通過API調用設置的菜單,則返回菜單的開發配置,而如果公眾號是在公眾平台官網通過網站功能發布菜單,則本接口返回運營者設置的菜單配置。

請注意:

1、第三方平台開發者可以通過本接口,在旗下公眾號將業務授權給你后,立即通過本接口檢測公眾號的自定義菜單配置,並通過接口再次給公眾號設置好自動回復規則,以提升公眾號運營者的業務體驗。
2、本接口與自定義菜單查詢接口的不同之處在於,本接口無論公眾號的接口是如何設置的,都能查詢到接口,而自定義菜單查詢接口則僅能查詢到使用API設置的菜單配置。
3、認證/未認證的服務號/訂閱號,以及接口測試號,均擁有該接口權限。
4、從第三方平台的公眾號登錄授權機制上來說,該接口從屬於消息與菜單權限集。
5、本接口中返回的mediaID均為臨時素材(通過素材管理-獲取臨時素材接口來獲取這些素材),每次接口調用返回的mediaID都是臨時的、不同的,在每次接口調用后3天有效,若需永久使用該素材,需使用素材管理接口中的永久素材。

接口調用請求說明

http請求方式: GET(請使用https協議)
https://api.weixin.qq.com/cgi-bin/get_current_selfmenu_info?access_token=ACCESS_TOKEN

返回結果說明

如果公眾號是在公眾平台官網通過網站功能發布菜單,則本接口返回的自定義菜單配置樣例如下:

{ 
   "is_menu_open": 1, 
   "selfmenu_info": { 
       "button": [ 
           { 
               "name": "button", 
               "sub_button": { 
                   "list": [ 
                       { 
                           "type": "view", 
                           "name": "view_url", 
                           "url": "http://www.qq.com"
                       }, 
                       { 
                           "type": "news", 
                           "name": "news", 
                           "news_info": { 
                               "list": [ 
                                   { 
                                       "title": "MULTI_NEWS", 
                                       "author": "JIMZHENG", 
                                       "digest": "text", 
                                       "show_cover": 0, 
                                       "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfK0HKuBIa1A1cypS0uY1wickv70iaY1gf3I1DTszuJoS3lAVLvhTcm9sDA/0", 
                                       "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=1&sn=80ce6d9abcb832237bf86c87e50fda15#rd", 
                                       "source_url": ""
                                   }, 
                                   { 
                                       "title": "MULTI_NEWS1", 
                                       "author": "JIMZHENG", 
                                       "digest": "MULTI_NEWS1", 
                                       "show_cover": 1, 
                                       "cover_url": "http://mmbiz.qpic.cn/mmbiz/GE7et87vE9vicuCibqXsX9GPPLuEtBfXfKnmnpXYgWmQD5gXUrEApIYBCgvh2yHsu3ic3anDUGtUCHwjiaEC5bicd7A/0", 
                                       "content_url": "http://mp.weixin.qq.com/s?__biz=MjM5ODUwNTM3Ng==&mid=204013432&idx=2&sn=8226843afb14ecdecb08d9ce46bc1d37#rd", 
                                       "source_url": ""
                                   }
                               ]
                           }
                       },
                       {
                           "type": "video", 
                           "name": "video", 
                           "value": "http://61.182.130.30/vweixinp.tc.qq.com/1007_114bcede9a2244eeb5ab7f76d951df5f.f10.mp4?vkey=77A42D0C2015FBB0A3653D29C571B5F4BBF1D243FBEF17F09C24FF1F2F22E30881BD350E360BC53F&sha=0&save=1"
                       }, 
                       { 
                           "type": "voice",
                           "name": "voice", 
                           "value": "nTXe3aghlQ4XYHa0AQPWiQQbFW9RVtaYTLPC1PCQx11qc9UB6CiUPFjdkeEtJicn"
                       }
                   ]
               }
           }, 
           { 
               "type": "text", 
               "name": "text", 
               "value": "This is text!"
           }, 
           { 
               "type": "img", 
               "name": "photo", 
               "value": "ax5Whs5dsoomJLEppAvftBUuH7CgXCZGFbFJifmbUjnQk_ierMHY99Y5d2Cv14RD"
           }
       ]
   }
}

如果公眾號是通過API調用設置的菜單,自定義菜單配置樣例如下:

{ 
   "is_menu_open": 1, 
   "selfmenu_info": { 
       "button": [ 
           { 
               "type": "click", 
               "name": "今日歌曲", 
               "key": "V1001_TODAY_MUSIC"
           }, 
           { 
               "name": "菜單", 
               "sub_button": { 
                   "list": [ 
                       { 
                           "type": "view", 
                           "name": "搜索", 
                           "url": "http://www.soso.com/"
                       }, 
                       { 
                           "type": "view", 
                           "name": "視頻", 
                           "url": "http://v.qq.com/"
                       }, 
                       { 
                           "type": "click", 
                           "name": "贊一下我們", 
                           "key": "V1001_GOOD"
                       }
                   ]
               }
           }
       ]
   }
}

參數說明

參數 說明
is_menu_open 菜單是否開啟,0代表未開啟,1代表開啟
selfmenu_info 菜單信息
button 菜單按鈕
type 菜單的類型,公眾平台官網上能夠設置的菜單類型有view(跳轉網頁)、text(返回文本,下同)、img、photo、video、voice。使用API設置的則有8種,詳見《自定義菜單創建接口》
name 菜單名稱
value、url、key等字段 對於不同的菜單類型,value的值意義不同。官網上設置的自定義菜單:

Text:保存文字到value; Img、voice:保存mediaID到value; Video:保存視頻下載鏈接到value; News:保存圖文消息到news_info; View:保存鏈接到url。

使用API設置的自定義菜單: click、scancode_push、scancode_waitmsg、pic_sysphoto、pic_photo_or_album、 pic_weixin、location_select:保存值到key;view:保存鏈接到url

news_info 圖文消息的信息
title 圖文消息的標題
digest 摘要
author 作者
show_cover 是否顯示封面,0為不顯示,1為顯示
cover_url 封面圖片的URL
content_url 正文的URL
source_url 原文的URL,若置空則無查看原文入口

請注意:

1. 上述接口支持公眾號登錄授權,從屬於消息與菜單權限集。第三方平台獲得公眾號的授權后,可以幫助公眾號調用該接口。

2. 對於接入了公眾號登錄授權的第三方平台,在公眾號授權給開發者后,開發者應當通過上述接口獲取公眾號的配置,為其重新配置,以保證公眾號運營者的業務運營體驗。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM