目录
- 基本原理
- 公众号申请及配置
- 验证服务器有效性
- 微信请求消息类型
基本原理
- 基本原理如上图:腾讯微信服务器就相当于一个转发服务器,终端(手机、Pad等)发起请求至微信服务器,微信服务器然后将请求转发给我们的开发者服务器,在开发者服务器端可加入我们的业务处理逻辑(如:调用luis API 获取luis定义的Intent和Entity,接入业务处理逻辑),开发者服务器(应用服务器)处理完毕后,将响应数据回发给微信服务器,微信服务器再将具体响应信息回复到微信App终端
- 通信协议为:HTTP
- 数据传输格式为:XML
公众号申请及配置
- 申请地址: https://mp.weixin.qq.com/
- 登陆系统,在开发->基本配置界面,设置服务器配置信息,包含服务器地址(URL)、Token和EncodingAESKey,如下图
- 服务器地址即公众号后台提供业务逻辑的入口地址,包括接入验证以及任何其它操作的请求(例如消息的发送、菜单管理、素材管理等)都要从这个地址进入。
- 接入验证和其它请求的区别就是,接入验证时是get请求,其它时候是post请求
- Token: 用作生成签名(该Token会和接口URL中包含的Token进行比对,从而验证安全性)
- EncodingAESKey: 将用作消息体加解密密钥
验证服务器有效性
- 录入服务器配置信息,点击“提交”按钮后,微信服务器将发送一个http的get请求到刚刚填写的服务器地址,并且携带四个参数
-
接到请求后,需要做如下三步,若确认此次GET请求来自微信服务器,原样返回echostr参数内容,则接入生效,否则接入失败。
-
将token、timestamp、nonce三个参数进行字典序排序
-
将三个参数字符串拼接成一个字符串进行sha1加密
-
开发者获得加密后的字符串可与signature对比,标识该请求来源于微信
-
-
c#代码实现:1、创建空的web工程 2、添加wx.ashx文件 3、wx.ashx代码如下
using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Web; using System.Web.Security; using System.Xml; namespace WXHandler { /// <summary> /// wx 的摘要说明 /// </summary> public class wx : IHttpHandler { /// <summary> /// /// </summary> /// <param name="context"></param> public void ProcessRequest(HttpContext context) { WXContext wxContext = new WXContext(context); if (wxContext.IsHttpGet) //校验签名,在公众平台填入服务器端配置信息提交之后检验使用 { ValidateUrl(wxContext); } else { HandleMsg(wxContext); } } /// <summary> /// /// </summary> /// <param name="wxContext"></param> private void ValidateUrl(WXContext wxContext) { string echostr = string.Empty; bool success = BasicAPI.CheckSignature(wxContext, out echostr); if (success) { HttpContext context = HttpContext.Current; context.Response.ContentType = "text/plain"; context.Response.Write(echostr); } } /// <summary> /// /// </summary> /// <param name="wxContext"></param> public void HandleMsg(WXContext wxContext) { string msg = WeixinExecutor.Default.Execute(wxContext.WxMsg); HttpContext context = HttpContext.Current; context.Response.ContentType = "text/plain"; context.Response.Write(msg); } public bool IsReusable { get { return false; } } } }
-
检测代码:
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Net.Http; using System.IO; namespace WXHandler { /// <summary> /// 对应微信API的 "基础支持" /// </summary> public class BasicAPI { /// <summary> /// 检查签名是否正确: /// </summary> /// <param name="wxContext"></param> /// <param name="echostr"></param> /// <returns></returns> public static bool CheckSignature(WXContext wxContext, out string echostr) { var arr = new[] {wxContext.Token,wxContext.Timetamp,wxContext.Nonce}.OrderBy(z => z).ToArray(); var arrString = string.Join("", arr); var sha1 = System.Security.Cryptography.SHA1.Create(); var sha1Arr = sha1.ComputeHash(Encoding.UTF8.GetBytes(arrString)); StringBuilder enText = new StringBuilder(); foreach (var b in sha1Arr) { enText.AppendFormat("{0:x2}", b); } echostr = enText.ToString(); return wxContext.Signature == enText.ToString(); } } }
微信请求消息类型
- 微信开发文档参见: https://mp.weixin.qq.com/wiki
- 参见如下代码:包含有文本、语音、图片、位置等信息类型
- 注意:开通语音识别后,用户每次发送语音给公众号时,微信会在推送的语音消息XML数据包中,增加一个Recongnition字段(注:由于客户端缓存,开发者开启或者关闭语音识别功能,对新关注者立刻生效,对已关注用户需要24小时生效。开发者可以重新关注此帐号进行测试)。
- 在处理这些消息时,先可查看当前帐号已经获取的权限,位置:开发-->接口权限,默认情况,接收消息中的“接收语音识别结果”选项是关闭的
-
实现代码如下:
using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Text; using System.Text.RegularExpressions; using System.Threading.Tasks; using System.Runtime.Serialization; using System.IO; namespace WXHandler { /// <summary> /// /// </summary> public class WeixinExecutor : IWeixinExecutor { /// <summary> /// /// </summary> public static WeixinExecutor Default { get { return new WeixinExecutor(); } } /// <summary> /// /// </summary> /// <param name="message"></param> /// <returns>已经打包成xml的用于回复用户的消息包</returns> public string Execute(WeixinMessage message) { string result = string.Empty; var openId = message.Body.FromUserName.Value; var myUserName = message.Body.ToUserName.Value; switch (message.Type) { case WeixinMessageType.Text://文字消息 { string userMessage = message.Body.Content.Value; var BotMessage = LuisService.Default.PostMessage(userMessage); result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage); } break; case WeixinMessageType.Image://图片消息 { string imageUrl = message.Body.PicUrl.Value;//图片地址 var msg = ImageService.Default.PostMessage(imageUrl); result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, msg); } break; case WeixinMessageType.Voice://语音消息 { var recognition = Convert.ToString(message.Body.Recognition.Value); var BotMessage = LuisService.Default.PostMessage(recognition); if (BotMessage == LuisInfos.DEFAULT_LUIS) BotMessage += string.Format(" 您输入的内容为:{0}", recognition); result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage); } break; case WeixinMessageType.Location://地理位置消息 { var location_X = message.Body.Location_X.Value.ToString(); var location_Y = message.Body.Location_Y.Value.ToString(); var BotMessage = LocationService.Default.PostMessage(location_Y, location_X); result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage); } break; case WeixinMessageType.Link://链接消息 { var title = message.Body.Title.Value.ToString(); var description = message.Body.Description.Value.ToString(); var url = message.Body.Url.Value.ToString(); var msgId = message.Body.MsgId.Value.ToString(); } break; default: result = ReplayPassiveMessageAPI.RepayText(openId, myUserName,"xxxxxx......"); break; } return result; } } }