Android应用客服系统解决方案---网易七鱼客服
应用客服系统
现在好多应用都有客服系统需求，常见问题可以通过智能客服解决，疑难问题可以联系人工客服实时解答。比较常见的购物应用的客服功能。
七鱼客服
七鱼 Android SDK Github
网易七鱼 Android SDK 开发指南
七鱼SDK接入
1.添加依赖
// 最新版本可参考 Download 徽章后对应的数值
compile 'com.qiyukf.unicorn:unicorn:+'
2.初始化七鱼客服
在Application 中初始化，初始化时最好将YSFOptions 提取出来，便于后面根据需要修改七鱼的配置。
public class MyApplication extends Application {
/**
* 网易七鱼客服
* 这里将YSFOptions提取出来是为了便于后面对七鱼配置的修改
*/
public static YSFOptions ysfOptions;
@Override
public void onCreate() {
super.onCreate();
//网易七鱼客服
Unicorn.init(this, "appKey", options(), new GlideImageLoader(this));
}
/**
* 网易七鱼客服
*
* @return
*/
private YSFOptions options() {
YSFOptions options = new YSFOptions();
/**
* 客服消息通知
*/
options.statusBarNotificationConfig = new StatusBarNotificationConfig();
options.statusBarNotificationConfig.notificationSmallIconId = R.mipmap.ic_launcher;
options.onBotEventListener = new OnBotEventListener() {
@Override
public boolean onUrlClick(Context context, String url) {
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
context.startActivity(intent);
return true;
}
};
ysfOptions = options;
return options;
}
}
我这里图片加载用的是Glide，所以配置的是Glide，使用其他图片加载框架的参考官方API中图片加载
public class GlideImageLoader implements UnicornImageLoader {
private Context context;
public GlideImageLoader(Context context) {
this.context = context.getApplicationContext();
}
@Nullable
@Override
public Bitmap loadImageSync(String uri, int width, int height) {
return null;
}
@Override
public void loadImage(String uri, int width, int height, final ImageLoaderListener listener) {
if (width <= 0 || height <= 0) {
width = height = Integer.MIN_VALUE;
}
Glide.with(context).load(uri).asBitmap().into(new SimpleTarget<Bitmap>(width, height) {
@Override
public void onResourceReady(Bitmap resource, GlideAnimation<? super Bitmap> glideAnimation) {
if (listener != null) {
listener.onLoadComplete(resource);
}
}
@Override
public void onLoadFailed(Exception e, Drawable errorDrawable) {
if (listener != null) {
listener.onLoadFailed(e);
}
}
});
}
}
3.设置当前访问用户的信息
为了便于管理用户，可设置访问用户的信息
YSFUserInfo userInfo = new YSFUserInfo();
// App 的用户 ID
userInfo.userId = "用户ID";
// CRM 扩展字段
userInfo.data = userInfoData("用户名字", "用户手机号", "用户头像");
Unicorn.setUserInfo(userInfo);
4.设置未读消息监听
在进入客服对话页面之前，我们可以先设置一个入口，入口处可展示未读消息数目和最近一条消息内容。
Unicorn.addUnreadCountChangeListener(new UnreadCountChangeListener() {
@Override
public void onUnreadCountChange(int count) {
// count 为当前未读数，
// custNoReadCount = count;
/**
* 获取和客服的最后一条聊天消息内容。
* 可用于未读消息变化时，展示最后一条未读消息，或者展示客服的最后一条消息。
* @return 最后一条消息
*/
List<Session> sessionList = UnicornManager.getSessionList();
if (sessionList != null && sessionList.size() > 0) {
Session message = sessionList.get(0);
if (message != null && !TextUtils.isEmpty(message.getContent())) {
tvMsg.setText(message.getContent());
} else {
tvMsg.setText("暂无消息");
}
}
}
},true);
/**
* 构造用户信息
*
* @param name 名字
* @param mobile 手机
* @param avatar 头像
* @return
*/
private static String userInfoData(String name, String mobile, String avatar) {
List<YSFUser> mListUser = new ArrayList<>();
YSFUser rName = new YSFUser("real_name", name);
YSFUser rMoblie = new YSFUser("mobile_phone", mobile);
YSFUser rAvatar = new YSFUser("avatar", avatar);
mListUser.add(rName);
mListUser.add(rMoblie);
mListUser.add(rAvatar);
return new Gson().toJson(mListUser);
}
/**
* 七鱼用户信息
*/
public class YSFUser {
String key;
String value;
public YSFUser(String key, String value) {
this.key = key;
this.value = value;
}
public String getKey() {
return key;
}
public void setKey(String key) {
this.key = key;
}
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
}
注：官方API中获取最后一条方法为
Unicorn.queryLastMessage();,但我在使用时发现了一个问题，这个方法只能获取用户和人工客服的最后一条消息，智能客服的消息获取不到；所以我使用的是获取会话列表的方法，然后取出列表中的第一条消息，即最新一条消息。
5.进入客服对话页面
客服入口设置完成之后，先对客服的一些配置进行修改
MyApplication.ysfOptions.uiCustomization = uiCustomization();
/**
* 设置对话UI（七鱼客服）
*
* @return
*/
private static UICustomization uiCustomization() {
// 以下示例的图片均无版权，请勿使用
UICustomization customization = new UICustomization();
//客服窗口UI自定义
customization = new UICustomization();
//标题栏背景颜色
customization.titleBackgroundResId = R.color.colorPrimary;
//标题栏风格，影响标题和标题栏上按钮的颜色(0浅色系，1深色系)
customization.titleBarStyle = 1;
//键盘控制
customization.hideKeyboardOnEnterConsult = true;
//输入框内字体颜色（一定要设置这个属性，有的手机上不设置此属性会出现输入的字体色是透明的）
customization.inputTextColor = MyApplication.getContext().getResources().getColor(R.color.base_text);
//访问者头像
customization.rightAvatar = "";
//客服头像
// customization.leftAvatar = url;
return customization;
}
注：设置对话页面UI时，一定要设置
inputTextColor这个属性是对话输入框中的字体颜色；我在使用过程中遇到过一个问题，有些手机的输入框内的字体是白色的，导致我一直以为无法输入，后来才发现字体是白色的。
6.其他方法
- 当用户退出登录时，也需要将七鱼注销
Unicorn.logout();
- 有些应用会涉及到清除应用缓存，七鱼也提供了清除缓存的方法
Unicorn.clearCache();
结束语
文章只讲述了一些常用方法，更多详细的功能使用可参考官方API，为了便于使用，我将这些常用方法整理成一个管理工具类
public class UnicornManager {
/**
* 进入智能客服页面
*
* @param context
*/
public static void inToUnicorn(Context context) {
/**
* 设置访客来源，标识访客是从哪个页面发起咨询的，用于客服了解用户是从什么页面进入。
* 三个参数分别为：来源页面的url，来源页面标题，来源页面额外信息（保留字段，暂时无用）。
* 设置来源后，在客服会话界面的"用户资料"栏的页面项，可以看到这里设置的值。
*/
ConsultSource source = new ConsultSource(null, null, null);
// source.prompt = "连接客服成功的提示语";
// source.VIPStaffAvatarUrl = "头像的 url";
// source.vipStaffName = "客服的的名字";
// source.vipStaffWelcomeMsg = "客服的欢迎语";
/**
* 请注意： 调用该接口前，应先检查Unicorn.isServiceAvailable()，
* 如果返回为false，该接口不会有任何动作
*
* @param context 上下文
* @param title 聊天窗口的标题
* @param source 咨询的发起来源，包括发起咨询的url，title，描述信息等
*/
String title = "七鱼客服";
Unicorn.openServiceActivity(context, title, source);
}
/**
* 设置设置对话UI
*/
public static void setUiCustomization() {
MyApplication.ysfOptions.uiCustomization = uiCustomization();
}
/**
* 设置对话UI（七鱼客服）
*
* @return
*/
private static UICustomization uiCustomization() {
// 以下示例的图片均无版权，请勿使用
UICustomization customization = new UICustomization();
//客服窗口UI自定义
customization = new UICustomization();
//标题栏背景颜色
customization.titleBackgroundResId = R.color.colorPrimary;
//标题栏风格，影响标题和标题栏上按钮的颜色(0浅色系，1深色系)
customization.titleBarStyle = 1;
//键盘控制
customization.hideKeyboardOnEnterConsult = true;
//输入框内字体颜色（一定要设置这个属性，有的手机上不设置此属性会出现输入的字体色是透明的）
customization.inputTextColor = MyApplication.getContext().getResources().getColor(R.color.base_text);
//访问者头像
customization.rightAvatar = "";
//客服头像
// customization.leftAvatar = url;
return customization;
}
/**
* 设置用户信息(七鱼客服)
*/
public static void setUnicornUserInfo() {
YSFUserInfo userInfo = new YSFUserInfo();
// App 的用户 ID
userInfo.userId = "用户ID";
// CRM 扩展字段
userInfo.data = userInfoData("用户名字", "用户手机号", "用户头像");
Unicorn.setUserInfo(userInfo);
}
/**
* 构造用户信息
*
* @param name 名字
* @param mobile 手机
* @param avatar 头像
* @return
*/
private static String userInfoData(String name, String mobile, String avatar) {
List<YSFUser> mListUser = new ArrayList<>();
YSFUser rName = new YSFUser("real_name", name);
YSFUser rMoblie = new YSFUser("mobile_phone", mobile);
YSFUser rAvatar = new YSFUser("avatar", avatar);
mListUser.add(rName);
mListUser.add(rMoblie);
mListUser.add(rAvatar);
return new Gson().toJson(mListUser);
}
/**
* 客服未读消息数变化监听
*
* @param listener
*/
public static void addUnreadCountChangeListener(final UnreadCountChangeListener listener) {
Unicorn.addUnreadCountChangeListener(listener, true);
}
/**
* 获取最后一条消息
*/
public static UnicornMessage queryLastMessage() {
UnicornMessage message = Unicorn.queryLastMessage();
return message;
}
/**
* 获取客服与商家消息列表
*/
public static List<Session> getSessionList() {
List<Session> sessionList = POPManager.getSessionList();
return sessionList;
}
/**
* 网易七鱼客服
* 清除文件缓存，将删除SDK接收过的所有文件。
* 建议在工作线程中执行该操作。
* 该操作放到设置中 清除缓存操作下
*/
public static void clearCache() {
Unicorn.clearCache();
}
/**
* 注销网易七鱼客服
*/
public static void logout() {
Unicorn.logout();
}
}
demo地址