helpshift-react-native

7.8.0 • Public • Published

helpshift-react-native

** UNOFFICIAL, OPEN SOURCE **

This package is experimental and not officially supported by Helpshift

Getting started

$ yarn add helpshift-react-native

Mostly automatic installation

$ react-native link helpshift-react-native

Manual installation

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_moduleshelpshift-react-native and add RNHelpshift.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNHelpshift.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainActivity.java
  • Add import com.helpshift.reactlibrary.RNHelpshiftPackage; to the imports at the top of the file
  • Add new RNHelpshiftPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':helpshift-react-native'
    project(':helpshift-react-native').projectDir = new File(rootProject.projectDir,  '../node_modules/helpshift-react-native/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
    compile project(':helpshift-react-native')
    

API Usage

Initialize

import { Platform } from 'react-native';
import Helpshift from 'helpshift-react-native';
 
const apiKey = 'HELPSHIFT_API_KEY';
const domain = 'HELPSHIFT_DOMAIN';
const iosAppId = 'HELPSHIFT_IOS_APP_ID';
const androidAppId = 'HELPSHIFT_ANDROID_APP_ID';
 
const appId = Platform.select({ ios: iosAppId, android: androidAppId })
Helpshift.init(apiKey, domain, appId);

Login

const user = {
  identifier: 'YOUR_UNIQUE_ID', // required if no email
  email: 'jane@doe.com', // required if no identifier
  name: 'Jane Doe', // optional
  authToken: 'XXXXXXXX=' // required if User Identity Verification is enabled
}
Helpshift.login(user)

Logout

Helpshift.logout()

Show Conversation

Helpshift.showConversation()

Show FAQs

Helpshift.showFAQs()

With Custom Issue Fields (CIFs) (Documentation)

const cifs = {
// 'key': ['type', 'value']
   'number_of_rides': ['n', '12'],
   'street': ['sl', '343 sansome'],
   'new_customer': ['b', 'true']
}
 
// Where data types are mapped like so:
// singleline => sl
// multiline => ml
// number => n
// date => dt
// dropdown => dd
// checkbox => b
 
Helpshift.showConversationWithCIFs(cifs)
// OR
Helpshift.showFAQsWithCIFs(cifs)

Readme

Keywords

Package Sidebar

Install

npm i helpshift-react-native

Weekly Downloads

1

Version

7.8.0

License

none

Unpacked Size

41.5 kB

Total Files

14

Last publish

Collaborators

  • readehelpshift