C#微信公众号开发系列教程六（被动回复与上传下载多媒体文件）

关注

转载最新推荐文章于 2026-06-29 10:06:31 发布 1.6k 阅读 AI 写同款· GEO 优化 ›

C#开发微信公众号之消息自动回复作为计算机学院的学生的学生，时刻在打计算机学院官网的主意，前段时间我的一个好基友在我面前炫耀他的能够查课表的公众号（服务模拟登录返回数据），把我眼红得，所以我暗自下决心，自己一定要弄个微信公众号来玩玩儿。经过各种网上查资料，各种走弯路，还是实现了微信公众号机器人聊天功能。虽然这个很简单，但是网上完善而又详细的资料很难找，而且官网的开发文档只针对php语言发布了Demo，开发者文档简直坑爹，不过我还是阅读详情

转自http://www.2cto.com/kf/201501/368937.html

第四，第五章已经讲了怎么处理用户发送的消息，本章就来讲讲怎么响应用户的请求。想必新手看到这个标题也就懵了，千万别懵，微信的接口就这样，在回复图片、音乐、语音等都需要将我们的媒体文件上传到微信的服务器才能使用。不知道这样的做法是出于什么考虑的，而且同是给用户回复消息，客服接口和群发接口发送的消息体格式竟然是不同的。估计是这几处接口不是同一个人写的，没有做好代码的统一，咱们屌丝开发者只能无力吐槽了。

在讲上传下载接口前，需要先将下先来讲讲access_token获取方法。在微信接口开发的过程access_token是至关重要的，是公众号的全局唯一票据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。需要注意的时，一个公众号同时只存在一个有效的access_token，开发者需要在access_token过期前，刷新access_token。在刷新的过程中，公众平台后台会保证在刷新短时间内，新老access_token都可用，这保证了第三方业务的平滑过渡。

公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在微信公众平台官网-开发者中心页中获得（需要已经成为开发者，且帐号没有异常状态）。如下图：

image

获取access_token的接口地址是：

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

将appid和secret替换成你自己的。

发送get请求到这个地址，返回的数据如下：

{"access_token":"eEd6dhp0s24JfWwDyGBbrvJxnhqHTSYZ8MKdQ7MuCGBKxAjHv-tEIwhFZzn102lGvIWxnjZZreT6C1NCT9fpS7NREOkEX42yojVnqKVaicg","expires_in":7200}

我们只需解析这个json，即可获取到我们所需的access_token.代码如下：

AccessToken实体类：

public class AccessToken

{

public string token { get; set; }

public DateTime expirestime { get; set; }

}

获取access token

/// <summary>

/// 获取access token

/// </summary>

/// <param name="appid">第三方用户唯一凭证</param>

/// <param name="secret">第三方用户唯一凭证密钥，即appsecret</param>

/// <returns>AccessToken对象，expirestime是过期时间</returns>

public static AccessToken GetAccessToken(string appid, string secret)

{

try

{

string url = string.Format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}", appid, secret);

string retdata = Utils.HttpGet(url);

if (retdata.Contains("access_token"))

{

JObject obj = (JObject)JsonConvert.DeserializeObject(retdata);

string token = obj.Value<string>("access_token");

int expirestime = obj.Value<int>("expires_in");

return new AccessToken { token = token, expirestime = DateTime.Now.AddSeconds(expirestime) };

}

else

{

WriteBug(retdata);//写错误日志

}

return null;

}

catch (Exception e)

{

WriteBug(e.ToString());//写错误日志

return null;

}

access_token获取成功后，下面来讲上传下载多媒体文件吧。官方说，公众号在使用接口时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的（咱读书少，不明白为什么不能使用url，而要多此一举先上传到服务器在发送）。通过本接口，公众号可以上传或下载多媒体文件。但请注意，每个多媒体文件（media_id）会在上传、用户发送到微信服务器3天后自动删除，以节省服务器资源。

上传多媒体的接口地址是：

http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

其中access_token为调用接口凭证，type是媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）

注意事项：

上传的多媒体文件有格式和大小限制，如下：

图片（image）: 1M，支持JPG格式

语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式

视频（video）：10MB，支持MP4格式

缩略图（thumb）：64KB，支持JPG格式

媒体文件在后台保存时间为3天，即3天后media_id失效。

为了方便调用，将媒体文件的类型定义为枚举，代码如下：

public enum MediaType

{

/// <summary>

/// 图片（image）: 1M，支持JPG格式

/// </summary>

image,

/// <summary>

/// 语音（voice）：2M，播放长度不超过60s，支持AMR\MP3格式

/// </summary>

voice,

/// <summary>

/// 视频（video）：10MB，支持MP4格式

/// </summary>

video,

/// <summary>

/// 缩略图（thumb）：64KB，支持JPG格式

/// </summary>

thumb

}

然后定义返回值的类型：

public class UpLoadInfo

{

/// <summary>

/// 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb，主要用于视频与音乐格式的缩略图）

/// </summary>

public string type { get; set; }

/// <summary>

/// 媒体文件上传后，获取时的唯一标识

/// </summary>

public string media_id { get; set; }

/// <summary>

/// 媒体文件上传时间戳

/// </summary>

public string created_at { get; set; }

}

最后使用WebClient类来上传文件，并读出返回值，代码如下：

/// <summary>

/// 微信上传多媒体文件

/// </summary>

/// <param name="filepath">文件绝对路径</param>

public static ReceiveModel.UpLoadInfo WxUpLoad(string filepath, string token, MediaType mt)

{

using (WebClient client = new WebClient())

{

byte[] b = client.UploadFile(string.Format("http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token={0}&type={1}", token, mt.ToString()), filepath);//调用接口上传文件

string retdata = Encoding.Default.GetString(b);//获取返回值

if (retdata.Contains("media_id"))//判断返回值是否包含media_id，包含则说明上传成功，然后将返回的json字符串转换成json

{

return JsonConvert.DeserializeObject<UpLoadInfo>(retdata);

}

else

{//否则，写错误日志

WriteBug(retdata);//写错误日志

return null;

}

至此，在讲回复消息之前，插入了两个基础支持接口，由于各位整理归纳能力太烂了，各位看官请多包涵，如有问题就留言和我交流。下面正式开始讲回复消息。在看下面内容的时候，请大家结合第四，第五章进行阅读。

前面两章讲述了接收并处理用户发送的消息，讲到了一个消息基类BaseMessage，而不管我们接收到什么类型的消息，都需要可以调用方法，进行响应用户的请求，所以，用户回复用户请求的方法需要封装到基类中。下面先简单了解下公众号可以回复的消息类型，以及消息格式。

注意：

一旦遇到以下情况，微信都会在公众号会话中，向用户下发系统提示“该公众号暂时无法提供服务，请稍后再试”：

1、开发者在5秒内未回复任何内容

2、开发者回复了异常数据，比如JSON数据等

回复文本消息

<xml>

<CreateTime>消息创建时间（整型）</CreateTime>

</xml>

回复图片消息

<xml>

<CreateTime>消息创建时间（整型）</CreateTime>

<Image>

</Image>

</xml>

回复语音消息

<xml>

<CreateTime>消息创建时间（整型）</CreateTime>

<Voice>

</Voice>

</xml>

回复视频消息

<xml>

<CreateTime>消息创建时间（整型）</CreateTime>

<Video>

</Video>

</xml>

回复音乐消息

<xml>

<CreateTime>消息创建时间（整型）</CreateTime>

<Music>

</Music>

</xml>

回复图文消息

<xml>

<item>

</item>

<item>

</item>

</Articles>

</xml>

回复图文中，item是一个项，一个item代码一个图文。在响应的时候，我们只需根据数据格式，替换掉对应的属性，然后Response.Write(s)即可。结合前两章的讲解，BaseMessage的最终代码如下：

/// <summary>

/// 消息体基类

/// </summary>

public abstract class BaseMessage

{

/// <summary>

/// 开发者微信号

/// </summary>

public string ToUserName { get; set; }

/// <summary>

/// 发送方帐号（一个OpenID）

/// </summary>

public string FromUserName { get; set; }

/// <summary>

/// 消息创建时间（整型）

/// </summary>

public string CreateTime { get; set; }

/// <summary>

/// 消息类型

/// </summary>

public MsgType MsgType { get; set; }

public virtual void ResponseNull()

{

Utils.ResponseWrite("");

}

public virtual void ResText(EnterParam param, string content)

{

StringBuilder resxml = new StringBuilder(string.Format("<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime>", FromUserName, ToUserName, Utils.ConvertDateTimeInt(DateTime.Now)));

resxml.AppendFormat("<MsgType><![CDATA[text]]></MsgType><Content><![CDATA[{0}]]></Content><FuncFlag>0</FuncFlag></xml>", content);

Response(param, resxml.ToString());

}

/// <summary>

/// 回复消息(音乐)

/// </summary>

public void ResMusic(EnterParam param, Music mu)

{

StringBuilder resxml = new StringBuilder(string.Format("<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime>",FromUserName,ToUserName, Utils.ConvertDateTimeInt(DateTime.Now)));

resxml.Append(" <MsgType><![CDATA[music]]></MsgType>");

resxml.AppendFormat("<Music><Title><![CDATA[{0}]]></Title><Description><![CDATA[{1}]]></Description>", mu.Title, mu.Description);

resxml.AppendFormat("<MusicUrl><![CDATA[http://{0}{1}]]></MusicUrl><HQMusicUrl><![CDATA[http://{2}{3}]]></HQMusicUrl></Music><FuncFlag>0</FuncFlag></xml>", VqiRequest.GetCurrentFullHost(), mu.MusicUrl, VqiRequest.GetCurrentFullHost(), mu.HQMusicUrl);

Response(param, resxml.ToString());

}

public void ResVideo(EnterParam param, Video v)

{

StringBuilder resxml = new StringBuilder(string.Format("<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime>",FromUserName,ToUserName, Utils.ConvertDateTimeInt(DateTime.Now)));

resxml.Append(" <MsgType><![CDATA[video]]></MsgType>");

resxml.AppendFormat("<Video><MediaId><![CDATA[{0}]]></MediaId>", v.media_id);

resxml.AppendFormat("<Title><![CDATA[{0}]]></Title>", v.title);

resxml.AppendFormat("<Description><![CDATA[{0}]]></Description></Video></xml>", v.description);

Response(param, resxml.ToString());

}

/// <summary>

/// 回复消息(图片)

/// </summary>

public void ResPicture(EnterParam param, Picture pic, string domain)

{

StringBuilder resxml = new StringBuilder(string.Format("<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime>",FromUserName,ToUserName, Utils.ConvertDateTimeInt(DateTime.Now)));

resxml.Append(" <MsgType><![CDATA[image]]></MsgType>");

resxml.AppendFormat("<PicUrl><![CDATA[{0}]]></PicUrl></xml>", domain + pic.PictureUrl);

Response(param, resxml.ToString());

}

/// <summary>

/// 回复消息（图文列表）

/// </summary>

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

/// <param name="art"></param>

public void ResArticles(EnterParam param, List<Articles> art)

{

StringBuilder resxml = new StringBuilder(string.Format("<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime>",FromUserName,ToUserName, Utils.ConvertDateTimeInt(DateTime.Now)));

resxml.AppendFormat("<MsgType><![CDATA[news]]></MsgType><ArticleCount>{0}</ArticleCount><Articles>", art.Count);

for (int i = 0; i < art.Count; i++)

{

resxml.AppendFormat("<item><Title><![CDATA[{0}]]></Title> <Description><![CDATA[{1}]]></Description>", art[i].Title, art[i].Description);

resxml.AppendFormat("<PicUrl><![CDATA[{0}]]></PicUrl><Url><![CDATA[{1}]]></Url></item>", art[i].PicUrl.Contains("http://") ? art[i].PicUrl : "http://" + VqiRequest.GetCurrentFullHost() + art[i].PicUrl, art[i].Url.Contains("http://") ? art[i].Url : "http://" + VqiRequest.GetCurrentFullHost() + art[i].Url);

}

resxml.Append("</Articles><FuncFlag>0</FuncFlag></xml>");

Response(param, resxml.ToString());

}

/// <summary>

/// 多客服转发

/// </summary>

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

public void ResDKF(EnterParam param)

{

StringBuilder resxml = new StringBuilder();

resxml.AppendFormat("<xml><ToUserName><![CDATA[{0}]]></ToUserName>",FromUserName);

resxml.AppendFormat("<FromUserName><![CDATA[{0}]]></FromUserName><CreateTime>{1}</CreateTime>",ToUserName,CreateTime);

resxml.AppendFormat("<MsgType><![CDATA[transfer_customer_service]]></MsgType></xml>");

Response(param, resxml.ToString());

}

/// <summary>

/// 多客服转发如果指定的客服没有接入能力(不在线、没有开启自动接入或者自动接入已满)，该用户会一直等待指定客服有接入能力后才会被接入，而不会被其他客服接待。建议在指定客服时，先查询客服的接入能力指定到有能力接入的客服，保证客户能够及时得到服务。

/// </summary>

/// <param name="param">用户发送的消息体</param>

/// <param name="KfAccount">多客服账号</param>

public void ResDKF(EnterParam param, string KfAccount)

{

StringBuilder resxml = new StringBuilder();

resxml.AppendFormat("<xml><ToUserName><![CDATA[{0}]]></ToUserName>",FromUserName);

resxml.AppendFormat("<FromUserName><![CDATA[{0}]]></FromUserName><CreateTime>{1}</CreateTime>",ToUserName,CreateTime);

resxml.AppendFormat("<MsgType><![CDATA[transfer_customer_service]]></MsgType><TransInfo><KfAccount>{0}</KfAccount></TransInfo></xml>", KfAccount);

Response(param, resxml.ToString());

}

private void Response(EnterParam param, string data)

{

if (param.IsAes)

{

var wxcpt = new MsgCrypt(param.token, param.EncodingAESKey, param.appid);

wxcpt.EncryptMsg(data, Utils.ConvertDateTimeInt(DateTime.Now).ToString(), Utils.GetRamCode(), ref data);

}

Utils.ResponseWrite(data);

}

上面的代码中，public void ResDKF(EnterParam param)，public void ResDKF(EnterParam param, string KfAccount)两个方法时多客服中，用户转发用户发送的消息的，多客服将在后期的博文中进行更新，敬请期待。

public void ResMusic(EnterParam param, Music mu)方法中的Music类的定义如下：

public class Music

{

#region 属性

/// <summary>

/// 音乐链接

/// </summary>

public string MusicUrl { get; set; }

/// <summary>

/// 高质量音乐链接，WIFI环境优先使用该链接播放音乐

/// </summary>

public string HQMusicUrl { get; set; }

/// <summary>

/// 标题

/// </summary>

public string Title { get; set; }

/// <summary>

/// 描述

/// </summary>

public string Description { get; set; }

#endregion

}

public void ResVideo(EnterParam param, Video v)方法中的Video类的定义如下：

public class Video

{

public string title { get; set; }

public string media_id { get; set; }

public string description { get; set; }

}

public void ResArticles(EnterParam param, List<Articles> art)中的Articles定义如下：

public class Articles

{

#region 属性

/// <summary>

/// 图文消息标题

/// </summary>

public string Title { get; set; }

/// <summary>

/// 图文消息描述

/// </summary>

public string Description { get; set; }

/// <summary>

/// 图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80。

/// </summary>

public string PicUrl { get; set; }

/// <summary>

/// 点击图文消息跳转链接

/// </summary>

public string Url { get; set; }

#endregion

}

收录于

公众号

微信公众平台接收（回复）消息C#版此代码仅包含接收消息（事件）、发送被动响应消息 C#版，类库基于framework4.0，但是除了T4模板，其他代码可直接用于2.0. 立即下载

C#微信公众号开发系列教程六（被动回复与上传下载多媒体文件）

相关推荐