Mobile SDKs

We’re presenting Intercom articles with Intercom.presentContent(content) . Everything was working well in version 8.8.0 but after bumping to 9.x, the close button at the top article header is broken in iOS and doesn’t respond to taps. The only way to close the article is to drag the overlay down (which is something that might not be obvious for every user). It is working correctly on Android.

Hi, I’ve been having a helluva time trying to get JWT verification working with `@intercom/intercom-react-native`.For context, we have JWT working with our website, and the API secret is enabled for all platforms. We’re reusing the same endpoint we use for web to get the JWT for mobile.Our mobile app is built with:expo: @53.0.23 @intercom/intercom-react-native: 9.1.2 react-native: 0.79.5I have been testing the app in development mode, with `expo run:ios`.So far, I’ve been able to get Intercom working if JWT is not enforced. But once I activate “Enforce Messenger Security” in the Security Settings, Intercom views start returning “Something’s gone wrong” with a reload button. Here’s our JWT code:// Verified that `intercomToken` is valid, in Intercom’s online JWT decoder// // Token payload looks like:// {// "user_id": 3, // << Does this need to be a string?// "email": "person@place.com",// "name": "John Smith",// "exp": 1759892398// }await Intercom.setUserJwt(intercomToken

SDK version 19.2.0 has broken the close button on our carousels, and it's still broken on 19.2.1It would be good if we could update our SDK version for Intercom because Intercom have also fixed UI issues on iOS 26 (new iOS version) :(

Hello, We are currently using Intercom in our Expo React Native app for customer service messaging. We have previously been using Expo SDK 53 and React Native 0.79.5 with the react native intercom package 9.0.3 and all has been working well.However upgrading Intercom to 9.1.0 or higher is causing some very weird issues for us.Our app streams HLS video where the HLS playlist contains 10s chunks of video which is presented to the user as one long continuous clip. When scrubbing forward in the clip further than what’s been buffered the stream will obviously need to buffer. Our player is using the expo-video package, but we’ve tried with other packages as well such as react-native-video. Now to the issue; Intercom 9.1.0 and higher causes the app to crash when scrubbing forward quickly in the video stream, this problem is only present there and when downgrading Intercom to 9.0.3 it’s working fine again and I can scrub and pause/forward/rewind with no problem and the app is not crashing. I c

I’m trying to integrate Intercom push notifications into my React Native app built with Expo (using a custom dev client). I’m using @intercom/intercom-react-native (latest version) and JWT authentication.I can successfully:Generate a valid JWT (confirmed via jwt.io) with user_id and email. Log in the user in Intercom with matching userId and email. Verify that Intercom.isUserLoggedIn() returns true. Fetch the logged-in user attributes from Intercom, which match the JWT payload.Here’s the code I’m using to set up push notifications: export const setupIntercomPushNotifications = async (): Promise<boolean> => {  try {    const { status: existingStatus } = await Notifications.getPermissionsAsync();    let finalStatus = existingStatus;    if (existingStatus !== "granted") {      const { status } = await Notifications.requestPermissionsAsync();      finalStatus = status;    }    if (finalStatus !== "granted") {      console.log("❌ Push notification permissions not granted");      re

Hi,Push notification handling does not work at all on Android + Expo - When opening a push notification from either a terminated, or backgrounded app, the message does not open in Intercom, as it does on iOS, and as is expected.This issue can be replicated in your ‘expo-example’ at https://github.com/intercom/intercom-react-native/tree/main/examples/expo-exampleI have tested using the Expo SDK version in the your `expo-example`, and using the latest Expo version. I have also attempted to fix this issue with some native Android code as suggested by ‘Fin’:In MainNotificationService.javapackage com.example; // Replace with your package import com.google.firebase.messaging.FirebaseMessagingService; import com.google.firebase.messaging.RemoteMessage; import com.intercom.reactnative.IntercomModule;public class MainNotificationService extends FirebaseMessagingService {     @Override     public void onNewToken(String refreshedToken) {         IntercomModule.sendTokenToIntercom(getApplication()

I'm using React Native 0.78.3 and using Intercom SDK version @intercom/intercom-react-native 8.6.0. While most features work correctly, the app freezes and crashes on iOS after I open an in-app Intercom message and swipe left to right (from the left edge of the device) to close the Intercom UI View. Reproduction Steps Launch the app on iOS. Trigger an in-app Intercom message. Try to swipe left to right (from the left edge of the device) to close the Intercom UI View. App becomes unresponsive and eventually crashes. We’ve tried on other apps that are using the Intercom SDK and see that the issue is happening. The issue was fixed in @intercom/intercom-react-native 7.2.1 https://github.com/intercom/intercom-react-native/releases/tag/7.2.1 but it happens again on later versions.  Updated I’ve tried to upgrade to the latest version of @intercom/intercom-react-native 9.1.1 and the issue frozen whole app does not happen anymore but all the buttons in the intercom window are still frozen

I am working on a SwiftUI iOS app.  Building with the latest SDK (Xcode 15.4) to run on iOS 16 and above. We set our App’s accent color using the Global Accent Color Name build setting.  As soon as I include the Intercom Package via SPM our accent color is changed to the default blue.  Why is Intercom changing the accent color?

Hello!Has anyone run into this error when using the Intercom Expo plugin (@intercom/intercom-react-native@9.1.1) with an app.config.ts setup?PluginError: Package "@intercom/intercom-react-native" does not contain a valid config plugin.Learn more: https://docs.expo.dev/guides/config-plugins/#creating-a-pluginUnexpected token 'typeof'SyntaxError: Unexpected token 'typeof' at compileSourceTextModule (node:internal/modules/esm/utils:344:16) at ModuleLoader.moduleStrategy (node:internal/modules/esm/translators:105:18) at ModuleLoader.#translate (node:internal/modules/esm/loader:534:12)Not sure if this is an issue with the way the plugin is authored or how Expo expects config plugins to behave in a .ts setup.Would appreciate any insight or workarounds others may have found!

I want to report an issue we have encountered with the Intercom SDK on Android. When a user attempts to open a password-protected PDF sent by the support team, the application crashes with the following error:Fatal Exception: java.lang.SecurityException: password required or incorrect password       at android.graphics.pdf.PdfRenderer.nativeCreate(PdfRenderer.java)       at android.graphics.pdf.PdfRenderer.<init>(PdfRenderer.java:172)       at io.intercom.android.sdk.ui.preview.ui.PreviewUriKt$loadFilesAsBitmaps$1.invokeSuspend(PreviewUri.kt:269)       at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)       at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:104)       at androidx.compose.ui.platform.AndroidUiDispatcher.performTrampolineDispatch(AndroidUiDispatcher.android.kt:81)       at androidx.compose.ui.platform.AndroidUiDispatcher.access$setScheduledFrameDispatch$p(AndroidUiDispatcher.android.kt:41)       at androidx.compose.ui

We are using the Intercom Android SDK in our android app to provide customer support. Specifically, we are presenting the Messages space using the following code in Kotlin:Intercom.client().present(space = IntercomSpace.Messages)We're interested in knowing if there's a callback or event triggered when the user dismisses the Messages space by clicking the back button. Our application has specific action that need to be executed when the user returns to our UI, and it would be extremely useful to have this kind of event available.I noticed that on the iOS SDK, there are IntercomWindowWillHideNotification and IntercomWindowDidHideNotification callbacks for similar functionality. Are these iOS callbacks triggered when the Intercom message space is closed? If so, is there an equivalent on the Android SDK?If such functionality is not currently available for Android, are there plans to introduce this feature in a future update?

A NullPointerException is occurring in the Intercom Android SDK, specifically within the extractErrorString function. The crash happens when the SDK attempts to call getMessage() on a null Throwable object.Stack Trace:Fatal Exception: java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.String java.lang.Throwable.getMessage()' on a null object referenceat io.intercom.android.sdk.api.ErrorStringExtractorKt.extractErrorString(ErrorStringExtractor.kt:16)...Root Cause Analysis:Upon decompiling the SDK's code, we've identified the root cause in the onResponse method of the setAuthTokens API call.In the onResponse method, when an API response is not successful (!response.isSuccessful()), an ErrorObject is created with a Throwable that is explicitly passed as null.ErrorObject errorObject = new ErrorObject((Throwable)null, response);This ErrorObject is then passed to extractErrorString, which, within its catch block (specifically when parsing the error JSON fails), attem

I'm upgrading to React Native 0.77.2 and using Intercom SDK version @intercom/intercom-react-native 8.5.0. While most features work correctly, the app freezes and crashes on iOS after I open an in-app Intercom message and tap either the close button or interact with a Reaction within the message. Reproduction Steps Launch the app on iOS. Trigger an in-app Intercom message. Tap the "Close" button or interact with a React component rendered within the message. App becomes unresponsive and eventually crashes (ANR).  Relevant Logs (Xcode + Sentry)  Sentry Breadcrumbs show lifecycle events for multiple Intercom-related view controllers: ICMNoteViewController ICMFullScreenInAppViewController ICMInAppHeaderViewController IntercomSDK_ITBBlockListViewController A user touch event was captured: [SentryBreadcrumb] category = touchmessage = closeview = <UIButton frame=(317 4; 44 44)> Multiple slow frame detections logged by SentryFramesTracker: [SentryFramesTrack

Hi. We have a crash in our app when pushing a survey to some of our users. We are using version 17.1.0 (latest)This is the crash log → io.intercom.android.sdk.survey.SurveyViewModel.buildContentState (SurveyViewModel.kt:215)io.intercom.android.sdk.survey.SurveyViewModel.access$submitSurvey (SurveyViewModel.kt:83)io.intercom.android.sdk.survey.SurveyViewModel.access$buildContentState (SurveyViewModel.kt:83)io.intercom.android.sdk.survey.SurveyViewModel$submitSurvey$1.invokeSuspend (SurveyViewModel.kt:388)kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith (ContinuationImpl.kt:34)kotlinx.coroutines.DispatchedTask.run (DispatchedTask.kt:100)kotlinx.coroutines.internal.LimitedDispatcher$Worker.run (LimitedDispatcher.java:124)kotlinx.coroutines.scheduling.TaskImpl.run (Tasks.kt:89)kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely (CoroutineScheduler.java:586)kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.executeTask (CoroutineScheduler.kt:820)kotlinx.coroutines.

Fatal Exception: java.lang.IllegalArgumentExceptionKey "" was already used. If you are using LazyColumn/Row please make sure you provide a unique key for each item. This is the crash, all I can see in firebase is that we have a screen viewed event for “firebase_screen_class: IntercomRootActivity” and then the crash. I’m on 17,1.0

HelloAfter upgrading my app to Expo SDK 53 (React Native 0.79), the iOS build fails when using @intercom/intercom-react-native.Error message:❌  (ios/Tikin/AppDelegate.swift:1:2)> 1 | #import <IntercomModule.h>    |  ^ no macro named 'import'  2 | import Expo  3 | import React  4 | import ReactAppDependencyProvider› 1 error(s), and 3 warning(s)This line appears in the generated AppDelegate.swift:#import <IntercomModule.h>But #import is not valid in Swift files — this causes the build to fail.Environment: Expo SDK: 53 React Native: 0.79 @intercom/intercom-react-native version: [insert version if known] Build: EAS Build for iOS It seems the native module is injecting Objective-C code (#import) into a Swift file. Is there an update or change needed for compatibility with SDK 53 and RN 0.79?

We have recently implemented the SDK in our iOS app. Everything works fine but some users report that content can not be loaded? Not sure what is causing this?  

When trying to log event with `Intercom.client().logEvent` I’m displaying the survey with intercom, the ui contains close button in the right top corner. When try dismissing it with “back” navigation, I go back and then being brought again into the intercom window. Is there a way to dismiss the intercom window? Intercom.client().hideIntercom() does not seem to work

Hi,We added the Intercom Android SDK into our app.implementation 'io.intercom.android:intercom-sdk:15.6.3'When clients click these auto-reply conversations, the app crashed: Recently, we received many crash report:Parameter specified as non-null is null: method io.intercom.android.sdk.m5.conversation.states.ConversationHeaderV2.<init>, parameter subtitle Did some nearby updates at the back-end removing the ‘subtitle’ parameter? I tested with all 15.6.* version SDKs and they all have this problem.  Starting from SDK 16, a targetSDK version of 35 is required. Migrating our app to 35 will take a significant amount of time, and app crashes severely affect user experience. It would be a big help if you guys can add back the ‘subtitle’ back to the message or conversation model to keep the app from crashing. Please let me know if you can do this, or there’s other solution. Thank you!  

Hi there,The latest version of React Native, 0.77.0, migrates the iOS AppDelegate to Swift. Currently the intercom-react-native module only seems to support set up in Objective C, will this be changing soon?Many thanks, Lydia

I am getting a crash when using the Android SDK via a Flutter-based application. This crash is occurring on a Pixel 8 running Android 14.intercom_flutter 8.1.1 This uses Android SDK 15.6.3 Also tested against intercom 8.0.9, which uses SDK 16.5.1 Built using minSdkVersion 21, compileSdkVersion being Flutter’s compile SDK version.  Java compatibility set to JavaVersion.VERSION_1_8This crash occurs when clicking to access recent messages.E/AndroidRuntime(32192): java.lang.NullPointerException: Parameter specified as non-null is null: method io.intercom.android.sdk.m5.conversation.states.ConversationHeaderV2.<init>, parameter subtitleE/AndroidRuntime(32192):     at io.intercom.android.sdk.m5.conversation.states.ConversationHeaderV2.<init>(Unknown Source:8)E/AndroidRuntime(32192):     at io.intercom.android.sdk.m5.conversation.reducers.HeaderReducerKt.reduceHeaderV2(HeaderReducer.kt:48)E/AndroidRuntime(32192):     at io.intercom.android.sdk.m5.conversation.reducers.Conversatio

We’re using Intercom Android SDK 15.1.3. We use the Intercom.client().present() API to show the help center in our app.Our app currently requires READ_EXTERNAL_STORAGE permission and the only reason for this permission is for Intercom’s image attachments feature.From Android documentation, on API 33, READ_EXTERNAL_STORAGE is replaced with more granular permissions like READ_MEDIA_IMAGES etc. However, it also states that you can use the PhotoPicker to get the same behaviour without any permissions; and with the jetpack library PhotoPicker is available all the way back to API 19.My question is: Does Intercom Android SDK use PhotoPicker? What about on pre-API 33?The only reference to this I see is in the changlog for Intercom Android SDK v12.5.3 but it is not clear what that means for an app that integrates this SDK.

Fatal Exception: java.lang.IllegalArgumentException: Missing keys: [timestamp] in '{teammate} moved ticket into {status} {timestamp}'       at io.intercom.android.sdk.utilities.Phrase.format(Phrase.java:189)       at io.intercom.android.sdk.m5.notification.InAppNotificationCardKt.TicketInAppNotificationContent(InAppNotificationCard.kt:180)       at io.intercom.android.sdk.m5.notification.InAppNotificationCardKt.InAppNotificationCard(InAppNotificationCard.kt:124)       at io.intercom.android.sdk.m5.notification.InAppNotificationCardKt$addInappNotificationCardToView$1$1$1.invoke(InAppNotificationCard.kt:75)       at io.intercom.android.sdk.m5.notification.InAppNotificationCardKt$addInappNotificationCardToView$1$1$1.invoke(InAppNotificationCard.kt:74)       at androidx.compose.runtime.internal.ComposableLambdaImpl.invoke(ComposableLambda.jvm.kt:109)       at androidx.compose.runtime.internal.ComposableLambdaImpl.invoke(ComposableLambda.jvm.kt:35)       at androidx.compose.runtime.Composit

Android API 36 is ignoring the orientation configuration. The Android SDK is fixing the orientation as portrait. We have got the following warning on Google Play: From Android 16, Android will ignore resizability and orientation restrictions for large screen devices, such as foldables and tablets. This may lead to layout and usability issues for your users.We detected the following resizability and orientation restrictions in your app:<activity android:name="io.intercom.android.sdk.activities.IntercomCarouselActivity" android:screenOrientation="PORTRAIT" />To improve the user experience for your app, remove these restrictions and check that your app layouts work on various screen sizes and orientations by testing on Android 16 and below.Would it be possible to avoid orientation restrictions in the SDK?

Hello, I’m experiencing a problem where the Intercom chat does not open when a user taps on a push notification on iOS. I have implemented the Intercom React Native plugin as per the documentation, and the messaging functionality works perfectly. Notifications are received correctly, but tapping on them does not open the chat as expected. Environment Details: • Platform: iOS• React Native Version: 0.74• Intercom React Native Plugin Version: 8.1.0 Problem Description: • The Intercom messenger is fully integrated into my app, and users can send and receive messages without any issues.• Push notifications from Intercom are successfully delivered to the device.• According to the documentation, tapping on a push notification should automatically open the relevant chat within the app. However, this is not happening on iOS.• When I tap on a push notification while the app is closed, the app opens but does not display the chat. Instead, it remains on the previous screen or the home screen.• I