|  开放平台
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)

参数说明:

参数名描述
contextandroid上下文(请使用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
人工提醒话术设置

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

人工提醒话术设置