{"id":22934497,"url":"https://github.com/zoho/salesiq-mobilisten-reactnative","last_synced_at":"2026-04-29T14:01:00.460Z","repository":{"id":37452380,"uuid":"226889716","full_name":"zoho/SalesIQ-Mobilisten-ReactNative","owner":"zoho","description":"Your mobile app's ideal live chat partner. Power up your mobile App with the SalesIQ Mobilisten SDK for React-Native.","archived":false,"fork":false,"pushed_at":"2024-05-08T13:45:09.000Z","size":55025,"stargazers_count":9,"open_issues_count":3,"forks_count":11,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-05-09T10:51:03.800Z","etag":null,"topics":["chat-bot","chat-sdk","chat-sdk-js","livechat","mobilisten","react-native","salesiq-mobilisten-react-native","sdk","sdk-react-native","support-library"],"latest_commit_sha":null,"homepage":"https://mobilisten.io/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zoho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-09T14:22:47.000Z","updated_at":"2024-06-12T14:00:51.744Z","dependencies_parsed_at":"2023-02-17T22:16:15.110Z","dependency_job_id":"b10e1bba-ae09-4096-8c77-1fd315c2023a","html_url":"https://github.com/zoho/SalesIQ-Mobilisten-ReactNative","commit_stats":{"total_commits":80,"total_committers":10,"mean_commits":8.0,"dds":0.6,"last_synced_commit":"de3eaad95f442a92b2e9c0459ae8a8a3297e5289"},"previous_names":[],"tags_count":66,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoho%2FSalesIQ-Mobilisten-ReactNative","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoho%2FSalesIQ-Mobilisten-ReactNative/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoho%2FSalesIQ-Mobilisten-ReactNative/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoho%2FSalesIQ-Mobilisten-ReactNative/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoho","download_url":"https://codeload.github.com/zoho/SalesIQ-Mobilisten-ReactNative/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229699861,"owners_count":18109851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chat-bot","chat-sdk","chat-sdk-js","livechat","mobilisten","react-native","salesiq-mobilisten-react-native","sdk","sdk-react-native","support-library"],"created_at":"2024-12-14T11:40:16.565Z","updated_at":"2026-04-29T14:01:00.419Z","avatar_url":"https://github.com/zoho.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![SupportedLanguages](https://img.shields.io/badge/Platforms-iOS%20%7C%20%20Android-green.svg)](https://www.zoho.com/salesiq/help/developer-section/react-native-sdk-installation.html) [![Version](https://img.shields.io/badge/version-12.1.1-blue.svg)](https://mobilisten.io/) [![Expo Compatible](https://img.shields.io/badge/Expo-Compatible-brightgreen.svg)](https://expo.dev)\n\n# React Native module for SalesIQ Mobilisten SDK\n\nConnect with customers at every step of their journey. Give them the best in-app live chat\nexperience with Mobilisten. Mobilisten enables customers to reach you from any screen on your app,\nget their questions answered, and make better purchase decisions.\n\n## Platform Compatibility\n\n✅ **React Native** - Fully supported  \n✅ **Expo** - Fully supported with development builds (Expo Go not supported due to native dependencies)\n\n## Getting Started\n\n[**Mobilisten**](https://mobilisten.io/) is a support chat SDK that comes with a set of highly\nconfigurable APIs to suit your needs. Get started by generating an `App` and `Access` keys for your\nbundle ID from the SalesIQ console.\n\n## Requirements\n\n**iOS**: Minimum deployment target should be set to iOS 13.\n\n**Android**:\nEnsure that your project meets the following requirements:\n\n- Minimum Android Version: Android 6.0 (Lollipop) (API Level 23)\n- Compile SDK Version: 35 (Android 15)\n- Required Permissions:\n   - android.permission.INTERNET (Required for network operations)\n\n## Installation\n\nFollow the below steps given below to complete installation of **Mobilisten** in your React-Native\napp.\n\n1. Install the **@react-native-zohosalesiq/mobilisten** package using NPM.\n\n```bash\nnpm install @react-native-zohosalesiq/mobilisten-core @react-native-zohosalesiq/mobilisten\n```\n\n(Optional) Run this only if you want to integrate Mobilisten Calls along with Mobilisten\n```bash\nnpm install @react-native-zohosalesiq/mobilisten-core @react-native-zohosalesiq/mobilisten @react-native-zohosalesiq/mobilisten-calls\n```\nRefer to\nthis [README](https://github.com/zoho/salesiq-mobilisten-ReactNative/tree/main/packages/mobilisten-calls/README.md)\nfor more details with calls integration\n\n2. Link the module with the react native app\n   If you're using React Native v0.60 or above, the dependency will be linked automatically without\n   any steps being taken.\n\n#### Android: Auto linking with React Native v0.59 and below\n\n```bash\nreact-native link @react-native-zohosalesiq/mobilisten-core  @react-native-zohosalesiq/mobilisten\n```\n\n(Optional) Run this only if you want to integrate Mobilisten Calls along with Mobilisten\n```bash\nreact-native link @react-native-zohosalesiq/mobilisten-calls\n```\n\n#### Android: Manual linking with React Native v0.59 and below\n\n- Add the below code to the `android/settings.gradle`\n\n```Gradle\ninclude ':react-native-zohosalesiq_mobilisten-core'\nproject(':react-native-zohosalesiq_mobilisten-core').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-zohosalesiq_mobilisten-core/android')\ninclude ':react-native-zohosalesiq_mobilisten'\nproject(':react-native-zohosalesiq_mobilisten').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-zohosalesiq_mobilisten/android')\n```\n(Optional)\n```Gradle\ninclude ':react-native-zohosalesiq_mobilisten-calls'\nproject(':react-native-zohosalesiq_mobilisten-calls').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-zohosalesiq_mobilisten-calls/android')\n```\n\n- Implement the dependency in the `android/app/build.gradle` file inside `dependencies`\n\n```Gradle\nimplementation project(':react-native-zohosalesiq_mobilisten')\n```\n\nNote: `mobilisten-core` must be linked mandatorily.\n\n#### Installation steps for iOS\n\n1. Navigate to the `ios` folder in the project directory.\n\n2. Run the `pod repo update \u0026\u0026 pod install` command from the `ios` directory.\n\nFor the RNZohoSalesIQ version below `10.0.0`:\n\n1. Open your podfile.\n\n2. Add the \"/ios\" to the path for the RNZohoSalesIQ pod, as shown below.\n\n```ruby\npod 'RNZohoSalesIQ', :path =\u003e '../node_modules/@react-native-zohosalesiq/mobilisten/ios'\n```\n\n3. Run `pod install` after saving the changes made to the Podfile.\n\n\u003e **Note:** If you're updating from the SDK versions below `10.0.0` to above, remove the above path in your `Podfile` and run the `pod install` in the iOS folder.\n\n#### Installation steps for Android\n\n4. Navigate to the **android** folder within the project directory using Android Studio or any other\n   platform of choice for Android development.\n   Add the following maven repository to the **build.gradle** file.\n\n```gradle\nallprojects {\n      repositories {\n        .....\n          maven { url 'https://maven.zohodl.com' }\n      }\n}\n```\n\n5. Click **Sync Now** from the toolbar on the IDE.\n\n## Initializing Mobilisten\n\n1. Generate `App` and `Access` keys for iOS and Android platforms by providing your bundle id.\n2. Use the **ZohoSalesIQ.init** API with keys for each platform as shown below.\n\n```js\nimport { ZohoSalesIQ } from '@react-native-zohosalesiq/mobilisten';\n\n// OPTIONAL - Only If Calls feature is required.\nimport { ZohoSalesIQCalls } from '@react-native-zohosalesiq/mobilisten-calls';\n\nlet APP_KEY;\nlet ACCESS_KEY;\nif (Platform.OS === 'ios'){\n    APP_KEY = \"ios_app_key\";\n    ACCESS_KEY = \"ios_access_key\";\n} else {\n    APP_KEY = \"android_app_key\";\n    ACCESS_KEY = \"android_access_key\";\n}\n\n// OPTIONAL - Only if Calls feature is required.\nZohoSalesIQCalls.initialiseForiOS();\n\nZohoSalesIQ.initialize({ appKey: APP_KEY, accessKey: ACCESS_KEY }).then(() =\u003e {\n  ZohoSalesIQ.Launcher.show(ZohoSalesIQ.Launcher.VisibilityMode.ALWAYS); // Show the chat launcher\n  // Your logic after initialization\n}).catch((error) =\u003e {\n  // Handle initialization error\n});\n```\n\n3. If you wish to show the default chat launcher, use the [**ZohoSalesIQ.Launcher.show()**](https://www.zoho.com/salesiq/help/developer-section/react-native-sdk-launcher-show.html)\n   API (Optional).\n\n## API Documentation\n\nYou can find the list of all APIs and their\ndocumentation [here](https://www.zoho.com/salesiq/help/developer-section/react-native-sdk-add-event-listener.html)\nunder the **API Reference** section.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoho%2Fsalesiq-mobilisten-reactnative","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoho%2Fsalesiq-mobilisten-reactnative","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoho%2Fsalesiq-mobilisten-reactnative/lists"}