Skip to main content

iOS Customer Service SDK Integration Instructions

The ZhiChi Customer Service SDK provides the ability for APPs to access customer service reception. By simply embedding it, you can monitor and handle customer inquiries in real time. It enables online customer reception on mobile devices without downloading the ZhiChi APP. Online Customer Service SDK has the following features:
  • Online consultation: Customer service and users chat in real time. They can send and receive messages such as pictures, videos, and emojis.
  • Focus on users, provide smart replies, quick replies, session summaries, and invite users to leave feedback.
  • Highly customizable UI.
Relevant Restrictions and Precautions:
  1. The new version of the iOS SDK supports iOS 11 and above.
  2. IOS currently only supports hyperlinks. It does not recognize other HTML tags and attributes.
  3. IOS requires permission for the microphone, camera, and photo library. Otherwise, some features will not work.

Process Description

Integration Process Diagram

Image

File Description

The SDK includes (SobotOnline.framework and SobotOnline.bundle), SobotDemo, and Doc-related documentation.

Permission Description

Permissions required to use the online customer service SDK:

Integration Method

Manual Integration

Download link: Download and unzip iOS_OnlineSDK, then add the necessary files SobotOnline.framework and SobotOnline.bundle to your project.

CocoaPods Integration

Integrate the code by adding it to the podfile:
If the library cannot be found, clear the pod cache:

Quick Start

Step 1 Domain Settings

[Note: To obtain appid and app_key, please contact the Zhichi after-sales team; if you use the token method to access, refer to the API documentation Get token.] Domain Name Description:       * The default SaaS platform domain is: https://api.sobot.com.       * If you are a Tencent Cloud service, set it to: https://ten.sobot.com.       * If you are using a localized deployment, please use your own service domain name.

Step 2 Initialize SDK

Method 1: Initialize the SDK using appid and appkey. Example code:
Method 2: Directly initialize the SDK using a token.

Step 3 Launch Page

For details, see the Demo call code. The main call code is as follows: [Note: Before launching the page, you must call the initialization interface initWithAppid. Otherwise, it cannot be started.] Interface:
Parameter: Example code:

Function Description

1. Resource Allocation

Optional. The default value is as follows. You can customize the resource library.

2. Log in

Silent online customer service, after login, if the customer service is online, can receive real-time message monitoring.

3. Log Out

Take the current customer service offline.
      

4. Get Unread Messages

Get the total number of current unread messages. Local messages will be cleared after re-login.

5. Set Up Message Listening

You can choose either the proxy method or the block method to listen.

6. Function Configuration

Configure some features in attribute mode, such as configuring color and feature development. Not yet in use. For example (whether to automatically remind):

Source Code and Demo

Click to download Demo source code; Click to view Demo usage tutorial

Update Notes

SDK Update Notes

Privacy and Permissions

《ZhiChi Technology SDK Personal Information Collection and Usage Statement》