5分钟集成在线客服
准备工作
到萝卜丝官网注册管理员账号,并登录管理后台。
到 所有设置->应用管理->App 添加应用,填写相关信息之后点击确定,在生成记录中可见appkey,后面会用到。
到 所有设置->客服管理->客服账号 添加客服账号。注意:生成记录中有一列 ‘唯一ID(uid)’ 会在指定客服接口中使用
到 所有设置->客服管理->技能组 添加技能组,并可将客服账号添加到相关技能组。注意:生成记录中有一列 ‘唯一ID(wId)’ 会在工作组会话中用到
开始集成
第一步:在项目build.gradle的 allprojects -> repositories 添加
maven {
url "https://dl.bintray.com/jackning/maven"
}
修改完后,效果如下:
allprojects {
repositories {
jcenter()
google()
maven {
url "https://dl.bintray.com/jackning/maven"
}
}
}
第二步:在module的build.gradle android{}添加
android {
...
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
...
}
第三步:在module的build.gradle dependencies{}添加
// 萝卜丝第三步
// 加载萝卜丝核心库
implementation 'com.bytedesk:core:2.0.2'
// 加载萝卜丝默认UI库
implementation 'com.bytedesk:ui:2.0.2'
// 腾讯QMUI界面库
// http://qmuiteam.com/android/page/start.html
// https://bintray.com/chanthuang/qmuirepo
implementation 'com.qmuiteam:qmui:1.4.0'
第四步:AndroidManifest.xml添加权限
第五步:AndroidManifest.xml添加Activity和Service
android:name="com.bytedesk.ui.activity.ChatKFActivity"
android:screenOrientation="portrait"
android:theme="@style/AppTheme.ByteDesk"/>
第六步:在样式文件styles.xml中添加
@style/ByteDeskTopBar
@color/app_color_blue
@color/qmui_config_color_white
@color/qmui_config_color_white
@color/qmui_config_color_white
48dp
48dp
第七部:初始化UI和建立长连接
参考demo中MainActivity.java
// 初始化萝卜丝UI界面库
BDUiApi.init(this);
// 具体代码请参考MainActivity.java
anonymousLogin();
第八步:开始客服会话
// 打开客服对话界面
BDUiApi.startWorkGroupChatActivity(context, wId, "工作组客服");
集成完毕