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 5.0 (API level 21) 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).

 maven { 
     url 'https://maven.zohodl.com'
 }

​

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

Copied 
implementation 'com.zoho.salesiq:mobilisten:7.0.0'

​​

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() {
     MobilistenActivityLifecycleCallbacks.register(this);
     super.onCreate();
     
     InitConfig initConfig = new InitConfig();
     initConfig.setFont(Fonts.REGULAR, );

     ZohoSalesIQ.init(this, "appKey", "accessKey", initConfig, new InitListener() {
            @Override
            public void onInitSuccess() {
                ZohoSalesIQ.Launcher.show(ZohoSalesIQ.Launcher.VisibilityMode.ALWAYS);
            }

            @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 
android:name=".MyApplication"

 

Step 8: Permissions:

If you want your chatbot to be proactively triggered for your mobile app users after a specified duration (more than a second), add SCHEDULE_EXACT_ALARM permission in your AndroidManifest.xml. This ensures scheduling the bot trigger after the designated time. Even if your app is inactive, SalesIQ will post the trigger message as a notification for your app users. 

Note: 
To use the bot triggers in Android 12 & above, the SCHEDULE_EXACT_ALARM permission is mandatory.

Step 9: Proguard Configuration (Minifying App)

In some versions of the Android Gradle plugin, the R8 compiler exhibits aggressive behavior that removes some essential classes necessary for the SDK to function as expected. To handle this, we have added specific pro-guard rules within our Mobilisten SDK to preserve these crucial classes during the build process. If you encounter any instances where these pro-guard rules do not suffice, kindly reach us at (support@zohosalesiq.com).

Note: 
The pro-guard rules are available from version 6.0.1 and above.

Step 10: By default, if you wish to display the FAB/launcher on the application, 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!