JAVA微信公众号开发第4篇将用户消息转发到多客服

说明

微信公众平台多客服功能如何使用

将用户消息转发至客服开发步骤
描述

消息转发到多客服
当用户输入关键词人工客服时进行消息转发

生成转发报文

将报文返回至微信公众平台

说明

本文主要针对博主JAVA微信公众号客服图文消息一文做补充

微信公众平台多客服功能如何使用

获得多客服使用权限

认证的微信服务号可以在 “公众平台-功能-添加功能插件” 看到 “多客服” 申请入口，申请开通即可。


]

客服功能使用



微信公众平台客服PC版

登陆地址请“点我”

将用户消息转发至客服开发步骤

描述

如果公众号处于开发模式，普通微信用户向公众号发消息时，微信服务器会先将消息POST到开发者填写的url上，如果希望将消息转发到多客服系统，则需要开发者在响应包中返回MsgType为transfer_customer_service的消息，微信服务器收到响应后会把当次发送的消息转发至多客服系统。

消息被转发到多客服以后，会被自动分配给一个在线的客服帐号，您也可以在返回transfer_customer_service消息时，在XML中附上TransInfo信息指定分配给某个客服帐号。

用户被客服接入以后，客服关闭会话以前，处于会话过程中时，用户发送的消息均会被直接转发至客服系统。当会话超过2小时客服没有关闭时，微信服务器会自动停止转发至多客服，而将消息恢复发送至开发者填写的url上。用户在等待队列中时，用户发送的消息仍然会被推送至开发者填写的url上。

消息转发到多客服

当用户输入关键词【人工客服】时进行消息转发

/**
* <p>Title: getText</p>
* <p>Description: 文本消息</p>
* @param wxMessage
* @param context
* @param iService
* @return
*/
private WxXmlOutMessage getText(WxXmlMessage wxMessage, Map<String, Object> context, IService iService){
if("人工客服".equals(wxMessage.getContent())){
//转至
return WxXmlOutMessage.TEXT().content(wxMessage.getContent()).toUser(wxMessage.getFromUserName()).fromUser(wxMessage.getToUserName()).buildKf();
}
return WxXmlOutMessage.TEXT().content("您好！如有问题，请输入【人工客服】寻求帮助。").toUser(wxMessage.getFromUserName()).fromUser(wxMessage.getToUserName()).build();
}

生成转发报文

返回消息模型WxXmlOutMessage.java

@XStreamAlias("ToUserName")
@XStreamConverter(value = XStreamCDataConverter.class)
protected String toUserName;

@XStreamAlias("FromUserName")
@XStreamConverter(value = XStreamCDataConverter.class)
protected String fromUserName;

@XStreamAlias("CreateTime")
protected Long createTime;

@XStreamAlias("MsgType")
@XStreamConverter(value = XStreamCDataConverter.class)
protected String msgType;

public String getToUserName() {
return toUserName;
}

public void setToUserName(String toUserName) {
this.toUserName = toUserName;
}

public String getFromUserName() {
return fromUserName;
}

public void setFromUserName(String fromUserName) {
this.fromUserName = fromUserName;
}

public Long getCreateTime() {
return createTime;
}

public void setCreateTime(Long createTime) {
this.createTime = createTime;
}

public String getMsgType() {
return msgType;
}

public void setMsgType(String msgType) {
this.msgType = msgType;
}

public String toXml() {
return XStreamTransformer.toXml((Class) this.getClass(), this);
}
/**
* 获得文本消息builder
*
* @return
*/
public static TextBuilder TEXT() {
return new TextBuilder();
}

获得文本消息Builder

CDATA 转换器XStreamCDataConverter.java

package com.bigbigbu.wx.tools.util.xml;

import com.thoughtworks.xstream.converters.basic.StringConverter;

/**
* CDATA 转换器
* @author FANQIBU
*
*/
public class XStreamCDataConverter extends StringConverter {

@Override
public String toString(Object obj) {
return "<![CDATA[" + super.toString(obj) + "]]>";
}

}

– 获得文本消息TextBuilder.java

package com.bigbigbu.wx.tools.bean.outxmlbuilder;

import com.bigbigbu.wx.tools.bean.WxXmlMessage.WxKf;
import com.bigbigbu.wx.tools.bean.WxXmlOutTextMessage;

/**
* @ClassName: TextBuilder
* @Description: TODO 文本消息builder
* @author FANQIBU修改于 2017年12月12日 下午4:16:14  （ps:增加构建客服消息）
* @date 2017年12月12日 下午4:16:14
*
*/
public final class TextBuilder extends BaseBuilder<TextBuilder, WxXmlOutTextMessage> {
private String content;
private WxKf wxKf=null;

public TextBuilder content(String content) {
this.content = content;
return this;
}

public TextBuilder kfAccount(String kfAccount) {
this.wxKf = new WxKf();
this.wxKf.setKfAccount(kfAccount);
return this;
}

public WxXmlOutTextMessage build() {
WxXmlOutTextMessage m = new WxXmlOutTextMessage();
setCommon(m);
m.setContent(this.content);
return m;
}

public WxXmlOutTextMessage buildKf() {
WxXmlOutTextMessage m = new WxXmlOutTextMessage();
setCommon(m);
m.setContent(this.content);
m.setMsgType("transfer_customer_service");
if(wxKf != null){
m.setWxKf(wxKf);
}
return m;
}
}

–BaseBuilder.java

package com.bigbigbu.wx.tools.bean.outxmlbuilder;

import com.bigbigbu.wx.tools.bean.WxXmlOutMessage;

public abstract class BaseBuilder<BuilderType, ValueType> {

protected String toUserName;

protected String fromUserName;

public BuilderType toUser(String touser) {
this.toUserName = touser;
return (BuilderType) this;
}

public BuilderType fromUser(String fromusername) {
this.fromUserName = fromusername;
return (BuilderType) this;
}

public abstract ValueType build();

public void setCommon(WxXmlOutMessage m) {
m.setToUserName(this.toUserName);
m.setFromUserName(this.fromUserName);
m.setCreateTime(System.currentTimeMillis() / 1000l);
}

}

将报文返回至微信公众平台

// 把消息传递给路由器进行处理
WxXmlOutMessage xmlOutMsg = router.route(wx);
if (xmlOutMsg != null)
out.print(xmlOutMsg.toXml());// 因为是明文，所以不用加密，直接返回给用户。