Zoho SalesIQ Mobilisten Flutter Plugin

Connect with customers at every step of their journey. Give them the best in-app live chat experience with Mobilisten. Mobilisten enables customers to reach you from any screen on your app, get their questions answered, and make better purchase decisions.

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

Installation:

Please follow the steps mentioned below to install the Mobilisten plugin in your Flutter mobile application.

Requirements:

Android: The SDK supports Android 5.0 (API level 21) and above.
iOS: The iOS SDK is compatible with iOS version 12 and above; Xcode 13.0 and above is required as the development environment.

Installation steps:

1. Add Mobilisten as a dependency within the pubspec.yaml file as shown below

Copied dependencies:
              flutter:
                sdk: flutter
              salesiq_mobilisten: ^5.0.0

2. Run flutter pub get to fetch dependencies for the project.

3. Navigate to the ios directory and run the pod install command.

4. Add the following permissions in the Info.plist file for the iOS Runner project.

5. Open the android directory in Android Studio or any IDE used for Android development. Open the project build.gradle file and add the following maven repository.

Copied 
allprojects {
                repositories {
                    .....
                    maven { url 'https://maven.zohodl.com' }
                }
            }
            

Now, click on Sync Now or use the Sync Project with Gradle Files option under the File menu.

6. Generate the App and Access keys for iOS to initialize Mobilisten. In the Zoho SalesIQ console, navigate to Settings → Brands → Installation → iOS. Enter the bundle ID for the application as shown in the example below and click on Generate.

Note: The App and Access keys generated for iOS are to be used in further steps.

7. Generate the App and Access keys for Android to initialize Mobilisten. In the Zoho SalesIQ console, navigate to Settings → Brands → Installation → Android. Enter the application ID for the application as shown in the below example and Click on Generate.

8: Setup the Lifecycle Callback 

Add the android:name property to the <application> tag in your AndroidManifest.xml:

Copied 
<application
    android:label="@string/app_name"
    android:icon="@drawable/ic_launcher"
    android:name="<package_name>.MyFlutterApplication">    

Copied 
import io.flutter.app.FlutterApplication;

public class MyFlutterApplication extends FlutterApplication {

        //...
 
       @Override
        public void onCreate() {
                MobilistenPlugin.registerCallbacks(this);
                super.onCreate();
        }
}    

This is essential as it enables Mobilisten to track activity's lifecycles and other listener callbacks on the app's startup to show the launcher and other important user behaviors.

Note: 

  • If you already have a custom Application class, ensure to "import com.zoho.livechat.android.MobilistenActivityLifecycleCallbacks;" and call "MobilistenActivityLifecycleCallbacks.register(this);" before invoking "super.onCreate()".