微信开发之客服消息的使用

之前的消息发送与接收都是用户给微信发一条，之后微信回复给用户，也就是API上面所说的被动回复消息，那么微信是否支持主动给关注用户发消息吗，答案是肯定的，但是却有一些限制。看下微信开发文档上怎么说就明白了：

当用户主动发消息给公众号的时候（包括发送信息、点击自定义菜单、订阅事件、扫描二维码事件、支付成功事件、用户维权），微信将会把消息数据推送给开发者，开发者在一段时间内（目前修改为48小时）可以调用客服消息接口，通过POST一个JSON数据包来发送消息给普通用户，在48小时内不限制发送次数。此接口主要用于客服等有人工消息处理环节的功能，方便开发者为用户提供更加优质的服务。

这次就针对客服消息分享下我的心得和体会

1  客服接口-发消息接口使用说明

接口调用请求说明

http请求方式: POSThttps://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

各消息类型所需的JSON数据包如下：

发送文本消息

{    "touser":"OPENID",    "msgtype":"text",    "text":    {         "content":"Hello World"    }}

发送图片消息

{    "touser":"OPENID",    "msgtype":"image",    "image":    {      "media_id":"MEDIA_ID"    }}

发送语音消息

{    "touser":"OPENID",    "msgtype":"voice",    "voice":    {      "media_id":"MEDIA_ID"    }}

......,基本上来说常用的消息类型，客服接口都是支持的

2  封装客服消息接口

       public static String makeTextCustomMessage(String openId,String content){content.replace("\"", "\\\"");String jsonMsg="{\"touser\":\"%s\",\"msgtype\":\"text\",\"text\":{\"content\":\"%s\"}}";return String.format(jsonMsg, openId,content);}/** * 组装图片客服消息 *  * @param openId 消息发送对象 * @param mediaId 媒体文件id * @return */public static String makeImageCustomMessage(String openId, String mediaId) {String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"image\",\"image\":{\"media_id\":\"%s\"}}";return String.format(jsonMsg, openId, mediaId);}/** * 组装语音客服消息 *  * @param openId 消息发送对象 * @param mediaId 媒体文件id * @return */public static String makeVoiceCustomMessage(String openId, String mediaId) {String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"voice\",\"voice\":{\"media_id\":\"%s\"}}";return String.format(jsonMsg, openId, mediaId);}/** * 组装视频客服消息 *  * @param openId 消息发送对象 * @param mediaId 媒体文件id * @param thumbMediaId 视频消息缩略图的媒体id * @return */public static String makeVideoCustomMessage(String openId, String mediaId, String thumbMediaId) {String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"video\",\"video\":{\"media_id\":\"%s\",\"thumb_media_id\":\"%s\"}}";return String.format(jsonMsg, openId, mediaId, thumbMediaId);}/** * 组装音乐客服消息 *  * @param openId 消息发送对象 * @param music 音乐对象 * @return */public static String makeMusicCustomMessage(String openId, Music music) {String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"music\",\"music\":%s}";jsonMsg = String.format(jsonMsg, openId, JSONObject.fromObject(music).toString());// 参数名称替换 @20140125jsonMsg = jsonMsg.replace("musicUrl", "musicurl");jsonMsg = jsonMsg.replace("HQMusicUrl", "hqmusicurl");jsonMsg = jsonMsg.replace("thumbMediaId", "thumb_media_id");return jsonMsg;}/** * 组装图文客服消息 *  * @param openId 消息发送对象 * @param articleList 图文消息列表 * @return */public static String makeNewsCustomMessage(String openId, List<Article> articleList) {String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"news\",\"news\":{\"articles\":%s}}";jsonMsg = String.format(jsonMsg, openId, JSONArray.fromObject(articleList).toString().replaceAll("\"", "\\\""));// 将jsonMsg中的picUrl替换为picurljsonMsg = jsonMsg.replace("picUrl", "picurl");return jsonMsg;}public static boolean sendCustomMessage(String token,String jsonMsg){boolean flag=false;//String accessToken=getAccessToken("xxxx","xxxx").getToken();String requestUrl="https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN";requestUrl=requestUrl.replace("ACCESS_TOKEN", token);JSONObject jsonResult=CommonUtil.httpsRequest(requestUrl, "POST", jsonMsg);if(jsonResult!=null){int errorCode=jsonResult.getInt("errcode");String errorMessage=jsonResult.getString("errmsg");if(errorCode==0){flag=true;}else{System.out.println("客服消息发送失败:"+errorCode+","+errorMessage);flag=false;}}return flag;}

3 调用客服消息发送接口给指定用户发送客服消息

List<Article> all=new ArrayList<Article>();Article a2=new Article();a2.setDescription("最崇拜的明星Justin Timberlake");a2.setPicUrl("http://img3.douban.com/view/photo/photo/public/p1408738004.jpg");a2.setTitle("贾斯汀·汀布莱克(Justin Timberlake),1981年1月31日出生于美国田纳西州孟菲斯市，美国男歌手、演员、音乐制作人、主持人，前男子演唱组合超级男孩成员。");a2.setUrl("http://baike.haosou.com/doc/3382630-3560934.html?from=1358&sid=3560934&redirect=search");all.add(a2);String articleMsg=makeNewsCustomMessage("xxx", all);boolean res=sendCustomMessage(token,articleMsg);if(res){System.out.println("客服消息发送成功");}else{System.out.println("客服消息发送失败");}

到这里程序就写好了，来看下运行效果：

4  多客服的使用

多客服功能主要用于处理需人工操作、耗时较长的场景，我们都知道如果微信服务器在5秒钟没给用户返回消息则会出现“公众号暂时无法提供服务”。这样用户体验会很差，有这种情况不妨考虑下多客服。

下面是API:http://mp.weixin.qq.com/wiki/5/ae230189c9bd07a6b221f48619aeef35.html

个人建议是可以把多客服看成是一种比较特别的消息类型，这样的话只需修改一下MessageUtil就OK了，加入如下代码:

 /**      * 客服消息对象转换成xml      *       * @return xml      */      public static String customMessageToXml(CustomServiceMessage customServiceMessage) {              xstream.alias("xml", customServiceMessage.getClass());          return xstream.toXML(customServiceMessage);      }  

并且加一种消息类型：

    /**      * 多客服消息     */      public static final String TRANSFER_CUSTOMER_SERVICE = "transfer_customer_service";  

5  修改微信消息处理核心工具类

 // 文本消息   if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) {        String content=requestMap.get("Content");       if(content.startsWith("人工客服")){            CustomServiceMessage cus=new CustomServiceMessage();            cus.setToUserName(fromUserName);              cus.setFromUserName(toUserName);              cus.setCreateTime(new Date().getTime());              cus.setMsgType(MessageUtil.TRANSFER_CUSTOMER_SERVICE);              TransInfo t=new TransInfo();            t.setKfAccount("你的客服账号");            cus.setTransInfo(t);            respMessage=MessageUtil.customMessageToXml(cus);                    }else{            respContent = "您发送的是文本消息！";         }                }  

顺带贴上CustomServiceMessage和TransInfo的代码：

package com.debug.weixin.message.res;import com.debug.weixin.pojo.TransInfo;public class CustomServiceMessage extends BaseMessage {private TransInfo TransInfo;public TransInfo getTransInfo() {return TransInfo;}public void setTransInfo(TransInfo transInfo) {TransInfo = transInfo;}}

package com.debug.weixin.pojo;public class TransInfo {private String KfAccount;public String getKfAccount() {return KfAccount;}public void setKfAccount(String kfAccount) {KfAccount = kfAccount;}}

上面的代码如需测试需使用微信关注“多客服助手”或下载安装“windows多客服”，具体参照如下链接：

http://dkf.qq.com/

这里在贴2个我的运行截图：

下面是windows的客户端，就类似QQ的界面

差不多就这样子了