|  开放平台
安卓版
1
为企业手机APP添加在线客服功能

复制链接地址 > 粘贴至企业APP代码中 > 完成

1.下载安卓SDK包。说明:SDK是aar格式的压缩包,请在android studio环境使用。开发所用版本为android studio 1.5 Build 141.2422023

为企业手机APP添加在线客服功能

2.将aar为后缀名的压缩包放在您的项目的libs文件目录下:

为企业手机APP添加在线客服功能

3.在你app所在module的build.gradle中找到android结构,并在其中添加如下代码:

repositories {
flatDir {dirs 'libs'}
}

4.在dependencies结构中添加如下代码:

compile (name :"zikersdk ",ext:"aar")

完整的gradle文件代码参考如下:

apply plugin: 'com.android.application'
android {
  compileSdkVersion 23
  buildToolsVersion "23.0.3"
defaultConfig {
  applicationId "com.androd.zikerapp"
  minSdkVersion 17
  targetSdkVersion 23
  versionCode 1
  versionName "1.0"
  }
buildTypes {
  release {
  minifyEnabled false
   proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
  }
repositories {
  flatDir {
    dirs 'libs'}
    }
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:23.1.1'
compile 'com.android.support:design:23.1.1'
compile (name :"zikersdk",ext:"aar")  [添加代码]
}

5.编译一下,如果在您的 /build/intermediates/exploded-aar中出现了相关内容,则表示添加成功。如图所示:

为企业手机APP添加在线客服功能

初始化SDK API:

请将如下方法放在application的onCreate()方法中:

InitSDK.getInstance().init (Context context, Config config, String eid, String appId)

参数说明:

参数名 描述
context android上下文(请使用application)
Config 头像配置类型,包括prd,test和ci,其中prd为生产环境,test为测试环境,ci为开发环境
eid 企业id,请到平安客服云官网申请
appId 应用id,请到平安客服云官网申请

7.请在需要跳转到在线客服的页面中,找到触发跳转的intent,添加ZikerExtraInfo实体,跳转到的activity名字为ZikerSdkChatActivity,key为“zikerExtraInfo”

参考代码:

Button fab = (Button) findViewById(R.id.fab);
fab.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
//在页面跳转时,请给ZikerExtraInfo的成员赋值并传到ZikerSdkChatActivity.class
//其中cid为必传
ZikerExtraInfo zikerExtraInfo = new ZikerExtraInfo();
zikerExtraInfo.cid = "c123123";
Intent intent = new Intent(MainActivity.this, ZikerSdkChatActivity.class);
intent.putExtra("zikerExtraInfo", zikerExtraInfo);
startActivity(intent);
}
});

ZikerExtraInfo 字段说明:

参数名 描述 是否必填
cid 企业识别客户的唯一id 是(若无,请传””)
headimgurl 头像
nickname 昵称
sex 性别(F/M)
mail 邮箱
tel 电话
msgInfo 自定义客户进线提示

坐席工作台上相应看到的内容如下图:

客服看到在线客户信息页面展示

8.接收未读消息:

在主线程中放入如下方法:

MessageManager.getInstance().notification (MessageManager.OnNotifyListener listener)

PS:请在onRestart()中也添加此方法,保证消息的正常接收。

参数说明:listener :消息通知的回调。

API说明:会在回调中将未读消息以list<String<的形式返回,所有的消息均为未读消息。消息个数即为list.size()。 回调运行在主线程。

2
企业的客户在APP请求在线客服服务

点击在线客服入口 > 进行聊天沟通

点击在线客服入口 手机在线客服聊天效果
3
人工提醒话术设置

设置人工欢迎话术/全忙提醒话术/非工作时间及提醒话术 > 保存发布

人工提醒话术设置