README.md

Capacitor Intercom

@capacitor-community/intercom

Capacitor community plugin for enabling Intercom capabilities

Maintainers

Compatibility

Note: This plugin follows semantic versioning aligned with Capacitor and maintains compatibility with Intercom SDKs (iOS, Android). If you encounter any issues due to versioning inconsistencies, please open an issue to help us improve the plugin.

Installation

Using npm:

npm install @capacitor-community/intercom

Using yarn:

yarn add @capacitor-community/intercom

Sync native files:

npx cap sync

Usage

import { Intercom } from '@capacitor-community/intercom';
import { PushNotifications } from '@capacitor/push-notifications';

// Register for push notifications from Intercom
PushNotifications.register();

// Register an identified user
Intercom.registerIdentifiedUser({ userId: 123456 });
Intercom.registerIdentifiedUser({ email: 'test@example.com' });
Intercom.registerIdentifiedUser({ userId: 123456, email: 'test@example.com' });

// Register a log event
Intercom.logEvent({ name: 'my-event', data: { pi: 3.14 } });

// Display the message composer
Intercom.displayMessageComposer({ message: 'Hello there!' });

// Identity Verification
// https://developers.intercom.com/installing-intercom/docs/ios-identity-verification
Intercom.setUserHash({ hmac: 'xyz' });

// Secure Your Messenger
// https://developers.intercom.com/installing-intercom/ios/secure-your-messenger
Intercom.setUserJwt({ jwt: 'xyz' });

iOS setup

• ionic start my-cap-app --capacitor
• cd my-cap-app
• npm install @capacitor-community/intercom
• mkdir www && touch www/index.html
• npx cap add ios
• add intercom keys to capacitor's configuration file

{
 …
  "plugins": {
   "Intercom": {
      "iosApiKey": "ios_sdk-xxx",
      "iosAppId": "yyy"
    }
  }
…
}

• npx cap open ios
• sign your app at xcode (general tab)

Tip: every time you change a native code you may need to clean up the cache (Product > Clean build folder) and then run the app again.

Android setup

• ionic start my-cap-app --capacitor
• cd my-cap-app
• npm install @capacitor-community/intercom
• mkdir www && touch www/index.html
• npx cap add android
• add intercom keys to capacitor's configuration file

{
 …
  "plugins": {
   "Intercom": {
      "androidApiKey": "android_sdk-xxx",
      "androidAppId": "yyy"
    }
  }
…
}

• npx cap open android

Now you should be set to go. Try to run your client using ionic cap run android --livereload.

Tip: every time you change a native code you may need to clean up the cache (Build > Clean Project | Build > Rebuild Project) and then run the app again.

API

loadWithKeys(options: { appId?: string; apiKeyIOS?: string; apiKeyAndroid?: string; }) => Promise<void>

registerIdentifiedUser(options: { userId?: string; email?: string; }) => Promise<void>

registerUnidentifiedUser() => Promise<void>

updateUser(options: IntercomUserUpdateOptions) => Promise<void>

logout() => Promise<void>

logEvent(options: { name: string; data?: any; }) => Promise<void>

displayMessenger() => Promise<void>

displayMessageComposer(options: { message: string; }) => Promise<void>

displayHelpCenter() => Promise<void>

hideMessenger() => Promise<void>

displayLauncher() => Promise<void>

hideLauncher() => Promise<void>

displayInAppMessages() => Promise<void>

hideInAppMessages() => Promise<void>

displayCarousel(options: { carouselId: string; }) => Promise<void>

setUserHash(options: { hmac: string; }) => Promise<void>

setUserJwt(options: { jwt: string; }) => Promise<void>

setBottomPadding(options: { value: string; }) => Promise<void>

sendPushTokenToIntercom(options: { value: string; }) => Promise<void>

receivePush(notification: IntercomPushNotificationData) => Promise<void>

displayArticle(options: { articleId: string; }) => Promise<void>

addListener(eventName: 'windowDidShow', listenerFunc: () => void) => Promise<PluginListenerHandle>

addListener(eventName: 'windowDidHide', listenerFunc: () => void) => Promise<PluginListenerHandle>

removeAllListeners() => Promise<void>

Notice 🚀

We're starting fresh under an official org. If you were using the previous npm package capacitor-intercom, please update your package.json to @capacitor-community/intercom. Check out changelog for more info.

Breaking changes from Capacitor v2 to v3

• UserUpdateOptions option type becomes IntercomUserUpdateOptions
• IntercomPlugin configuration key becomes Intercom
• android-apiKey config key becomes androidApiKey
• android-appId config key becomes androidAppId
• ios-apiKey config key becomes iosApiKey
• ios-appId config key becomes iosAppId
• Switch from CAPBridge to ApplicationDelegateProxy in application events
• remove the whole onCreate initialization from your app's MainActivity.java

 public class MainActivity extends BridgeActivity {
-    @Override
-    public void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
-
-        // Initializes the Bridge
-        this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
-            // Additional plugins you've installed go here
-            add(IntercomPlugin.class);
-        }});
-    }
}

License

MIT

Example

• https://github.com/capacitor-community/intercom/blob/master/example

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Stew 💻 📖	David Seek 💻	Roman Nikitin 💻	Anne Tomassoni 💻 👀	Maciej Modzelewski 💻	Oleg Yuzvik 🚧	Gustavo Corrêa Alves 📖
Jealvia 🚧	Adam Duren 💻 🚧	Rami Khafagi 💻	Masahiko Sakakibara 🚧	Dejardin Camille 💻	Mohamed Abdelgwad 🚧	Nathan 🚧
Cecil Wöbker 💻 🚧	Pavlo Pyrig 💻	Ruan 💻	RickJeroen 🚧	reslear 📖	Philipp Matter 💻	Josh Pike 🚧
vtorenaintermedia 💻	coicoronado 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!