分享我们团队最近开发的微信公众号运营助手,可以在手机上回复粉丝留言
2016-09-08 16:24
519 查看
由于公司旗下有好几个微信公众号,经常来回切换登录很麻烦,粉丝留言咨询的时候常常不能及时回复,导致订单流失。于是我们团队开发了一个公众号小助手,可以把多个公众号绑定进来,只要有粉丝留言,马上管理员就收到通知了,然后还可以在手机上进行回复。
实现的功能如下:
粉丝留言自动微信通知
在微信中回复粉丝留言,文字+图片
粉丝关注自动微信通知
粉丝关注自动推送多图文消息或者历史消息
更强大的自定义菜单管理
自定义客服消息模板
支持绑定多个管理员
支持关键词自动回复
支持二次开发
虽然这个小助手很小,但是里面用到的技术我觉得还是有一定分享价值。本文就向大家分享一下这个小助手中核心的技术方案,包括:公众号绑定、粉丝信息获取、给粉丝发送消息、微信图片上传与下载、公众号自定义菜单接口、公众号临时二维码的妙用等等。
免费在线体验:
请看源码:
一旦拿到了某个公众号的AccessToken,就可以调用绝大部分接口了。
微信提供了几个事件发生的时候,程序可以获取用户的OpenId,而用OpenId就可以跟用户互动。我们仅用了2个事件获取OpenId:粉丝关注时和粉丝留言时。
下面的代码展示了如何通过OpenId和AccessToken获取粉丝基本信息。
如果推送的是文本消息:
如果推送的是图片消息,则需要先上传图片到微信服务器拿到media_Id(本文后面会展示):
关于图片上传这块,我们封装了一个非常方便的微信图片上传控件,等以后有时间再给大家详解这个控件,绝对超cool的,现在你可以先体验下。
图片上传之前,需要先将用户上传的图片保存到服务器,然后再将服务器的图片上传到微信服务器:
下载图片就非常简单了,只需要通过media_id获取下载图片的URL即可:
先看下我们的自定义菜单编辑器吧,纯JS打造的,有机会也给大家分享下:
调用这个JS的菜单编辑器非常简单,只需要传入一个容器和accesstoken即可:
而传到我们服务器之后,调用微信接口的代码就非常简单了:
业务流程:公众号所有者点击【添加管理员】,我们系统就弹出一个有效期5分钟的临时二维码,另一个管理员扫码关注公众号之后,自动将他绑定到该公众号,再给用户推送一条客服消息,告诉他绑定成功。
这个体验是相当的帅啊!
生成临时二维码的代码:
用户扫码关注后,服务器完成自动绑定的代码就不贴了,太多了,并且夹杂着我们系统其他的业务逻辑,不容易理解。
实现的功能如下:
粉丝留言自动微信通知
在微信中回复粉丝留言,文字+图片
粉丝关注自动微信通知
粉丝关注自动推送多图文消息或者历史消息
更强大的自定义菜单管理
自定义客服消息模板
支持绑定多个管理员
支持关键词自动回复
支持二次开发
虽然这个小助手很小,但是里面用到的技术我觉得还是有一定分享价值。本文就向大家分享一下这个小助手中核心的技术方案,包括:公众号绑定、粉丝信息获取、给粉丝发送消息、微信图片上传与下载、公众号自定义菜单接口、公众号临时二维码的妙用等等。
免费在线体验:
核心技术1:多个公众号的绑定
想要调用微信公众号的API,首先要通过AppId和AppSecret获取AccessToken,而AccessToken过一段时间就会过期。为了提高AccessToken的利用率并且实现自动刷新,我们专门写了一个AccessTokenContext来管理多个公众号的AccessToken,这个类也是完成多个公众号绑定最重要的一步。请看源码:
public class AccessTokenContext { public static AccessTokenContext Instance { get; } static AccessTokenContext() { Instance = new AccessTokenContext(); } private readonly Dictionary<Guid, AccountAccessTokenDto> _keyValues; public AccessTokenContext() { _keyValues = new Dictionary<Guid, AccountAccessTokenDto>(); } public string GetDabenAccessToken() { return GetAccessToken(AppContext.DabenMpAccountId); } public string GetAccessToken(Guid accountId) { if (_keyValues.ContainsKey(accountId)) { var dto = _keyValues[accountId]; if (dto.IsExpired() == false) { return dto.AccessToken; } } var account = Ioc.Get<IAccountService>().Get(accountId); var apidto = GetByApi(account); _keyValues[account.Id] = apidto; return apidto.AccessToken; } public string GetAccessToken(MpAccount account) { if (_keyValues.ContainsKey(account.Id)) { var dto = _keyValues[account.Id]; if (dto.IsExpired()) { dto = GetByApi(account); } return dto.AccessToken; } else { var dto = GetByApi(account); _keyValues[account.Id] = dto; return dto.AccessToken; } } private AccountAccessTokenDto GetByApi(MpAccount account) { var token = WeixinApi.GetAccessToken(account.AppId, account.AppSecret); if (token == null || token.IsSuccess() == false) { throw new KnownException("Mp.GetAccessToken:" + account.Name); } return new AccountAccessTokenDto(account.Id, token); } }
一旦拿到了某个公众号的AccessToken,就可以调用绝大部分接口了。
核心技术2:拉取粉丝基本信息
不同的微信公众号下面的粉丝拥有不同的OpenId,而OpenId是微信对于用于的唯一标识。微信提供了几个事件发生的时候,程序可以获取用户的OpenId,而用OpenId就可以跟用户互动。我们仅用了2个事件获取OpenId:粉丝关注时和粉丝留言时。
下面的代码展示了如何通过OpenId和AccessToken获取粉丝基本信息。
public class WeixinApi { public static UserDto GetUserInfo(string openId, string accessToken = null) { return HttpHelper.GetApiDto<UserDto>(WeixinConfigs.Urls.GetUserInfo(openId, accessToken)); } }
internal class HttpHelper { public static T GetApiDto<T>(string url) where T : ApiDtoBase { var html = DownloadString(url); try { var dto = Serializer.FromJson<T>(html); if (dto.IsSuccess() == false) { Logger.Error("GetApiDto." + typeof(T).FullName + ".NotSuccess", dto.GetFullError()); } return dto; } catch (Exception ex) { Logger.Error("GetApiDto." + typeof(T).FullName + ".Exception", ex); Logger.Error("GetApiDto." + typeof(T).FullName + ".Exception", html); } return null; } }
核心技术3:给粉丝发送消息
注意这里仅仅是发送的客服消息,也就是粉丝与公众号互动之后的48小时内可以随意给粉丝发送的消息,包括文字和图片。public class WeixinApi { public static ApiDtoBase TrySendMessage(MessageBase message, string accessToken = null) { try { return HttpHelper.PostApiDto<ApiDtoBase>(WeixinConfigs.Urls.SendMessage(message is TemplateMessageBase, accessToken), message.ToJson()); } catch (Exception ex) { Logger.Error("WeixinApi TrySendMessage", ex); } return null; } }
internal class HttpHelper { public static T PostApiDto<T>(string url, string json) where T : ApiDtoBase { string html; using (var client = new WebClient()) { var result = client.UploadData(url, "POST", Encoding.UTF8.GetBytes(json ?? string.Empty)); html = Encoding.UTF8.GetString(result); } try { var dto = Serializer.FromJson<T>(html); if (dto.IsSuccess() == false) { Logger.Error("PostApiDto." + typeof(T).FullName + ".NotSuccess", dto.GetFullError()); } return dto; } catch (Exception ex) { Logger.Error("PostApiDto." + typeof(T).FullName + ".Exception", ex); return null; } } }
如果推送的是文本消息:
public class TextMessage : MessageBase { public string Text { get; set; } public TextMessage(string openId, string text) { this.ToUserOpenId = openId; this.Text = text; } public override string ToJson() { return Serializer.ToJson( new { touser = this.ToUserOpenId, msgtype = "text", text = new { content = this.Text } }); } }
如果推送的是图片消息,则需要先上传图片到微信服务器拿到media_Id(本文后面会展示):
public class ImageMessage : MessageBase { public string MediaId { get; set; } public ImageMessage(string openId, string mediaId) { this.ToUserOpenId = openId; this.MediaId = mediaId; } public override string ToJson() { return Serializer.ToJson( new { touser = this.ToUserOpenId, msgtype = "image", image = new { media_id = this.MediaId } }); } }
核心技术4:微信图片上传与下载
微信图片的上传与下载都是通过media_id进行的。上传一个图片文件之后,微信服务器返回media_id;如果要下载某张图片,也需要提供media_id。关于图片上传这块,我们封装了一个非常方便的微信图片上传控件,等以后有时间再给大家详解这个控件,绝对超cool的,现在你可以先体验下。
图片上传之前,需要先将用户上传的图片保存到服务器,然后再将服务器的图片上传到微信服务器:
public class WeixinApi { public static UploadFileDto UploadFile(string localFilePath, ResourceType type, string accessToken = null) { return HttpHelper.PostFile<UploadFileDto>(WeixinConfigs.Urls.UploadFile(type, accessToken), localFilePath); } }
internal class HttpHelper { public static T PostFile<T>(string url, string filePath) where T : ApiDtoBase { string html; using (var client = new WebClient()) { var result = client.UploadFile(url, "POST", filePath); html = Encoding.UTF8.GetString(result); } try { var dto = Serializer.FromJson<T>(html); if (dto.IsSuccess() == false) { Logger.Error("PostFile." + typeof(T).FullName + ".NotSuccess", dto.GetFullError()); } return dto; } catch (Exception ex) { Logger.Error("PostFile." + typeof(T).FullName + ".Exception", ex); return null; } } }
下载图片就非常简单了,只需要通过media_id获取下载图片的URL即可:
public static string GetMediaDownloadUrl(string mediaId, string accessToken = null) { return "http://file.api.weixin.qq.com/cgi-bin/media/get" + $"?access_token={accessToken ?? WeixinKeyManager.Instance.GetAccessToken()}&media_id={mediaId}"; }
核心技术5:自定义菜单的实现
由于微信定义的接口可以接受JSON格式的自定义菜单项,所以我们就用JS在浏览器中编辑菜单,然后最终提交的时候,将整个菜单序列化成JSON,一起提交到微信服务器。先看下我们的自定义菜单编辑器吧,纯JS打造的,有机会也给大家分享下:
调用这个JS的菜单编辑器非常简单,只需要传入一个容器和accesstoken即可:
(function() { $(document).ready(function () { var manager = new WeixinMenuAppManager($("#hfAccessToken").val(), $(".content")); manager.init(); $("#hfAccessToken").remove(); }); })();
而传到我们服务器之后,调用微信接口的代码就非常简单了:
public class WeixinApi { public static string GetMenuJson(string accessToken = null) { return HttpHelper.DownloadString(WeixinConfigs.Urls.GetMenu(accessToken)); } public static ApiDtoBase SaveMenu(string json, string accessToken = null) { return HttpHelper.PostApiDto<ApiDtoBase>(WeixinConfigs.Urls.SaveMenu(accessToken), json); } public static ApiDtoBase DeleteMenu(string accessToken = null) { return HttpHelper.PostApiDto<ApiDtoBase>(WeixinConfigs.Urls.DeleteMenu(accessToken), null); } }
核心技术6:带参数的临时二维码
首先说一下这个临时二维码是由微信服务器生成的。用户扫码之后,首先是关注公众号,同时我们服务器还接收到了这个二维码额外的一个参数(系统唯一标识),我们利用这个参数就可以很方便的完成多管理员扫码自动绑定的功能了。业务流程:公众号所有者点击【添加管理员】,我们系统就弹出一个有效期5分钟的临时二维码,另一个管理员扫码关注公众号之后,自动将他绑定到该公众号,再给用户推送一条客服消息,告诉他绑定成功。
这个体验是相当的帅啊!
生成临时二维码的代码:
public static string GetTempQrCodeUrl(int autoId, int expireMinutes, string accessToken = null) { var data = Serializer.ToJson(new { expire_seconds = expireMinutes*60, action_name = "QR_SCENE", action_info = new { scene = new { scene_id = autoId } } }); var result = HttpHelper.PostApiDto<GetQrCodeDto>(WeixinConfigs.Urls.GenerateQrCode(accessToken), data); if (result.IsSuccess() == false) { throw new KnownException(result.GetFullError()); } return WeixinConfigs.Urls.ShowQrCode(result.Ticket); }
用户扫码关注后,服务器完成自动绑定的代码就不贴了,太多了,并且夹杂着我们系统其他的业务逻辑,不容易理解。
结语
这个公众号小助手虽然很小,但几乎完全包含了我们团队在微信公众号开发方面积累的经验,以及我们自己封装的很多控件、类库。如果大家感兴趣的话,后面我再专门把这些积累开源。相关文章推荐
- 分享微信公众号运营助手,可以在手机上回复粉丝留言
- 分享微信公众号运营助手,可以在手机上回复粉丝留言
- 最近收集一些ios开发技术博客来看,大家有好的,也可以回复
- 今日头条刷粉丝软件助手,刷关注有办法可以刷,只是慢了点,分享快速实现刷头条粉丝方法
- 最近收集一些ios开发技术博客来看,大家有好的,也可以回复
- 分享最近我们团队对GFS脑裂的分析 - 感谢陈方县同学
- 微信网页第三方登录原理 微信开放平台和公众平台的区别 1.公众平台面向的时普通的用户,比如自媒体和媒体,企业官方微信公众账号运营人员使用,当然你所在的团队或者公司有实力去开发一些内容,也可以调用公众
- 最近微信上很火的小游戏【壹秒】android版——开发分享
- 软件开发人员助手 好工具分享 顺祝新中国成立60周年
- 《BREW进阶与精通——3G移动增值业务的运营、定制与开发》连载之34---手机上应用的预安装
- 手机APP开发自己做,还是找专业的团队
- 微信开发教程:用户账号绑定到微信公众号的方法分享
- 经验分享:独立游戏开发团队应避免9个错误
- 微信公众号开发(二)--生成可以关注的二维码
- Python开发之快速搭建自动回复微信公众号功能
- 和小猪一起搞微信公众号开发—回复简单文本
- 画画一样开发软件 TERSUS让任何人可以无代码开发手机电脑软件
- 关于建立控件、组件开发团队,有兴趣的网友请留言
- 微信公众号开发整理(三)--图片消息回复之【获取access_token】