react-native-customerly

Getting started

$ npm install react-native-customerly --save

Mostly automatic installation

$ react-native link react-native-customerly

PAY ATTENTION ‼️: You also need to complete the additional steps before using the SDK

Manual installation

iOS

1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-customerly and add RNCustomerly.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNCustomerly.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)

Android

1. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import io.customerly.rn.RNCustomerlyPackage; to the imports at the top of the file
• Add new RNCustomerlyPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

   include ':react-native-customerly'
   project(':react-native-customerly').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-customerly/android')
   

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

   compile project(':react-native-customerly')
   

Additional steps

iOS

1. Open you PodFile inside ios folder

• If you are using swift version 4.1 and XCode 9.x, add this:

  pod 'CustomerlySDK', '2.1.0'
  

• If you are using swift version 4.2 and XCode 10.x, add this:

  pod 'CustomerlySDK', '2.2.1'
  

2. Run $ pod install
3. Open you AppDelegate.m
4. Add import #import <CustomerlySDK/CustomerlySDK-Swift.h>
5. Add the following code in your didFinishLaunchingWithOptions:

   [[Customerly sharedInstance] configureWithAppId:@"YOUR_APP_ID"];
   [[Customerly sharedInstance] activateApp];
   

Android

1. Insert the following lines inside the dependencies block in android/app/build.gradle:

   repositories {
       jcenter()
   }
   
   compile 'io.customerly:customerly-android-sdk-supportlibraries:3.0.0'
   

2. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import io.customerly.Customerly;
• Inside you onCreate method add the following code:

  Customerly.configure(this, "YOUR_APP_ID");
  

Usage

import RNCustomerly from "react-native-customerly";

await RNCustomerly.registerUser(email, userId, name, attributes, company);

RNCustomerly.logoutUser(() => {});

RNCustomerly.openSupport(() => {});

await RNCustomerly.isSdkAvailable();

RNCustomerly.setAttributes(attributes, callback);

RNCustomerly.setCompany(attributes, callback);

RNCustomerly.setSupportEnabled(enabled, callback);

RNCustomerly.isSupportEnabled(callback);

RNCustomerly.setSurveyEnabled(enabled, callback);

RNCustomerly.isSurveyEnabled(callback);

RNCustomerly.trackEvent(eventName, callback);

RNCustomerly.update(callback);

RNCustomerly.setVerboseLogging(enabled, callback);

RNCustomerly.setAttachmentsAvailable(enabled, callback);

For all the explanation and the methods signature you can check directly the native SDK at the following links:

• iOS: https://github.com/customerly/Customerly-iOS-SDK
• Android: https://github.com/customerly/Customerly-Android-SDK