Introduction
Customer UIKit customized for customer service scenarios provides a specialized user-side customer service session interface to meet scenario requirements. The UI, interaction, and feature experience are all designed for Desk scenarios.
In addition, Customer UIKit eliminates the need for IM integration, requiring only a few lines of code to develop.
Prerequisite
Understand relevant terminology and configuration details for online customer service, and complete the following steps: create a Tencent Cloud IM application, enable Desk, log in to the customer service management console, and obtain the customer service account ID. For details, see Quick Start. Feature Demonstration
Quick Integration
Environment and Version
iOS version: iOS 13 or later.
Supports simulator debugging and real-device operation.
Demo Example
It is recommended to download and refer to the demo and its source code for the following steps, in conjunction with reading, so that access is better. CocoaPods Integration
Method 1: Pull Remote CocoaPods Integration
In the XCode project, integrate TencentCloudAIDeskCustomer via Cocoapods.
In the Podfile, add the following example code:
target 'MyApp' do
pod 'TencentCloudAIDeskCustomer'
end
Method 2: DevelopPods Source Code Integration (Recommended for Source Code Modification)
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
Logging in and Initialization
Call the loginWithSdkAppID method to complete UIKit login, then call setCustomerServiceUserID to set the UserID for online customer service. Sample code:
#import "TencentCloudAIDeskCustomer/TencentCloudCustomerManager.h"
- (void)login:(NSString *)userID userSig:(NSString *)sig {
[[TencentCloudCustomerManager sharedManager] loginWithSdkAppID:"SDKAppID of the app" userID:"UserID of the current logged-in user" userSig:"UserSig of the current logged-in user" completion:^(NSError *error) {
if (error.code == 0) {
// If the default customer service account ID is not modified, there is no need to call the function. It can be obtained from the Desk homepage: https://desk.qcloud.com/ // [[TencentCloudCustomerManager sharedManager] setCustomerServiceUserID: "@customer_service_account"];
} else {
NSLog(@"login failed");
}
}];
}
SDKAppID information can be obtained in the IM console by clicking Application Management > Create New Application, and choosing Customer Service Desk > Smart Customer Service, then enable smart customer service. userID information. A random string can be locally generated, such as test-1234.
Opening the Customer Service Chat Page
Call the pushToCustomerServiceViewControllerFromController method to navigate to the customer service chat page.
#import <TencentCloudAIDeskCustomer/TencentCloudCustomerManager.h>
[[TencentCloudCustomerManager sharedManager] pushToCustomerServiceViewControllerFromController:self];
The online customer service function is now integrated on iOS.
Advanced Usage
If more advanced capabilities are needed, refer to the following advanced API capability.
Setting Quick Phrases
Set quick phrases above the input box.
[[TencentCloudCustomerManager sharedManager] setQuickMessages:<#(NSArray<TUICustomerServicePluginMenuCellData *> *)#>];