前7篇把最基础的消息接收和回复全做完了, 也把高级接口的入口和分拆处理写好了空方法, 此篇接着介绍微信的9大高级接口, 并着重讲解其中的自定义菜单。
微信9大接口为:
1.语音识别接口
2.客服接口
3.OAuth2.0 网页授权接口
4.生成带参数的二维码接口
5.获取用户地理位置接口
6.获取用户基本信息接口
7.获取关注者列表接口
8.用户分组接口
9.上传下载多媒体文件接口
具体介绍:
1. 语音识别
功能描述:通过语音识别接口,用户发送的语音,将同时给出语音识别出的文本内容。
实用意义:第三方可以调用微信自主研发的语音识别技术。意味着微信向第三方开放语音识别技术,直接调用语音识别接口,对语音识别结果进行互动或根据识别的内容进行自动答复。
2. 客服接口
功能描述:通过客服接口,公众号可以在用户发送过消息的 12 小时内,向用户回复消息。
实用意义:以前公众帐号跟订户只能被动响应,比如用户触发了需求,如发送关键字给公众帐号,后者才可以与用户对话。如今,如果订户跟公众帐号对话过一次,公众帐号就可以在 12 个小时内持续给用户下发消息。这提高了公众帐号发送消息的能力。
3. OAuth 2.0 网页授权
功能描述:通过网页授权接口,公众号可以请求用户授权。
实用意义:这就像微博、QQ的帐号授权功能。这意味着微信帐号正式成为一个帐号系统。
4. 生成带参数二维码
功能描述:通过该接口,公众号可以获得一系列携带不同参数的二维码,在用户扫描关注公众号后,公众号可以根据参数分析各二维码的效果。
实用意义:举例来说,以前放一个二维码在网站或者线下的广告牌,效果都是一样的:获得关注用户。现在可以分析订户来自哪里。开发者可以在链接里设置特殊信息,做更多的数据分析。这一功能也可以用来做帐号绑定,
5. 获取用户地理位置
功能描述:通过该接口,公众号能够获得用户进入公众号会话时的地理位置。
实用意义:两种情况可以获得用户地理位置:一是与公众帐号“会话时”,二是在会话界面“每隔 5 秒”。在用户同意下,这就可以做微信导航或地理围栏方面的服务。
6. 获取用户基本信息
功能描述:通过该接口,公众号可以根据加密后的用户 OpenID,获取用户基础信息,包括头像、名称、性别、地区。
实用意义:以前这是一个非常高的权限。获得用户基本信息后,可以做 CRM 管理后台,方便商家管理用户。
7. 获取关注者列表
功能描述:通过该接口,用户可以获取所有关注者的 OpenID
实用意义:以前不能知道有多少人关注你,是谁在关注你。如今你可以知道谁在关注你。
8. 用户分组接口
功能描述:通过分组接口,公众号可以在后台为用户移动分组,或创建、修改分组。
实用意义:可以对用户进行分组,比如乐思享组织一场“听众交流会”,现场来了 1000 人,可以把它归为一组,后续的活动花絮照片只发给这 1000 人。这对于商家来说,就是一个 VIP 会员管理,是 CRM 管理平台。
9. 上传下载多媒体文件
功能描述:通过该接口公众号可以在需要时在微信服务器上传下载多媒体文件。
实用意义:可以下发图片、视频。比如搞笑视频,上传到微信公众账号后台,可以向听众推送出来,相当于视频网站的一个业务。
以上就是微信9大高级接口的介绍, 其实现在应该是10个了,还有1个支付功能。
下面着重写自定义菜单。
自定义菜单只需要创建一次,之后都会存在,每次更改需要等待几分钟才可看到,创建:
创建好之后:
我这里是全部添加好之后,点击创建到微信,代码:
1 public void SetMenu() 2 { 3 4 dbHome=Factory.FContext.WeiXinDbContext(); 5 var listP = DAL.ListWhere<tb_PersonalMenu, int>(dbHome, a => a.ParentId == 0&& a.State==1, a => a.ID, 3); 6 List<Dictionary<string, object>> list = new List<Dictionary<string, object>>(); 7 foreach (var row in listP) 8 { 9 var listC = DAL.ListWhere<tb_PersonalMenu, int>(dbHome, a => a.ParentId == row.ID && a.State==1, a => a.ID, 5); 10 List<Dictionary<string, object>> list2 = new List<Dictionary<string, object>>(); 11 Dictionary<string, object> dic2m = new Dictionary<string, object>(); 12 Dictionary<string, object> dic1 = new Dictionary<string, object>(); 13 14 if (listC.Count > 0) 15 { 16 foreach(var row2 in listC) 17 { 18 //2级菜单内容 19 Dictionary<string, object> dic2c = new Dictionary<string, object>(); 20 21 dic2c.Add("type", row2.Type.ToString().Replace("1", "click").Replace("2","view")); 22 dic2c.Add("name", row2.Name); 23 if(row2.Type==1) 24 dic2c.Add("key", row2.ID); 25 if (row2.Type ==2) 26 dic2c.Add("url", row2.LinkUrl); 27 28 list2.Add(dic2c); 29 } 30 //-- 31 //2级菜单组装 32 dic2m.Add("name", row.Name); 33 dic2m.Add("sub_button", JsonHelper.ListDicToJsonVals(list2)); 34 //------ 35 list.Add(dic2m); 36 } 37 else 38 { 39 //1级菜单 40 dic1.Add("type", row.Type.ToString().Replace("1", "click").Replace("2", "view")); 41 dic1.Add("name", row.Name); 42 if (row.Type == 1) 43 dic1.Add("key", row.ID); 44 if (row.Type == 2) 45 dic1.Add("url", row.LinkUrl); 46 47 48 //---------- 49 list.Add(dic1); 50 } 51 //1级和2级装成list 52 53 54 //----------- 55 56 } 57 58 59 60 61 62 63 64 65 66 string m=JsonHelper.ListDicToJsonVals(list);//将list转成json的值 下面赋值给button 67 68 //赋值给button 69 Dictionary<string, object> dicAll = new Dictionary<string, object>(); 70 dicAll.Add("button", m); 71 //--------- 72 73 74 string jsonResult = JsonHelper.GetJsonStr(dicAll);//将dic转成json 75 //转换出来的 [{},{}]也会被“”包围,要去掉“” 76 77 jsonResult = jsonResult.Replace("\"[", "[").Replace("]\"", "]"); 78 string html = HttpHelper.HttpPost("https"+"://api.weixin.qq.com/cgi-bin/menu/create?access_token="+Common.Config.SystemConfig.access_token+"", jsonResult, Encoding.UTF8); 79 80 81 dbHome.Dispose(); 82 Response.Write(JsonHelper.JsonToVal(html, "errmsg")); 83 Response.End(); 84 85 }
最终是如下格式的json数据post到微信:
{ "button":[ { "type":"click", "name":"今日歌曲", "key":"V1001_TODAY_MUSIC" }, { "type":"click", "name":"歌手简介", "key":"V1001_TODAY_SINGER" }, { "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" }] }] }
这样就可以在微信中看到结果:
以上是属于后台管理中的创建菜单, 创建之后我们公号服务入口处对应的方法也完善下, 之前已经写好了一个空方法
public void DoMenuClick(DbContext dbHome, RMenuClick mMenuClk)
{
}
现在完善下:
1 //自定义菜单点击 2 public void DoMenuClick(DbContext dbHome, RMenuClick mMenuClk) 3 { 4 SText mStxtA = new SText(); 5 mStxtA.ToUserName = mMenuClk.FromUserName; 6 mStxtA.FromUserName = mMenuClk.ToUserName; 7 mStxtA.CreateTime = mMenuClk.CreateTime; 8 int id = 0; 9 mStxtA.Content = "欢迎使用,输入任意关键字开始体验"; 10 if(int.TryParse(mMenuClk.EventKey,out id)) 11 { 12 var me = DALWei.InfoEntities<tb_PersonalMenu>(dbHome, a => a.ID == id); 13 if(me!=null) 14 mStxtA.Content = "欢迎使用【"+me.Name+"】,介绍、说明、链接等等; 也可以是图文消息"; 15 } 16 17 Often.ResponseToEnd(DALWei.SendText(mStxtA)); 18 }
这个是点击类型的菜单处理, 需要说明的是,view类型的菜单点击就会直接跳转你所写的链接去, 1级菜单如果设置成view类型则不会跳转依旧执行点击事件;
效果:
我这里直接返回了一段文字, 实际应用中可以返回任何消息。