Skip to main content
All CollectionsMobile SDKs
Install and use Intercom in your mobile app
Install and use Intercom in your mobile app

Engage users of your mobile app with an onboarding and support experience powered by Intercom.

Beth-Ann Sher avatar
Written by Beth-Ann Sher
Updated over 5 months ago

Install Intercom on your iOS or Android app to see who your users are, and connect with them across every touchpoint:

All without them ever leaving your app.


Installing and configuring Intercom in your mobile app

Installing Intercom in your mobile app takes just a few minutes with our native SDKs for iOS, Android, React Native and Cordova.

Note:

  • The Intercom for iOS SDK supports iOS 13 and upwards. Intercom for Android supports API 21 (5.0) and above.

  • The latest Messenger requires iOS and Android SDKs v14.0.1.

When installing Intercom in your mobile app, you should configure the custom data you want to track about your users. This lets you send more targeted and personalized messages and carousels.

You or your developer can find instructions on how to do this in our developer docs:

The SDKs are small too, so they won’t slow down your app. 👌

Platform selector

From the Settings > Installation page, you'll be asked to choose whether you want to install the Messenger in a web environment or a mobile environment.

Choosing Install for web will display the installation flow for websites, choosing Install for mobile will display the new installation flow for mobile apps. 👇

The status for mobile will display “Not installed” if neither Android or iOS have been installed, or “Securely installed” if both have been installed.

There are three steps for you to complete in order to install the Messenger in your mobile apps.

Initial Messenger install

Choose your installation platform of choice; iOS, Android or React Native. All chosen platforms have steps specific to that platform.

You'll be provided with options for how to install Intercom into your mobile apps and some code snippets to help with the installation. The code snippet options provided for iOS are:

  1. Swift Package Manager

  2. Cocoapods

  3. Manual Installation

The code snippet options provided for Android are:

  1. Groovy

  2. Kotlin

The “Enable user traffic for messenger” toggle is required for mobile installation of the Messenger.

The code snippet options provided for React Native are:

  1. Yarn

  2. NPM

  3. Expo

The next step will be to "Initialize Intercom" within the codebase of your mobile app. You can also manage your API keys in this step. The code snippet options for iOS are:

  1. Swift

  2. Swift UI

  3. ObjectiveC

The code snippet options for Android are:

  1. Kotlin

  2. Java

The choices for React Native are:

  1. iOS

  2. Android

The Check installation button at the end offers a success notification if the Messenger has been successfully found for your chosen installation, or it indicates whether something has gone wrong.

Securing the messenger with Identity Verification

To secure the Messenger with Identity Verification on mobile, go to Settings > Installation > Install for mobile and choose the installation platform; iOS, Android or React Native.

Similar to the initial installation step, you will be asked to choose which platform you wish to install the React Native SDK with (iOS or Android).

Code snippets and instructions are provided on how to generate a HMAC code (Hash-based Message Authentication Code) within your backend codebase and provide it to the Intercom Messenger. This HMAC code is used by Intercom to verify the authenticity of user interactions in the Messenger.

An additional code snippet is provided so you can include the HMAC when initializing Intercom within your mobile app. The code snippet options provided for iOS are:

  1. Swift

  2. Swift UI

  3. ObjectiveC

The code snippet options provided for Android are:

  1. Kotlin

  2. Java

For React Native, we provide an example code snippet for how you can use the HMAC code to initialize Intercom with identity verification.

The final step in the identity verification process is to enforce identity verification. Once this is done all requests from the Messenger which do not include the valid HMAC code will be rejected.

When you enforce identity verification for either an iOS or Android app the second step is marked as completed.

Optional: Set up push notifications

Within this step you will again have the option of the installation platform; iOS or Android. You can configure push notifications from this section, but it will not guide you through the process. Instead our developer docs should be used for push notification setup:

React native is not offered as an option for mobile push notifications.

This optional step is marked as complete when push notifications have been detected as set up for either an iOS or an Android app.


Important: Xcode 14 is now required to build Intercom iOS SDK v13.0.0+

In Xcode 14, there are several warnings logged to the console when the SDK is installed. The warnings stem from Intercom's use of WKWebView. There is a bug in Xcode 14 that triggers these warnings, and it is not an issue that Intercom can fix.

They are just warnings and Intercom continues to function as normal when they are present.

Here are the warning messages:

  1. WKWebView Error - View Article and you see this in the console: Error acquiring assertion: <Error Domain=RBSServiceErrorDomain Code=1 "target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit}>

  2. This method should not be called on the main thread as it may lead to UI unresponsiveness.

  3. [Sandbox] Could not enable Mach bootstrap, errno = 22.


Deeply integrate your Help Center in your mobile app

Including your Articles Help Center directly in your mobile app, gives you many flexible ways to present help content to your users. Whether you use Intercom’s pre-built UI, or develop your own custom presentation, you can give your customers exactly the support they need.


Keep your users’ conversations secure with identity verification

Finally, we strongly recommend enabling identity verification on your iOS and/or Android app. Identity verification helps ensure that conversations between you and your users are kept private, and that one user can't impersonate another.


What’s next?


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?