tencent cloud

云联络中心

产品公告
产品动态
关于云联络中心术语更新
产品简介
产品概述
功能列表
名词介绍
应对防火墙限制相关
AI 专区
购买指南
语音通话计费概述
在线会话计费概述
查看账单
退费指引
新用户手册
语音通话指引
在线会话指引
场景用例
客服热线(呼入)
电话营销(呼出)
语音提醒(自动外呼)
集成用例(SDK)
管理员操作手册
语音通话分册
在线会话分册
工作台操作手册
语音通话分册
在线会话分册
AI 智能体操作手册
语音智能体介绍
语音智能体实践教程
新建语音智能体
实现智能体通话
查看智能体通话
开发操作手册
SDK 开发指南
数据推送
语音通话 API 文档
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
在线会话 API 文档
服务端 API
回调配置
常见问题
数据删除指引
相关协议
隐私政策
数据隐私和安全协议
服务等级协议
云联络中心用户协议
词汇表
联系我们

Android

PDF
聚焦模式
字号
最后更新时间: 2025-07-29 15:56:40

介绍

专为客服场景定制的 Customer UIKit,提供针对性强的用户侧客服会话界面,满足客服场景需求。UI、交互及功能体验,均面向智能客服场景设计。
此外,Customer UIKit 让集成客服模块省去集成 IM,只需要简短的若干行代码,即可完成开发。

前提条件

了解在线客服相关术语及相关配置,并已完成以下步骤:创建腾讯云 IM 应用、开通智能客服、登录客服管理端、获取客服号 ID,详情请参见 快速入门

环境与版本

Android Studio
Gradle-7.4.1
Android Gradle Plugin Version-7.0.1

功能展示



快速集成

步骤1: Maven 镜像设置

在项目的 setting.gradle dependencyResolutionManagement 中加入以下内容:
repositories {
google()
mavenCentral()
maven {
url 'https://mirrors.tencent.com/repository/maven/thirdparty/'
}
gradlePluginPortal()
}

步骤2: 引入 AI Desk 包

我们提供了两种方式来引入,如不需要修改源码可直接使用 Maven 镜像的方式引入,如果需要修改源码可用源码集成的方式。
Maven 镜像集成
源码方式集成
找到 app 的 build.gradle 文件,然后在 dependencies 中添加 AI TDesk SDK 的依赖。
implementation "com.tencentcloud.desk:aideskcustomer:$version"
// 最新版本version可在 https://central.sonatype.com/artifact/com.tencentcloud.desk/aideskcustomer/versions 查看
1. 下载 AI TDesk SDK 源码,把 aideskcustomer、deskchat、deskcommon、deskcontact、deskcore、deskcustomerserviceplugin 文件夹复制到你项目的根目录。
2. 修改在项目的 settings.gradle 文件,引入 AI TDesk SDK 相关代码。
// 集成智能客服相关代码
include ':deskcore'
include ':deskcommon'
include ':deskchat'
include ':deskcontact'
include ':deskcustomerserviceplugin'
include ':aideskcustomer'
3. 找到 app 的 build.gradle 文件,然后在 dependencies 中添加 AI TDesk SDK 的依赖。
implementation project(':aideskcustomer')

步骤3: 用户登录

TencentAiDeskCustomerLoginConfig config = new TencentAiDeskCustomerLoginConfig(); // config可选填
TencentAiDeskCustomer.getInstance().login(context, sdkAppID, userID, userSign, config, new TencentAiDeskCustomerLoginCallback() {
@Override
public void onSuccess() {
System.out.println("login success");
}

@Override
public void onError(int code, String desc) {
System.out.println("login failed"+code+","+desc);
}
});

步骤4: 打开新的客服聊天页

startActivity(TencentAiDeskCustomer.getInstance().getTencentCloudCustomerChatIntent(context));

高级用法

设置主题

TencentAiDeskCustomer.setTheme(TencentAiDeskCustomerThemeConfig.DARK);

设置显示人工服务按钮

// 设置为 true 后,只有没再人工服务状态就会显示,在人工服务后会自动隐藏。
// 设置为 false 后,永远不显示人工服务状态按钮
TencentAiDeskCustomer.getInstance().setShowHumanService(true);

设置快捷用语

LinkedList<TencentAiDeskCustomerQuickMessageInfo> quickMessages = new LinkedList<TencentAiDeskCustomerQuickMessageInfo>();// 详情见快捷用语类
TencentAiDeskCustomerQuickMessageInfo quickMsg = new TencentAiDeskCustomerQuickMessageInfo();
quickMsg.setContent("最新活动");
quickMsg.setOnItemClickListener(new TencentAiDeskCustomerQuickMessageOnClick() {
@Override
public void onItemClick(View view, int position, TencentAiDeskCustomerQuickMessageInfo data) {
// 点击后的响应事件
view.setVisibility(View.GONE);
}
});
quickMessages.add(quickMsg);
TencentAiDeskCustomer.getInstance().setQuickMessages(quickMessages);

设置携带商品信息

TencentAiDeskCustomerProductInfo info = new TencentAiDeskCustomerProductInfo(); // 详情见商品信息类
TencentAiDeskCustomer.getInstance().setProductInfo(info);

设置语言

如果您的 Desk 套餐支持多语言,UIKit 可以自动适配系统语言或使用您指定的语言。目前默认支持中文、英文和阿拉伯语。如需其他语言,请联系我们。
如果未指定语言,系统将默认使用系统语言。如果系统语言不受支持,则默认使用简体中文(适用于国内站)。具体支持的语言如下。
// 设置为英文,TencentAiDeskCustomerLanguageConfig.zh为中文。
TencentAiDeskCustomer.getInstance().setLanguage(v.getContext(), TencentAiDeskCustomerLanguageConfig.en);

其他

如果想要快速跑通 Demo,并想修改部分效果,可下载 DeskDemo以及源码

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈