Installing Live Chat on your iOS Mobile Application

Overview

ZohoSalesIQ Mobile SDK lets you embed tracking and live chat into your existing mobile application. This enables your users to quickly converse with your support team incase help is needed and helps you make the support experience seamless. The SalesIQ Mobile SDK comes with a feature-rich set of APIs which allows you to do a seamless integration with your application. You may check the API Reference section for more information on the available APIs

Note:
Zoho SalesIQ is GDPR Compliant! The configurations for the website and Mobile SDK remain the same. If you have already configured it on your site, it will be automatically reflected in the Mobile SDK as well. If not, then learn how to configure now.

Installing Live Chat on your iOS Mobile Application

You can install the ZohoSalesIQ Mobilisten SDK either using Cocoapods or by doing a manual installation using the Mobilisten Framework file

Requirements

The minimum deployment target for the application must be iOS 10.0 or higher. Xcode 11.4 and higher is required for the development environment.

How to Embed the SDK into Your Mobile Application?

Install using Cocoapods:

Step 1: To add ZohoSalesIQ SDK to your app, you should add Mobilisten pod to the podfile.

Copied source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'

target 'Project Target' do
     use_frameworks!
     pod 'Mobilisten'end

Mobilisten Compatibility Matrix:

Step 2: Once the required pods are added, open the terminal and run the following command from terminal

Copied pod repo update && pod install

Note:If you do not have a Podfile in your project directory or do not use Cocoapods, you can run the pod init command from the projects directory. This will create a new Podfile

Install Manually:

Step 1: In Project settings, under the General Tab, Under the Frameworks, Libraries, and Embedded Content section (or) Embedded Binaries(in older Xcode versions), Click the (+) button to add a new framework/xcframework.

Step 2: Click Add Other in the Choose frameworks and libraries to add option and click Add Files.. in the Choose frameworks or libraries to add menu.

Step 3: Select the Mobilisten.framework (or) Mobilisten.xcframework file to include the Mobilisten framework in your project. Once included, make sure you have selected Embed & Sign for the framework. Select Copy items if needed and if prompted in Destination.

Step 4: Link libicucore.tbd and libicucore.A.tbd

Step 5:If your project is a pure Objective-C project, Set Always Embed Swift Standard Libraries under Build Settings to YES

Step 6: Update Info.plist. Update the Info.plist file to include the below permissions for the application.

Step 7: After successful installation, import Mobilisten to your project

For Swift:

Copied import Mobilisten

For Objective-C:

Copied #import <Mobilisten/Mobilisten.h>

Step 8:  Initialize the SDK with the App key and Access keys for the bundle ID. The code will look as follows when the App key and Access key is inserted:

How to get the app and access key?

• In SalesIQ dashboard, navigate to Settings > Brands > {Your brand} > Installation > iOS. 
• Now, you can find the App and Access key below the Register app section. Copy the codes and paste them in the required places.

For Swift:

Copied ZohoSalesIQ.initWithAppKey(APP KEY, accessKey:  ACCESS KEY) { (completed) in }

For Objective-C:

Copied [ZohoSalesIQ initWithAppKey:APP KEY accessKey:ACCESS KEY completion:^(BOOL completed) { }];

Example on how to insert the code on your application:

Copied func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool
  {
     ZohoSalesIQ.initWithAppKey("Jve9A%2FFqxjnTjfT7YjHr3zKHoj4Prq6wXRmnJ", accessKey:"0Al2AB7GufM9S3GJmV1uUGGcony166WluKrtkzGYsozC0GsEEigVEDzfPtmmM0N8X")
      return true
  }

Note:
By default, if you wish to display the Mobilisten Launcher/Chat Button in your application, then you can use the ZohoSalesIQ.showLauncher(true) API

Once the code is embedded, you can view the Launcher on your application.