@capacitor-community/intercom

Capacitor Intercom

@capacitor-community/intercom

Capacitor community plugin for enabling Intercom capabilities

Maintainers

Maintainer	GitHub	Social
Stewan Silva	stewwan	@StewanSilva

Installation

Using npm:

npm install @capacitor-community/intercom

Using yarn:

yarn add @capacitor-community/intercom

Sync native files:

npx cap sync

API

• registerIdentifiedUser
• registerUnidentifiedUser
• updateUser
• logout
• logEvent
• displayMessenger
• displayMessageComposer
• displayHelpCenter
• hideMessenger
• displayLauncher
• hideLauncher
• displayInAppMessages
• hideInAppMessages
• setUserHash
• setBottomPadding

Usage

import { Intercom } from "capacitor-intercom";
const intercom = new Intercom();

import { Plugins } from "@capacitor/core";
const { PushNotifications } = Plugins;

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

//
// Register an indetified user
intercom
  .registerIdentifiedUser({ userId: 123456 }) // or email or both

//
// 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-intercom
• mkdir www && touch www/index.html
• npx cap add ios
• add intercom keys to capacitor's configuration file

{
 …
  "plugins": {
   "IntercomPlugin": {
      "ios-apiKey": "ios_sdk-xxx",
      "ios-appId": "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-intercom
• mkdir www && touch www/index.html
• npx cap add android
• add intercom keys to capacitor's configuration file

{
 …
  "plugins": {
   "IntercomPlugin": {
      "android-apiKey": "android_sdk-xxx",
      "android-appId": "yyy"
    }
  }
…
}

• npx cap open android
• [extra step] in android case we need to tell Capacitor to initialise the plugin:

on your MainActivity.java file add import io.stewan.capacitor.intercom.IntercomPlugin; and then inside the init callback add(IntercomPlugin.class);

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.

License

MIT

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Stew 💻 📖

David Seek 💻

Roman Nikitin 💻

Anne Tomassoni 💻 👀

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

Changelog

1.0.0 (2020-06-27)

Features

• add readme (63aaee0)
• add setBottomPadding closes #3 (72737df)
• add setUserHash resolves #2 (8614592)
• android: add plugin initialization (4419064)
• android: finish initial api (45b64b6)
• capacitor: add support for iOS (beac173)
• make the official cordova version plugin work on capacitor (87c6961)

Bug Fixes

• android: add app compat (9e2a97c)
• android: cap implementation (081eb00)
• README: add .md extension (bec5b49)
• README: typo (1898e9e)