React Native HubSpot Chat

A React Native wrapper for the HubSpot Mobile Chat SDK for both iOS and Android.

This package internally uses the official SDK provided by hubspot: iOS: https://github.com/HubSpot/mobile-chat-sdk-ios Android: https://github.com/HubSpot/mobile-chat-sdk-android

This package allows you to integrate HubSpot's Mobile Chatflow into your React Native app, with clean API, full TypeScript support, and native performance.

✅ Features

• 📱 Supports iOS (Swift) and Android (Kotlin)
• ✅ Native module bridge using TurboModules compatibility
• 🎯 Supports TypeScript
• 💬 Chatflow integration with a single method
• 🔐 Visitor identification supported
• 📦 Includes full documentation and open to contributions

⚙️ Setup

iOS

You need to get your plist file with hubspot configuration from your hubspot account. This is required for the chat to work.

Note:The naming of the file should be exactly as mentioned below.

1. Add Hubspot-Info.plist to your iOS project:

   • Open Xcode → Right-click on the app → Add Files to [YourApp]...
   • Select Hubspot-Info.plist
   • Make sure the file is added to the main app target (check the checkbox)

2. Install pods:

cd ios && pod install

Android

1. Download your hubspot-info.json file from Hubspot Console
2. Place it inside android/app/src/main/assets/ (Create this folder if not already existing)

🚀 Installation

yarn add react-native-hubspot-chat
cd ios && pod install

🧪 Usage

Initialize SDK

Initialise the SDK at the start of the app, please ensure your ios and android conifguration is done properly or this will fail.

import HubspotChat from 'react-native-hubspot-chat';
await HubspotChat.init();

Identify Visitor

You would need to have an identity token from hubspot first. Please read here for more details: https://developers.hubspot.com/docs/guides/api/conversations/mobile-chat-sdk/ios#identify-users-with-the-hubspot-visitor-identification-token

await HubspotChat.identify('your_signed_identity_token', '[email protected]');

Set custom chat properties

await HubspotChat.setProperties([
  { name: 'plan', value: 'pro' },
  { name: 'theme', value: 'dark' }
]);

Open Chat

await HubspotChat.open('your-chatflow-tag');

🧩 TypeScript Support

This module includes .d.ts definitions out-of-the-box.

HubspotChat.init(): Promise<void>;
HubspotChat.open(tag: string): Promise<void>;
HubspotChat.identify(identityToken: string, email?: string): Promise<void>;
HubspotChat.setProperties(props: { name: string; value: string }[] | Record<string, string>): Promise<void>;
HubspotChat.endSession(): Promise<void>;

📁 Files to Include

| File | Platform | Required | |-----------------------|----------|----------| | hubspot-info.json | Android | ✅ | | Hubspot-Info.plist | iOS | ✅ |

🤝 Contributing

See CONTRIBUTING.md for development instructions.

📄 License

MIT – see LICENSE

TODO

• Add support for push notifications for chat