c#开发微信公众平台

时间：2024-01-09 13:41:56

之前帮公司开发过微信公众账号，今天特别将过程再回顾记录下来。

1.URL配置

启用开发模式需要先成为开发者，而且编辑模式和开发模式只能选择一个，进入微信公众平台-开发模式，如下：

c#开发微信公众平台

c#开发微信公众平台

从上面可以看出，点击提交后微信会向我们填写的服务器发送几个参数，然后需要原样返回出来，所以在提交url的时候，先在服务器创建接口测试返回echostr参数内容。代码：

//成为开发者url测试，返回echoStr

        public void InterfaceTest()

        {

            string token = "填写的token";

            if (string.IsNullOrEmpty(token))

            {

                return;

            }

            string echoString = HttpContext.Current.Request.QueryString["echoStr"];

            string signature = HttpContext.Current.Request.QueryString["signature"];

            string timestamp = HttpContext.Current.Request.QueryString["timestamp"];

            string nonce = HttpContext.Current.Request.QueryString["nonce"];

            if (!string.IsNullOrEmpty(echoString))

            {

                HttpContext.Current.Response.Write(echoString);

                HttpContext.Current.Response.End();

            }

        }

在一般处理程序ashx的ProcessRequest的方法内调用上面的方法，url填写的就是这个ashx的服务器地址，token是一个服务器标示，可以随便输入，代码中的token要和申请填写的一致，成为开发者才能做开发。

2.创建菜单

我们关注一些微信服务号，会发现聊天窗口下面有些菜单，这个可以在编辑模式简单配置，也可以在开发模式代码配置。详细参考微信公众平台开发者文档：http://mp.weixin.qq.com/wiki/index.php?title=自定义菜单创建接口，可以看到创建菜单的一些要点，下面的使用网页调试工具调试该接口，只是调试接口是否可用，并不是直接创建菜单的，菜单分为两种：

  • click： 用户点击click类型按钮后，微信服务器会通过消息接口推送消息类型为event 的结构给开发者（参考消息接口指南），并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值与用户进行交互。
  • view： 用户点击view类型按钮后，微信客户端将会打开开发者在按钮中填写的url值 （即网页链接），达到打开网页的目的。如果与网页授权获取用户基本信息接口结合，那么当用户进入后还会获得用户的登入个人信息。

　　click菜单需要填一个key，这个是在我们菜单点击事件的时候会用到，view只是一个菜单超链接。菜单数据是json格式，官网是php示例，其实C#实现起来也很简单，就是post发送一个json数据，示例代码：

/// <summary>

        /// 创建自定义菜单

        /// </summary>

        [AcceptVerbsAttribute("GET", "POST")]

        public JsonpResult CreateWxMenu()

        {

            string weixin1 = "";

            weixin1 += "{\n";

            weixin1 += "\"button\":[\n";

            weixin1 += "{\n";

            // weixin1 += "\"type\":\"click\",\n";

            //第一个菜单

            weixin1 += "\"name\":\"首页\",\n";

            weixin1 += "\"sub_button\":[\n";

            weixin1 += "{\n";

            weixin1 += "\"type\":\"click\",\n";

            weixin1 += "\"name\":\"学院简介\",\n";

            weixin1 += "\"key\":\"V1001_SUMMARY\"\n";

            weixin1 += "},\n";

            weixin1 += "{\n";

            weixin1 += "\"type\":\"click\",\n";

            weixin1 += "\"name\":\"师资力量\",\n";

            weixin1 += "\"key\":\"V1001_TEACHERS\"\n";

            weixin1 += "},\n";

            weixin1 += "{\n";

            weixin1 += "\"type\":\"click\",\n";

            weixin1 += "\"name\":\"报名指南\",\n";

            weixin1 += "\"key\":\"V1001_REGISTRATION\"\n";

            weixin1 += "}]\n";

            weixin1 += "},\n";

            //第二个菜单

            weixin1 += "{\n";

            weixin1 += "\"type\":\"click\",\n";

            weixin1 += "\"name\":\"课程\",\n";

            weixin1 += "\"key\":\"V1001_COURSES\",\n";

            weixin1 += "\"sub_button\":[]\n";

            weixin1 += "},\n";

            //第三个菜单

            weixin1 += "{\n";

            weixin1 += "\"type\":\"click\",\n";

            weixin1 += "\"name\":\"活动\",\n";

            weixin1 += "\"key\":\"V1001_ACTIONS\",\n";

            weixin1 += "\"sub_button\":[]\n";

            weixin1 += "}]\n";

            weixin1 += "}\n";

            string str = PostMenuData(postUrl + GetAccessToken(), weixin1);

            JsonpResult result = new JsonpResult()

            {

                Data = str,

                JsonRequestBehavior = System.Web.Mvc.JsonRequestBehavior.AllowGet

            };

            return result;

        }

private string PostMenuData(string url, string postData)

        {

            Stream outstream = null;

            Stream instream = null;

            StreamReader sr = null;

            HttpWebResponse response = null;

            HttpWebRequest request = null;

            Encoding encoding = Encoding.UTF8;

            byte[] data = encoding.GetBytes(postData);

            // 准备请求...

            try

            {

                // 设置参数

                request = WebRequest.Create(url) as HttpWebRequest;

                CookieContainer cookieContainer = new CookieContainer();

                request.CookieContainer = cookieContainer;

                request.AllowAutoRedirect = true;

                request.Method = "POST";

                request.ContentType = "application/x-www-form-urlencoded";

                request.ContentLength = data.Length;

                outstream = request.GetRequestStream();

                outstream.Write(data, , data.Length);

                outstream.Close();

                //发送请求并获取相应回应数据

                response = request.GetResponse() as HttpWebResponse;

                //直到request.GetResponse()程序才开始向目标网页发送Post请求

                instream = response.GetResponseStream();

                sr = new StreamReader(instream, encoding);

                //返回结果网页（html）代码

                string content = sr.ReadToEnd();

                return content;

            }

            catch (Exception ex)

            {

                return ex.Message;

            }

        }

其中postUrl是要的微信接口https://api.weixin.qq.com/cgi-bin/menu/create?access_token=，GetAccessToken()是获取自定义菜单token，通过appid和secret可以获得token值。需要注意的是：token有一定的时效性，失效的话就需要重新获取下，这个在本机就可以创建，不需要上传到服务器。

创建菜单正确，返回{"errcode":0,"errmsg":"ok"}提示信息。一般创建菜单是一到两分钟生效，实在不行就重新关注下。

3.删除菜单

/// <summary>

        /// 删除自定义菜单

        /// </summary>

        /// <param name="url"></param>

        [AcceptVerbsAttribute("GET", "POST")]

        private JsonpResult DelWxMenu()

        {

            string url = postDelUrl + GetAccessToken();

            if (string.IsNullOrEmpty(url))

            {

                throw new ArgumentNullException("url");

            }

            Encoding encoding = Encoding.UTF8;

            HttpWebRequest request = WebRequest.Create(url) as HttpWebRequest;

            request.Method = "GET";

            HttpWebResponse response = request.GetResponse() as HttpWebResponse;

            Stream instream = response.GetResponseStream();

            StreamReader sr = new StreamReader(instream, encoding);

            string content = sr.ReadToEnd();

            JsonpResult result = new JsonpResult()

            {

                Data = content,

                JsonRequestBehavior = System.Web.Mvc.JsonRequestBehavior.AllowGet

            };

            return result;

        }

postDelUrl为https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=。

删除成功返回信息提示：{"errcode":0,"errmsg":"ok"}，这个也只要在本地运行就可以了。

4.接收消息

微信公众平台开发者文档：http://mp.weixin.qq.com/wiki/index.php?title=接收普通消息，我们使用微信公众号可以对用户发送的信息进行处理，以接受普通消息为例，语音、图片消息类似。

从官方文档上可以看出接收消息获得的是一个xml格式文件，如下：

<xml>

 <ToUserName><![CDATA[toUser]]></ToUserName>

 <FromUserName><![CDATA[fromUser]]></FromUserName>

 <CreateTime>1348831860</CreateTime>

 <MsgType><![CDATA[text]]></MsgType>

 <Content><![CDATA[this is a test]]></Content>

 <MsgId>1234567890123456</MsgId>

 </xml>

那么当用户发送消息给公众账号时，微信就会调用我们的接口。你说微信怎么知道我们的地址？因为前面我们有验证我们的服务器地址。

说到底微信公众号的开发，就是微信和我们之间相互调用api接口，而接口的定义规范在官网上都有，只要了解了核心思想，其他的根据文档指示来做，都简单了许多。

回到正题，我们需要在ashx中定义处理微信发来的消息：

相关文章