开发者社区> ytkahcom> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

微信公众平台新增获取自动回复和自定义菜单配置接口

简介:   微信公众平台自动回复功能可以为运营者减少了重复回复消息的次数,但如果自动回复的数量多的话管理就比较麻烦;自定义菜单相当于你这个公众号的导航,但有些公众号会限制不能添加外部链接。现在好了,公众平台开发者接口更新,新增获取自动回复和自定义菜单配置接口,对所有公众号开放。
+关注继续查看

  微信公众平台自动回复功能可以为运营者减少了重复回复消息的次数,但如果自动回复的数量多的话管理就比较麻烦;自定义菜单相当于你这个公众号的导航,但有些公众号会限制不能添加外部链接。现在好了,公众平台开发者接口更新,新增获取自动回复和自定义菜单配置接口,对所有公众号开放。

  

新增的接口具体是:

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. 对于接入了公众号登录授权的第三方平台,在公众号授权给开发者后,开发者应当通过上述接口获取公众号的配置,为其重新配置,以保证公众号运营者的业务运营体验。

 

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
微信公众号菜单管理接口开发
自定义菜单通过后台管理设置到数据库表,数据配置好后,通过微信接口推送菜单数据到微信平台。
0 0
【微信Java开发 --2】接入微信公众平台开发,配置自己的服务器,验证过程【验证服务器、自定义菜单、微信端消息分发】
接入微信公众平台开发,开发者需要按照如下步骤完成: 1、填写服务器配置 2、验证服务器地址的有效性 3、依据接口文档实现业务逻辑好我们就开始:1.登录微信公众平台,进入基本配置  修改配置,将自己的服务器的URL地址,配置在此处: 填写完成后,【先不用 提交】,先进行第二步 服务器端代码的配置 ...
2298 0
微信公众平台对所有公众号开放自定义菜单
据统计,微信公众号已达1000多万了,但大多数没有微信认证,且没有开发能力,为此微信公众平台开放了自定义菜单功能给所有公众号,这是微信团队年前给广大自媒体送的大礼,期待微信越来越开放 公众帐号运营者点击“添加功能插件”后选择右下角的“自定义菜单”卡片可申请开通自定义菜单插件。
627 0
微信公众平台消息接口PHP版开发教程
原文: 微信公众平台消息接口PHP版开发教程  一、写好接口程序 在你的服务器上上传好一个接口程序文件,如http://www.yourdomain.
759 0
微信公众平台自定义菜单新增扫一扫、发图片、发位置 LBS运作更便捷
  今天微信公众平台发布更新,自定义菜单新增扫一扫、发图片、发送位置等功能,这对于有意挖掘微信LBS服务的运营者来说更便捷了,订阅号不用返回微信界面就能扫图、发送图片、调用地理位置,用户体验更友好,自然也提高了黏度,对涨粉也好一些。
1039 0
微信小店开发(3) 自定义菜单加入维权
微信小店中,需要在菜单中加入“维权”按钮,让用户可以到达维权页面加入方法如下:给对应名称为“我要维权”的菜单设置链接(view事件),URL为 https://mp.weixin.qq.com/payfb/payfeedbackindex?appid=wx830f2de3fabcdefg#wechat_webview_type=1&wechat_redirect 把其中的appid,换成当前公众账号的即可。
775 0
微信公众平台开发(99) 自定义菜单获取OpenID
关键字 微信公众平台 自定义菜单 OpenID作者:方倍工作室原文:http://www.cnblogs.com/txw1958/p/weixin-menu-get-openid.html   在这篇微信公众平台开发教程中,我们将介绍如何在自定义菜单中获得用户的OpenID。
1225 0
微信公众平台开发文档 自定义菜单
自定义菜单能够帮助公众号丰富界面,让用户更好更快地理解公众号的功能。开启自定义菜单后,公众号界面如图所示: 目前自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。
745 0
微信公众平台自定义菜单接口API指南
微信公众平台开发模式自定义菜单接口API指南  开发实现方法,请查看  微信公众平台开发(58)自定义菜单   简介 开发者获取使用凭证(如何获取凭证)后,可以使用该凭证对公众账号的自定义菜单进行创建、查询和删除等操作。
1338 0
+关注
ytkahcom
ytkah常记录一些开发笔记,含微信公众平台、小程序、Dedecms、帝国cms、Finecms、thinkphp、mysql等,期待与您共成长!
文章
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载