文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>即时通信 IM>智能客服（Desk）>用户端 SDK 轻量接入>Android

Android

最近更新时间：2025-05-19 15:14:42

我的收藏

本页目录：

介绍

专为客服场景定制的 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 后，只有没再人工服务状态就会显示，在人工服务后会自动隐藏。
// 设置为 true 后，永远不显示人工服务状态按钮
TencentAiDeskCustomer.getInstance().setShowHumanService(true);

设置快捷用语

LinkedList<TencentAiDeskCustomerQuickMessageInfo> quickMessages = new LinkedList<TencentAiDeskCustomerQuickMessageInfo>();// 详情见快捷用语类
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以及源码。

交流与反馈

点此进入 IM 社群，享有专业工程师的支持，解决您的难题。
中国站
目录