Integrations
React Native SDK
Add Kerabie live chat to your iOS or Android app.
The Kerabie React Native SDK lets you embed a fully functional chat widget inside your iOS or Android app with a few lines of code.
Installation
npm install react-native-kerabie-helpdeskFor Expo managed workflow, also run:
npx expo install react-native-kerabie-helpdeskBasic setup
Wrap your app (or just the screen where you want chat) with the provider:
import { KerAbieProvider } from 'react-native-kerabie-helpdesk';
export default function App() {
return (
<KerAbieProvider widgetKey="wk_yourkey_here">
{/* your app */}
</KerAbieProvider>
);
}Opening the chat widget
import { useKerabie } from 'react-native-kerabie-helpdesk';
function SupportButton() {
const { openChat } = useKerabie();
return <Button title="Chat with us" onPress={openChat} />;
}Identifying the user
Pass the logged-in user's details so agents know who they're talking to:
<KerAbieProvider
widgetKey="wk_yourkey_here"
user={{
name: 'Jane Smith',
email: 'jane@example.com',
userId: 'user_123',
}}
>Configuration options
| Prop | Type | Description |
|---|---|---|
widgetKey | string | Required; your Widget Key |
user | object | Optional: name, email, userId |
primaryColor | string | Override the widget accent colour |
locale | string | Language code (e.g. en, fr, es) |
Getting your Widget Key
- Go to kerabie.com/app
- Settings → Chat Widget
- Copy the Widget Key (it starts with
wk_)
Full SDK reference
For the complete API including events, methods, and advanced configuration, see the TypeScript SDK docs.