文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>云联络中心>SDK 开发指南>集成在线会话用户端 SDK>iOS

iOS

最近更新时间：2025-07-14 17:10:52

我的收藏

本页目录：

介绍

专为客服场景定制的 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 *> *)#>];
中国站
目录