微信公眾平台自動回復功能可以為運營者減少了重復回復消息的次數,但如果自動回復的數量多的話管理就比較麻煩;自定義菜單相當於你這個公眾號的導航,但有些公眾號會限制不能添加外部鏈接。現在好了,公眾平台開發者接口更新,新增獲取自動回復和自定義菜單配置接口,對所有公眾號開放。
新增的接口具體是:
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. 對於接入了公眾號登錄授權的第三方平台,在公眾號授權給開發者后,開發者應當通過上述接口獲取公眾號的配置,為其重新配置,以保證公眾號運營者的業務運營體驗。