Overview

​Zoho SalesIQ Mobile SDK (Mobilisten) allows you to extend the functionality of your application. With Mobilisten, you can view all your live app users in the SalesIQ dashboard, connect with your users via real-time chat, provide self-help tools, and much more. 

Note:
Zoho SalesIQ is GDPR Compliant! The configurations for the website and Mobile SDK remains the same. If you have already configured them for your brand, it will also be automatically reflected in Mobile SDK. If not, then learn how to configure it now.​

Installing live chat on your android mobile application

Requirements

The SDK supports Android 4.1 (API level 16) and above.

Installing Zoho SalesIQ SDK

Step 1: In the Zoho SalesIQ console, go to Settings > Brands > Brand name > Installation, and choose Android from the menu. 

Step 2: Then, enter your application ID and click Generate.

Step 3: Once the token is generated, you will find the unique app key and the access key provided for your application, which helps to authenticate your app with SalesIQ. Each app can have one app key and three active access key.

App Key
The App key is unique to each app; this key can't be regenerated.

Access Key
This key is the token to access the SalesIQ SDK on your application. Each application can have only three active access keys. When you generate the fourth access key, you will be prompted to delete an existing access key, or the fourth key will replace the oldest access key of the application.

You can associate the access key in each version of your application. If you wish to release a new application version, you can create a new access key and associate it with the application. The old version will also be accessible until you delete or disable the access key. This can help you to prevent the malfunctioning of the chat app from hackers.

Step 4: Add the following maven repository in the project root settings.gradle or build.gradle file (/build.gradle).

Copiedallprojects {
        repositories {
                 maven { url 'https://maven.zohodl.com'} 
                 } 
​}

​

Step 5: Add the following dependency in the app's build.gradle file (app/build.gradle).

Copieddependencies {
    implementation 'com.zoho.salesiq:mobilisten:4.2.9'
}

​​

Step 6: Then press Sync Now in the bar that appears in the IDE.

​

Step 7: Now, initialize the SDK by adding the following line in the onCreate() method of your application class. You will have to insert the app key and access key as mentioned below:

• If you don't override the Application class, you need to override it as follows.

Copied public class MyApplication extends Application {
@Override
public void onCreate() {
     super.onCreate();
     
     InitConfig initConfig = new InitConfig();
     initConfig.setFont(Fonts.REGULAR, );

     ZohoSalesIQ.init(this, "appKey", "accessKey", initConfig, new InitListener() {
            @Override
            public void onInitSuccess() {
                ZohoSalesIQ.showLauncher(true);
            }

            @Override
            public void onInitError(int errorCode, String errorMessage) {
                //your code
            }
     });
}
}

Note: Please use other APIs only after a successful callback from the init() method.

• Also, in the AndroidManifest.xml file, add the application class name in the <application> tag.

Copied<application  android:name=".MyApplication">
      ...
     </application>​

Step 8: By default, if you wish to display the FAB/launcher on the application, then use the ZohoSalesIQ.showLauncher(true) API. Or, you can make SalesIQ Mobilisten SDK blend with your application by creating a Custom UI and using the ZohoSalesIQ.Chat.show() API.

Download our sample app from the Google Play store today!