@capacitor-community/intercom

Capacitor Intercom

@capacitor-community/intercom

Capacitor community plugin for enabling Intercom capabilities

Maintainers

Maintainer	GitHub	Social
Stewan Silva	stewones	@stewones

Compatibility

Capacitor	Intercom iOS	Intercom Android	iOS Target	Android Target
7.x	18.x	15.x	15.0	35
6.x	16.x	12.x	13.0	34

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 indetified user
Intercom.registerIdentifiedUser({ userId: 123456 });
Intercom.registerIdentifiedUser({ email: '[e-mail]' });
Intercom.registerIdentifiedUser({ userId: 123456, email: '[e-mail]' });

// 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' });

iOS setup

• ionic start my-cap-app --capacitor
• cd my-cap-app
• npm install —-save @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 —-save @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(...)
• registerIdentifiedUser(...)
• registerUnidentifiedUser()
• updateUser(...)
• logout()
• logEvent(...)
• displayMessenger()
• displayMessageComposer(...)
• displayHelpCenter()
• hideMessenger()
• displayLauncher()
• hideLauncher()
• displayInAppMessages()
• hideInAppMessages()
• displayCarousel(...)
• setUserHash(...)
• setBottomPadding(...)
• sendPushTokenToIntercom(...)
• receivePush(...)
• displayArticle(...)
• addListener('windowDidShow', ...)
• addListener('windowDidHide', ...)
• removeAllListeners()
• Interfaces

loadWithKeys(...)

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

Param	Type
options	{ appId?: string; apiKeyIOS?: string; apiKeyAndroid?: string; }

registerIdentifiedUser(...)

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

Param	Type
options	{ userId?: string; email?: string; }

registerUnidentifiedUser()

registerUnidentifiedUser() => Promise<void>

updateUser(...)

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

Param	Type
options	IntercomUserUpdateOptions

logout()

logout() => Promise<void>

logEvent(...)

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

Param	Type
options	{ name: string; data?: any; }

displayMessenger()

displayMessenger() => Promise<void>

displayMessageComposer(...)

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

Param	Type
options	{ message: string; }

displayHelpCenter()

displayHelpCenter() => Promise<void>

hideMessenger()

hideMessenger() => Promise<void>

displayLauncher()

displayLauncher() => Promise<void>

hideLauncher()

hideLauncher() => Promise<void>

displayInAppMessages()

displayInAppMessages() => Promise<void>

hideInAppMessages()

hideInAppMessages() => Promise<void>

displayCarousel(...)

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

Param	Type
options	{ carouselId: string; }

setUserHash(...)

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

Param	Type
options	{ hmac: string; }

setBottomPadding(...)

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

Param	Type
options	{ value: string; }

sendPushTokenToIntercom(...)

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

Param	Type
options	{ value: string; }

receivePush(...)

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

Param	Type
notification	IntercomPushNotificationData

displayArticle(...)

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

Param	Type
options	{ articleId: string; }

addListener('windowDidShow', ...)

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

Param	Type
eventName	'windowDidShow'
listenerFunc	() => void

Returns: Promise<PluginListenerHandle>

addListener('windowDidHide', ...)

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

Param	Type
eventName	'windowDidHide'
listenerFunc	() => void

Returns: Promise<PluginListenerHandle>

removeAllListeners()

removeAllListeners() => Promise<void>

Interfaces

IntercomUserUpdateOptions

Prop	Type
userId	string
email	string
name	string
phone	string
languageOverride	string
customAttributes	{ [key: string]: any; }

IntercomPushNotificationData

Prop	Type
conversation_id	string
message	string
body	string
author_name	string
image_url	string
app_name	string
receiver	string
conversation_part_type	string
intercom_push_type	string
uri	string
push_only_conversation_id	string
instance_id	string
title	string
priority	number

PluginListenerHandle

Prop	Type
remove	() => 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 🚧

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