The React Native Chat SDK can be installed in a few lines of codes in any React Native app.
Notice
Features
- iOS & Android support
- TypeScript support
Installation
Install the library using either yarn
or npm
like so:
yarn add react-native-crisp-chat-sdk
npm install --save react-native-crisp-chat-sdk
Notes for iOS installation
If you're using React Native versions > 60.0, it's relatively straightforward:
cd ios && pod install
For versions below 0.60.0, use rnpm
links:
- Run
react-native link react-native-crisp-chat-sdk
- If linking fails, follow the manual linking steps
iOS
Update your Info.plist
To enable your users to take and upload photos to the chat as well as download photos to their photo library, add the Privacy - Camera Usage Description
(NSCameraUsageDescription) and Privacy - Photo Library Additions Usage Description
(NSPhotoLibraryAddUsageDescription) to your app's Info.plist
.
Requirements
NSCameraUsageDescription
and NSPhotoLibraryUsageDescription
in Info.plist
, to inform your users that you need to access to the Camera and Photo Library. You also have to enable "iCloud Documents" capability.How To Get Your Website ID?
Go to your Crisp Dashboard, and copy your Website ID:
Then, configure the Website ID in the SDK code.
Usage
You can view the example project for more usage examples.
import CrispChat, {
configure,
setUserEmail,
setUserNickname,
setUserPhone,
resetSession,
} from 'react-native-crisp-chat-sdk';
// ...
export default function App() {
// You must set your website ID before calling <CrispChat />
configure("YOUR_WEBSITE_ID");
// this should be user ID that way app will load previous user chats
setUserTokenId('abcd12345');
// Set user's info
setUserEmail('test@test.com');
setUserNickname('John Smith');
setUserPhone('+614430231224');
// Call session reset when user loggs out
resetSession();
return <CrispChat />;
}
Availables APIs
The following SDK APIs are available to you:
CrispChatSDK.configure('WEBSITE_ID')
CrispChatSDK.show()
CrispChatSDK.setTokenId('userID')
CrispChatSDK.pushSessionEvent(name: "Signup", color: CrispSessionEventColors.blue)
CrispChatSDK.setUserEmail('test@test.com')
CrispChatSDK.setUserNickname('John Doe')
CrispChatSDK.setUserPhone('003370123456789')
CrispChatSDK.setUserAvatar('https://pbs.twimg.com/profile_images/782474226020200448/zDo-gAo0_400x400.jpg')
CrispChatSDK.setSessionSegment('segment')
CrispChatSDK.setSessionString('key', 'value')
CrispChatSDK.setSessionBool('key', 'value')
CrispChatSDK.setSessionInt('key', 'value')
CrispChatSDK.resetSession()