Android Mobile SDK Guide

Mobilisten is Zoho SalesIQ's mobile SDK, letting you embed live chat, voice calls, and visitor tracking directly inside your Android app.

Requirements

A Compile SDK Version of 34 (Android 14) and the INTERNET permission are required.

Step 1: Add the Zoho Maven repository

The exact file depends on your Gradle version.

Gradle 6.7 and below. Add the Zoho Maven URL (https://maven.zohodl.com), alongside Google and Maven Central, to your project's root build.gradle.
Gradle 6.8 and above. Add the same repository, with repositoriesMode set to FAIL_ON_PROJECT_REPOS, to your settings.gradle file instead.

Step 2: Add the dependency

In your app's build.gradle, add the Mobilisten dependency (com.zoho.salesiq:mobilisten), plus mobilisten-calls if you also need voice call support, then sync your project.

Step 3: Generate your App and Access keys

In the Zoho SalesIQ console, go to Settings, then Brands, then Installation, then Android. Enter your app's package name and click Generate.

Step 4: Initialise the SDK

Initialise Mobilisten with your App key and Access key inside the onCreate method of your Application class.

Important: If your project doesn't already override the Application class, you'll need to create one to do this. Zoho flags this as an essential step to correctly handle certain preference and master key corruption issues.

Displaying the chat launcher

By default, use ZohoSalesIQ.Launcher.show(VisibilityMode.ALWAYS) to display the floating action button that opens chat. You can also skip this default launcher entirely and build your own custom UI, triggering chat from any button or interaction you design.

Need help? 1 Cloud Consultants can help you integrate the Mobilisten SDK into your Android app, including custom UI and voice call support. Book a discovery call with 1 Cloud Consultants.