产品公告

产品动态

关于云联络中心术语更新

产品简介

产品概述

功能列表

名词介绍

应对防火墙限制相关

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

回调配置

常见问题

数据删除指引

iOS

PDF

聚焦模式

字号

最后更新时间： 2025-07-29 15:56:06

介绍
专为客服场景定制的 Customer UIKit，提供针对性强的用户侧客服会话界面，满足客服场景需求。UI、交互及功能体验，均面向智能客服场景设计。
此外, Customer UIKit 让集成客服模块省去集成 IM，只需要简短的若干行代码，即可完成开发。
前提条件
了解在线客服相关术语及相关配置，并已完成以下步骤：创建腾讯云 IM 应用、开通智能客服、登录客服管理端、获取客服号 ID，详情请参见 快速入门。
功能展示
﻿
﻿
﻿
﻿
﻿
﻿
﻿
快速集成
环境与版本
iOS 版本: iOS 13 以上。
支持模拟器调试及真机运行。
Demo 示例
建议您下载并参考下列步骤的 demo 及其源码，配合阅读，以便更好的接入。
CocoaPods 集成
方式1：拉取远程 CocoaPods 集成
在 XCode 工程中, 通过 Cocoapods 集成 TencentCloudAIDeskCustomer。
在 Podfile 中, 添加如下示例代码：
target 'MyApp' do  
    pod 'TencentCloudAIDeskCustomer'
end
方式2：DevelopPods 源码集成（有源码修改时推荐）
从 GitHub 下载 TencentCloudAIDeskCustomer-iOS 、TDeskCustomerServicePlugin、TDeskChat、TDeskCommon、TDeskCore 。直接拖入您的工程目录下: TDesk。
target 'MyApp' do  
    pod 'TencentCloudAIDeskCustomer', :path => "../TDesk/TencentCloudAIDeskCustomer-iOS"
    pod 'TDeskCustomerServicePlugin', :path => "../TDesk/TDeskCustomerServicePlugin"
    pod 'TDeskChat', :path => "../TDesk/TDeskChat"
    pod 'TDeskCommon', :path => "../TDesk/TDeskCommon"
    pod 'TDeskCore', :path => "../TDesk/TDeskCore"
end
登录与初始化
调用 loginWithSdkAppID 方法完成 UIKit 登录，并调用 setCustomerServiceUserID 设置在线客服的 UserID，示例代码如下：
#import "TencentCloudAIDeskCustomer/TencentCloudCustomerManager.h"
﻿
- (void)login:(NSString *)userID userSig:(NSString *)sig {
    [[TencentCloudCustomerManager sharedManager] loginWithSdkAppID:"应用的 SDKAppID" userID:"当前登录用户的UserID" userSig:"当前登录用户的UserSig" completion:^(NSError *error) {
      if (error.code == 0) {
        // 如果没有修改默认的客服号 ID 就不需要调用该函数。可从智能客服管理端首页查看: https://desk.qcloud.com/﻿
        // [[TencentCloudCustomerManager sharedManager] setCustomerServiceUserID: "@customer_service_account"];
      } else {
        NSLog(@"登录失败");
      }
    }];
}
SDKAppID 信息，可在 即时通信 IM 控制台 单击应用管理 > 创建新应用，并选择客服服务 Desk > 智能客服， 开通智能客服 后获取。
﻿
﻿
userID 信息，可本地生成一个随机的字符串，例如 test-1234。
userSig 信息，可单击 即时通信 IM 控制台 > UserSig生成校验，填写创建的 userID，即可生成 userSig。
﻿
打开客服聊天页
调用 pushToCustomerServiceViewControllerFromController 方法，跳转至客服聊天页面。
#import <TencentCloudAIDeskCustomer/TencentCloudCustomerManager.h>
// 一定要确保已经登录成功了，否则直接跳转过去就是空白
[[TencentCloudCustomerManager sharedManager] pushToCustomerServiceViewControllerFromController:self];
至此，在线客服功能在 iOS 端集成完成。
高级用法
如果需要更多高级能力，可参考使用以下高级 API 能力。
设置快捷用语
设置输入框上部快捷用语。
[[TencentCloudCustomerManager sharedManager] setQuickMessages:<#(NSArray<TUICustomerServicePluginMenuCellData *> *)#>];