SalesIQ Mobilisten React-Native

https://github.com/zoho/salesiq-mobilisten-reactnative
Admin
Your mobile app's ideal live chat partner. Power up your mobile App with the SalesIQ Mobilisten SDK...
Tokens:3,470
Snippets:18
Trust Score:9.7
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Mobilisten SDK via NPM

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Installs the react-native-zohosalesiq-mobilisten package using NPM. This is the primary step to add the SDK to your React Native project.

```ruby
npm install react-native-zohosalesiq-mobilisten --save
```

--------------------------------

### Install Mobilisten SDK using NPM

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/example/README.md

Installs the react-native-zohosalesiq-mobilisten package into your React Native project. This is the primary step to include the SDK's functionality.

```shell
npm install react-native-zohosalesiq-mobilisten --save
```

--------------------------------

### iOS: Update Pod Repo and Install Dependencies

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Updates the CocoaPods repository and installs the necessary dependencies for iOS. This is a standard step for iOS React Native projects after installing the package.

```ruby
pod repo update && pod install
```

--------------------------------

### Configure iOS Podfile

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/example/README.md

Modifies the iOS Podfile to correctly point to the SDK's native iOS directory. This step is crucial for CocoaPods to find and install the necessary native libraries for iOS.

```diff
- pod 'RNZohoSalesIQ', :path => '../node_modules/react-native-zohosalesiq-mobilisten'
+ pod 'RNZohoSalesIQ', :path => '../node_modules/react-native-zohosalesiq-mobilisten/ios'
```

--------------------------------

### Link Module with React Native App

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Links the installed Mobilisten module with your React Native application. This command is typically used for older React Native versions.

```ruby
react-native link react-native-zohosalesiq-mobilisten
```

--------------------------------

### Initialize ZohoSalesIQ SDK

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Initializes the ZohoSalesIQ SDK using the `initWithCallback` API with platform-specific app and access keys. This is a crucial step for integrating the SDK into your React Native application.

```javascript
import { ZohoSalesIQ } from 'react-native-zohosalesiq-mobilisten';
import { Platform } from 'react-native';

let appKey;
let accessKey;

if (Platform.OS === 'ios') {
    appKey = "ios_app_key";
    accessKey = "ios_access_key";
} else {
    appKey = "android_app_key";
    accessKey = "android_access_key";
}

ZohoSalesIQ.initWithCallback(appKey, accessKey, (success) => {
    // Your code after initialization
    console.log('Initialization successful:', success);
});
```

--------------------------------

### Initialize Mobilisten SDK

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/example/README.md

Initializes the ZohoSalesIQ SDK with platform-specific App and Access keys. This code snippet demonstrates how to conditionally initialize the SDK based on the operating system (iOS or Android).

```javascript
import { ZohoSalesIQ } from 'react-native-zohosalesiq-mobilisten';

if (Platform.OS === 'ios'){
    ZohoSalesIQ.init("ios_app_key","ios_access_key");
}else{
    ZohoSalesIQ.init("android_app_key","android_access_key");
}
```

--------------------------------

### Enable New Architecture for iOS

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Configures the `Podfile` to enable the new architecture for React Native projects on iOS. This involves adding an environment variable to the `Podfile` to activate TurboModules and Fabric render.

```diff
# Resolve react_native_pods.rb with node to allow for hoisting
+ ENV['RCT_NEW_ARCH_ENABLED'] = '1'
require Pod::Executable.execute_command('node', ['-p',
  'require.resolve(
    "react-native/scripts/react_native_pods.rb",
    {paths: [process.argv[1]]},
  )', __dir__]).strip
```

--------------------------------

### Configure Android build.gradle

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/example/README.md

Adds the Zoho Maven repository to the allprojects section of your Android project's build.gradle file. This allows Gradle to download the required Android SDK dependencies.

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

--------------------------------

### Link Native Modules

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/example/README.md

Links the native modules of the SalesIQ Mobilisten SDK to your React Native project. This command ensures that the native code is correctly integrated with your application.

```shell
react-native link react-native-zohosalesiq-mobilisten
```

--------------------------------

### Android: Add Maven Repository for Gradle

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Configures the Gradle build system to include the Zoho Maven repository, which hosts the Mobilisten SDK artifacts. This is crucial for dependency resolution.

```gradle
// For Gradle version 6.7 and below
allprojects {
   repositories {
      google()
      mavenCentral()
      // ...
      maven { url 'https://maven.zohodl.com' }
   }
}

// For Gradle version 6.8 and above
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // Add the Zoho Maven URL here
        maven { url 'https://maven.zohodl.com' }
    }
}
```

--------------------------------

### Android: Register Package in MainApplication.java

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Registers the RNZohoSalesIQPackage within the MainApplication.java file for manual linking in older React Native versions. This ensures the native module is recognized.

```java
import com.zoho.salesiq.reactnative.RNZohoSalesIQPackage;

// ... inside ReactNativeHost
@Override
protected List<ReactPackage> getPackages() {
    // Add new RNZohoSalesIQPackage() into the React packages list like below
    return new ArrayList<>(Arrays.<ReactPackage>asList(new RNZohoSalesIQPackage()));
}
// ...
```

--------------------------------

### Show Default Chat Launcher

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Optionally displays the default chat launcher interface provided by the ZohoSalesIQ SDK. This API call makes the chat launcher visible to the user.

```javascript
import { ZohoSalesIQ } from 'react-native-zohosalesiq-mobilisten';

// To show the default chat launcher
ZohoSalesIQ.Launcher.show();
```

--------------------------------

### Enable New Architecture for Android

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Configures `android/gradle.properties` to enable the new architecture for React Native projects on Android. This involves toggling the `newArchEnabled` flag to `true` to support TurboModules and Fabric render.

```diff
# Use this property to enable support to the new architecture.
# This will allow you to use TurboModules and the Fabric render in
# your application. You should enable this flag either if you want
# to write custom TurboModules/Fabric components OR use libraries that
# are providing them.
+ newArchEnabled=true
- newArchEnabled=false
```

--------------------------------

### Android: Implement Dependency in build.gradle

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Adds the Mobilisten module as an implementation dependency in the app's build.gradle file for manual linking in older React Native versions.

```gradle
implementation project(':react-native-zohosalesiq-mobilisten')
```

--------------------------------

### Android: Add Project to settings.gradle

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Manually includes the Mobilisten module project in the Android build for React Native versions 0.59 and below. This step is necessary for manual linking.

```gradle
include ':react-native-zohosalesiq-mobilisten'
project(':react-native-zohosalesiq-mobilisten').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-zohosalesiq-mobilisten/android')
```

--------------------------------

### Android: Proguard Rules for Minification

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Specifies ProGuard rules to prevent issues when R8 or ProGuard is enabled for code minification. This rule ensures that kotlinx.parcelize annotations are handled correctly.

```proguard
-dontwarn kotlinx.parcelize.Parcelize
```

--------------------------------

### iOS: Modify Podfile for Older SDK Versions

Source: https://github.com/zoho/salesiq-mobilisten-reactnative/blob/master/README.md

Adjusts the Podfile to correctly point to the iOS module for RNZohoSalesIQ versions below 10.0.0. This ensures the native iOS code is properly linked.

```diff
- pod 'RNZohoSalesIQ', :path => '../node_modules/react-native-zohosalesiq-mobilisten'
+ pod 'RNZohoSalesIQ', :path => '../node_modules/react-native-zohosalesiq-mobilisten/ios'
```
Tokens:
Raw