georgedavidtito/react-native-zendesk-ichat

Simple module that allows displaying Zopim Chat from Zendesk for React Native in the latest versions.

react-native-zendesk-ichat 📣

Getting started

Follow the instructions to install the SDK for iOS and Android.

$ npm install react-native-zendesk-ichat --save or $ yarn add react-native-zendesk-ichat

Mostly automatic installation

$ react-native link react-native-zendesk-ichat (Only versions less than 0.60)

📘 Manual installation

📱 iOS

Using CocoaPods (Best Approach)

• Target minimum iOS version: '9.0' => ZDCChat 1.4.1
• Target minimum iOS version: '9.3' => ZDCChat 1.4.2 (configured to use this version https://developer.zendesk.com/embeddables/docs/ios-chat-sdk/releasenotes#version-1.4.2)

1. Go to ios ➜ pod install.
2. Open up ios/[...]/AppDelegate.m

• Add #import <ZDCChat/ZDCChat.h>;
• Add

  -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
  {
  ...
  	[ZDCChat initializeWithAccountKey:@"key"]; // <- add this
  	return YES;
  }

📱 Android

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

• Add import com.rnzendeskchat.RNZendeskChatModule; and com.facebook.react.bridge.ReactApplicationContext; to the imports at the top of the file
• Add static RNZendeskChatModule rnZendeskChatModule; before the onCreate method;
• Add

  ReactApplicationContext reactContext = new ReactApplicationContext(this);
  rnZendeskChatModule = new RNZendeskChatModule(reactContext);
  rnZendeskChatModule.init("key");

  to the onCreate method;
• (Only versions less than 0.60) Add new RNZendeskChatPackage() to the list returned by the getPackages() method

2. Insert the following lines inside the allprojects repositories block in android/build.gradle:

     maven { url 'https://zendesk.artifactoryonline.com/zendesk/repo' }
   

3. (Only versions less than 0.60) Append the following lines to android/settings.gradle:

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

4. (Only versions less than 0.60) Insert the following lines inside the dependencies block in android/app/build.gradle:

     compile project(':react-native-zendesk-ichat')
   

👍 Contribute

Show your ❤️ and support by giving a ⭐. Any suggestions and pull request are welcome !

📝 License

MIT © DavidTito

🚀 Usage

import RNZendeskChat from 'react-native-zendesk-ichat';

RNZendeskChat.startChat({
            name: 'someName',
            email: 'someEmail',
            phone: 'somePhone',
            tags: ['someTag1', 'someTag2']
          })

react-native-zendesk-ichat's Issues

null is an object evaluating _reactNativeZendeskiChat.default.startChat

Set department is not working in Android

The department set in this method is not working in Android. Zendesk doesn't show any department when started the chat. Did I miss anything?

ZendeskChat.startChat({
name: 'someName',
email: 'someEmail',
phone: 'somePhone',
tags: ['someTag1', 'someTag2'],
department: 'someDepartment'
})

pod file broken

Can't install pods

[!] CocoaPods could not find compatible versions for pod "RNZendeskChat":
  In Podfile:
    RNZendeskChat (from `../node_modules/react-native-zendesk-ichat/ios`)

Specs satisfying the `RNZendeskChat (from `../node_modules/react-native-zendesk-ichat/ios`)` dependency were found, but they required a higher minimum deployment target.

[QUESTION] Change of color or UI in the chat screen

Can I change the Zendesk Chat user interface, eg. color, font, etc.

[QUESTION] Push notification

How do I use Push notification?
I tried to do it but it seems that I am missing something

On ios with open chat show chat icon

Hi. When you open chat to screen add an icon with chat. How can I delete or hide it? only on ios.

Push notification crashes iOS app when app is in quit state

Hello @davidtito1992
I am having a cumbersome issue using this package with FCM push notifications.
When a push notification launches the iOS app from a quit state it always crashes the app.

I followed zendesk documentation that is described here by you like so:

- (void) application:(UIApplication*)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)tokenData {
    [ZDCChat setPushToken:tokenData];
}

- (void) application:(UIApplication*)application didReceiveRemoteNotification:(NSDictionary*)userInfo {
    [ZDCChat didReceiveRemoteNotification:userInfo];
}

Here is also a stack trace of the native crash:

react-native link error

Trying to link:
react-native link react-native-zendesk-ichat

Got this error:
error Something went wrong while linking. Error: Expected [\n\r] but end of input found.

React Native Environment Info:
System:
OS: macOS 10.15
CPU: (4) x64 Intel(R) Core(TM) i5-7360U CPU @ 2.30GHz
Memory: 167.52 MB / 8.00 GB
Shell: 5.7.1 - /bin/zsh
Binaries:
Node: 10.16.0 - /usr/local/bin/node
Yarn: 1.16.0 - /usr/local/bin/yarn
npm: 6.9.0 - /usr/local/bin/npm
Watchman: 4.9.0 - /usr/local/bin/watchman
SDKs:
iOS SDK:
Platforms: iOS 12.4, macOS 10.14, tvOS 12.4, watchOS 5.3
Android SDK:
API Levels: 23, 26, 27, 28
Build Tools: 26.0.2, 26.0.3, 27.0.3, 28.0.0, 28.0.2, 28.0.3
System Images: android-28 | Intel x86 Atom_64, android-28 | Google Play Intel x86 Atom
IDEs:
Android Studio: 3.3 AI-182.5107.16.33.5314842
Xcode: 10.3/10G8 - /usr/bin/xcodebuild
npmPackages:
react: 16.8.3 => 16.8.3
react-native: ^0.59.9 => 0.59.10
npmGlobalPackages:
react-native-cli: 2.0.1