Mobile SDKs | Community
Skip to main content

Mobile SDKs

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

  • 467 Topics
  • 1,516 Replies
467 Topics
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 19.0.1

Release Date: 03-07-2025 🐛 Bug Fixes Fixes a bug that could cause a crash when trying to resend a failed media message. Fixes a bug that could cause a crash during complex gradient background processing.

40
Brian B11
Intercom Team
Brian B11
Intercom Team
Brian B11Intercom Team
published in Mobile SDKs
iOS SDK Release 19.0.0

Release Date: 26-06-2025 🚀 Enhancements Added support for Dark Mode. This feature is currently in beta, and will be enabled for all customers in a future release.

180
Brian B11
Intercom Team
Brian B11
Intercom Team
Brian B11Intercom Team
published in Mobile SDKs
iOS SDK Release 18.7.2

Release Date: 06-05-2025 🚀 Enhancements Improved handling of conversations merged across channels and conversations merged between users.

290
Brian B11
Intercom Team
Brian B11
Intercom Team
Brian B11Intercom Team
published in Mobile SDKs
iOS SDK Release 18.7.1

Release Date: 23-04-2025 🚀 Enhancements Some improvements to the rendering and height management of messenger apps.

530
Brian B11
Intercom Team
T
Trung Le DangConnector
asked in Mobile SDKs
App crash when tapping Intercom push notification on Android (related to avatar image)

Hi Intercom Support,I would like to report an issue encountered on Android devices when handling push notifications from Intercom. Specifically, the main application crashes upon tapping a push notification if the sender has an avatar (image_url is not empty).Reproduction Steps:Create a trial Intercom conversation. Configure the Intercom Android SDK with the app ID and push notification settings. Use the main app to initiate a first message to Intercom. From the Intercom admin interface, send a reply message from an agent account that has no avatar set (i.e., image_url is empty). Receive the push notification on the Android device and tap on it.Observed Behavior:If the sender has an avatar (image_url is set): Tapping the push notification opens the Intercom conversation. However, the main app process is killed. Pressing “Back” returns to the Android home screen. The user must relaunch the app manually. If the sender does not have an avatar: Tapping the notification opens the Interco

202
T
A
Alex TNew Participant
asked in Mobile SDKs
[react-native] removing event listener throws "Maximum call stack size exceeded" error

Howdy!We're experiencing this issue after updating from 3.x SDK to 4.0.1 (https://github.com/intercom/intercom-react-native react-native version: 0.70.5  Code sample (which is basically the same that you have in docs):  useEffect(() => { const subscription = Intercom.addEventListener( IntercomEvents.IntercomUnreadCountDidChange, (response) => { setCount(response.count); } );   return () => { try { subscription.remove(); } catch (e) { console.log(e); } }; }, []); Calling subscription.remove on line 11 during effect cleanup triggers an exception. Line 13 prints:[RangeError: Maximum call stack size exceeded]Without try/catch block the call just fails silently due to this - https://github.com/facebook/react-native/issues/32673(which doesn't contribute to the original problem, just makes it go unnoticed).  Let me know what other details you might need. What can be done about it? Thanks.

141212
Emilygav
Intercom Team
A
alexdNew Participant
asked in Mobile SDKs
Build Failure Due to Gradle Task Dependency in intercom-react-native

Hello Intercom team,I am encountering a Gradle build error when integrating the intercom-react-native library into my React Native project. The issue seems related to an implicit task dependency conflict.Error details:A problem was found with the configuration of task ':intercom-react-native:copyDebugJniLibsProjectAndLocalJars' (type 'LibraryJniLibsTask').Gradle detected a problem with the following location: '[project path]/node_modules/@intercom/intercom-react-native/android/build/intermediates/stripped_native_libs/debug/stripDebugDebugSymbols/out'.Reason: Task ':intercom-react-native:copyDebugJniLibsProjectAndLocalJars' uses output from ':intercom_intercom-react-native:stripDebugDebugSymbols' without declaring a dependency.Attempted solutions: Cleaned Gradle build and cache. Added explicit task dependencies using afterEvaluate, but encountered errors related to task names not found. Could you please assist in resolving this issue or provide guidance on properly handling this Gradl

121
Emilygav
Intercom Team
D
Daniel_ENew Participant
asked in Mobile SDKs
iOS SDK: Xcode 15 requirement for installation?

I'm trying to install the iOS SDK and have been following the provided guide. However, when I click the "Check Installation" button at the end, it doesn't seem to register as installed. I'm currently using Xcode 16.4 with an iOS 18.5 simulator.I noticed that the SDK's README mentions Xcode 15 as a requirement. Is this version required only for installation, or is it also necessary for Intercom to function correctly? Additionally, will support for Xcode 16 be available soon?This could be a blocker for us, as Xcode 15 isn't compatible with macOS Sequoia 15.5. 

361
Jacques Reynolds
Intercom Team
J
J.T.New Participant
asked in Mobile SDKs
Android - New crash on 16.3.0

Seeing a new crash on Samsung Galaxy S24 Ultra (in the field)  Android 15At least 3 different users all with this same device.  java.lang.IllegalStateException (crashed)ViewTreeLifecycleOwner not found from android.widget.FrameLayout{ff120ae V.E...... ........ 0,0-1080,2340 #7f0a04d4 app:id/intercom_overlay_root}androidx.compose.ui.internal.InlineClassHelperKt.throwIllegalStateExceptionForNullCheck (SourceFile:34)androidx.compose.ui.platform.WindowRecomposer_androidKt.createLifecycleAwareWindowRecomposer (SourceFile:455)androidx.compose.ui.platform.AbstractComposeView.ensureCompositionCreated (SourceFile:250)androidx.compose.ui.platform.AbstractComposeView.onMeasure (SourceFile:285)android.view.View.measure (View.java:29591)android.view.ViewGroup.measureChildWithMargins (ViewGroup.java:7383)android.widget.FrameLayout.onMeasure (FrameLayout.java:207)android.view.View.measure (View.java:29591)android.view.ViewGroup.measureChildWithMargins (ViewGroup.java:7383)android.widget.FrameLayout.o

473
Y
P
Prakhar JainNew Participant
asked in Mobile SDKs
Intercom React Native Unread Count Issues: getUnreadConversationCount and Listener Not Updating

Hello Intercom Community,I'm encountering a persistent issue with retrieving and listening for unread conversation counts in my React Native application using the Intercom SDK. Neither Intercom.getUnreadConversationCount() nor the IntercomUnreadConversationCountDidChangeNotification event listener seems to be working as expected.Goal: My objective is to display the current unread message count from Intercom within my app's UI (outside of the Intercom messenger itself).Expected Behavior: When new messages arrive in Intercom conversations, the IntercomUnreadConversationCountDidChangeNotification listener should fire with the updated count. Intercom.getUnreadConversationCount() should return the correct number of unread conversations at the time of the call. Actual Behavior: Intercom.getUnreadConversationCount() consistently returns 0 (or null/undefined, please specify) even when there are clearly unread messages visible when I manually open the Intercom messenger. The Intercom.addEve

41
E
Intercom Team
S
Support AgentNew Participant
asked in Mobile SDKs
App crash cause of missing keys: android

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

132
H
S
Support AgentNew Participant
asked in Mobile SDKs
Android Crash cause of missing keys

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

435
H
S
SergeyNew Participant
asked in Mobile SDKs
Using Views in Compose issue

Recently, we have a lot of Fatal Exception: Java.lang.illeglegalstateexception.v15.15.0 and v16.3.0I attach the entire stack trace errors:          Fatal Exception: java.lang.IllegalStateException: The specified child already has a parent. You must call removeView() on the child's parent first.       at android.view.ViewGroup.addViewInner(ViewGroup.java:5401)       at android.view.ViewGroup.addView(ViewGroup.java:5216)       at android.view.ViewGroup.addView(ViewGroup.java:5156)       at android.view.ViewGroup.addView(ViewGroup.java:5128)       at androidx.compose.ui.viewinterop.AndroidViewHolder.<init>(AndroidViewHolder.android.kt:99)       at androidx.compose.ui.viewinterop.ViewFactoryHolder.<init>(AndroidView.android.kt:332)       at androidx.compose.ui.viewinterop.ViewFactoryHolder.<init>(AndroidView.android.kt:323)       at androidx.compose.ui.viewinterop.ViewFactoryHolder.<init>(AndroidView.android.kt:342)       at androidx.compose.ui.viewinterop.AndroidVi

1192
S
D
Dev PlanableNew Participant
asked in Mobile SDKs
React-Native iOS - Error in loginUserWithUserAttributes

Hi Intercom team, we receive several errors after trying to login a user with attributes using react-native sdk.We check if the user is logged in before making a Intercom.loginUserWithUserAttributes call.A short stack-trace for the error we receive: code: 102,domain: io.intercom.ios.error.network,message: Error in loginUserWithUserAttributes,name: Error,NSLocalizedDescription: HTTP Error: 400 bad requestWe send email and userId to the method call, like this: Intercom.loginUserWithUserAttributes({ email, userId }) Could you help us understand why we still get an error, I’ve run a console.log for both email and userId and both seem legit.

281
Emilygav
Intercom Team
F
Francisco GouluNew Participant
asked in Mobile SDKs
intercom-react-native not working on Expo SDK 53

Hi guys, I am having problems to upgrade from expo 52 to expo 53 due to intercom issues.In version 8.0.0, ios is not working due to  ❌ (ios/TakenosDevelop/AppDelegate.swift:1:2)> 1 | #import <IntercomModule.h> | ^ no macro named 'import' 2 | import Expo 3 | import React 4 | import ReactAppDependencyProvider This is fixed on 8.5.0 but this version uses sentry Android SDK >= 8 and clashes with sentry-react-native that uses sentry Android SDK >=7.  I am using @sentry/react-native version 6.14.0(recommended by expo)Here is a conversation related to the issue on sentry github: https://github.com/getsentry/sentry-react-native/issues/4688The error i am seeing:Error: Exception in HostFunction: No direct method <init>(Ljava/lang/String;ILio/sentry/android/core/internal/util/SentryFrameMetricsCollector;Lio/sentry/ISentryExecutorService;Lio/sentry/ILogger;Lio/sentry/android/core/BuildInfoProvider;)V in class Lio/sentry/android/core/AndroidProfiler; or its super classe

521
Emilygav
Intercom Team
H
hsoientNew Participant
asked in Mobile SDKs
Memory leak in iOS SDK (18.7.3) when presenting Messages?

Hello! We recently integrated Intercom into our iOS app (currently using Intercom 18.7.3 SDK for iOS). As I’ve been monitoring the releases, I have seen in the Xcode Organizer → Metrics → Memory a BIG spike in our app’s memory use. We have changed little in the app itself since integrating Intercom, so my investigation of the memory spike focused on Intercom.I started with the simplest exploration: use Instruments with the Allocations tool, Mark Generations, and see what happens. In my case, I tested our invocation of the Messages UX. Our app code in question looks like this (simplified): // In the ViewControlleroverride func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) { tableView.deselectRow(at: indexPath, animated: true) let action = self.sections[indexPath.section].rows[indexPath.row] switch action { case .emailfeedback: self.viewModel.sendFeedback(from: self) }}// In the ViewModel (almost; VM uses a Service class, which then this i

201
Emilygav
Intercom Team
J
Jeet VaniNew Participant
asked in Mobile SDKs
I'm currently facing a build error in my React Native Android project while integrating the @intercom/intercom-react-native package.

Here are the errors:  jetified-intercom-sdk-base-15.10.3-runtime.jar: D8: java.lang.NullPointerException: Cannot invoke "String.length()" because "<parameter1>" is nullWhat I’ve Tried: Checked build.gradle for SDK version compatibility Cleaned and rebuilt project (./gradlew clean && ./gradlew build) Searched through Intercom docs and changelogs Looked at open issues in the GitHub repo My Setup: React Native version: 072 Intercom SDK version: 15.10.3   Gradle: 8.0.1 Questions: Are these methods deprecated or moved to a different namespace? Is there a recommended way to check login state and fetch user attributes in the latest SDK? Should I downgrade to a previous version of the Intercom SDK? Any help is greatly appreciated!

562
L
K
kosmosxNew Participant
asked in Mobile SDKs
v17.1.0 on iOS 17.5 - iOS SDK Crashes on launch - NSInvalidArgumentException -[__NSArrayM insertObject:atIndex:]: object cannot be nil

*** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '*** -[__NSArrayM insertObject:atIndex:]: object cannot be nil'*** First throw call stack:(0   CoreFoundation                      0x00000001804ae0f8 __exceptionPreprocess + 1721   libobjc.A.dylib                     0x0000000180087db4 objc_exception_throw + 562   CoreFoundation                      0x0000000180393044 -[__NSArrayM insertObject:atIndex:] + 12523   Intercom                            0x00000001060eb528 IntercomSDK_saveViewHierarchy + 4969884   Intercom                            0x00000001060eadec IntercomSDK_saveViewHierarchy + 4951365   Foundation                          0x0000000180d54084 -[NSObject(NSKeyValueCoding) setValuesForKeysWithDictionary:] + 1846   Intercom                            0x00000001060eacd4 IntercomSDK_saveViewHierarchy + 4948567   Intercom                            0x00000001060eac78 IntercomSDK_saveViewHierarchy + 4947648   Intercom                           

34611
mateusz.leszkiewicz
Intercom Team
M
MayurNew Participant
asked in Mobile SDKs
Android - Fatal Exception: java.lang.IllegalStateException

We are encountering crashes on Android devices related to Intercom SDK version 15.9.1. Stack Trace:Failed to build unique file: /storage/emulated/0/DCIM/vr-unit.gif bucket_display_name=DCIM volume_name=external_primary date_modified=null date_expires=null _display_name=vr-unit.gif mime_type=image/gif _data=/storage/emulated/0/DCIM/vr-unit.gif _size=null is_trashed=0 is_pending=0 bucket_id=-2075821635 relative_path=DCIM/ android.content.ContentResolver.update (ContentResolver.java:2318)arrow_rightio.intercom.android.sdk.ui.preview.viewmodel.PreviewViewModel.saveImageOnApi29Above (PreviewViewModel.kt:201)io.intercom.android.sdk.ui.preview.viewmodel.PreviewViewModel.access$saveImageOnApi29Above (PreviewViewModel.kt:35)io.intercom.android.sdk.ui.preview.viewmodel.PreviewViewModel$saveImage$1.invokeSuspend (PreviewViewModel.kt:92)kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith (ContinuationImpl.kt:33) Device : Mostly Google PixelAndroid Version: 11, 12

211
Emilygav
Intercom Team
Y
yd-theraNew Participant
asked in Mobile SDKs
Android SDK Callback for Dismissal of Intercom Messages Screen

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?

2736
N
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.8.1

Release Date: 11-06-2025 🐛 Bug Fixes Fixes a bug where articles could render in the incorrect interface style.

51
D
D
Dominik RActive User
posted in Mobile SDKs
Dark mode breaks mobile SDK articles and help center

Despite the fact that mobile SDK does not support dark mode, the articles and some parts of the help center use dark mode features. SDK Android 16.3.0 (changelog) iOS 18.8.0 (changelog)    

121
D
J
Jarvis RoamlessNew Participant
asked in Mobile SDKs
Undefined user auto merge to identified user is not working

Hello everyone; When the iOS app launches, we log in our Intercom user as an undefined user. Later, when the user log in or creates an account with a JWT token and we login them in as an identified user through Intercom, we can't see the undefined user's messages. When we try to send a message, we get an error. I did the SDK integration correctly and the JWT token is working properly. But it's not automatically merging users' messages. How can I solve this problem? SDK Version; 18.8.0iOS: 18.4, 18.5UI Error;Something’s gone wrongCouldn’t load the conversation Intercom Request Error;Path: https://<app-id>-ios.mobile-messenger.intercom.com/messenger/mobile/conversations/215469369303322Code: 404{ "type": "error.list", "request_id": "004gb7n4n158kmpf4qeg", "errors": [ { "code": "not_found", "message": "Resource Not Found" } ]}  ​

271
Paul Byrne
Intercom Team
R
Rodrigo LessingerNew Participant
asked in Mobile SDKs
[Android] App crashing on 16.0.0

Hello, we've recently updated our SDK to the latest version (16.0.0) and we've been seeing a few crashes in production related to the in app notification. This seems to happen when showing the Full notification, as there seems to be something missing in the layout that intercom uses internally. We've just bumped to the latest version, but looking at the code, that doesn't seem to solve this particular issue.This is the stack trace we're getting:Fatal Exception: java.lang.NullPointerExceptionParameter specified as non-null is null: method io.intercom.android.sdk.m5.notification.InAppNotificationCardKt.addInappNotificationCardToView, parameter composeViewio.intercom.android.sdk.m5.notification.InAppNotificationCardKt.addInappNotificationCardToView (InAppNotificationCard.kt:3)io.intercom.android.sdk.overlay.ChatNotification.populateViewsWithData (ChatNotification.java:90)io.intercom.android.sdk.overlay.ChatNotification.display (ChatNotification.java:64)io.intercom.android.sdk.overlay.InAp

331
Emilygav
Intercom Team
K
kaganNew Participant
asked in Mobile SDKs
Android sdk crash: Missing keys: [timestamp] in '{teammate} flyttet saken til {status} {timestamp}'

Hey! We have started getting this crash recently and switching to the latest sdk(16.1.0) didnt help. Can you please help me with this? Thanks! Missing keys: [timestamp] in '{teammate} flyttet saken til {status} {timestamp}'Full crash log: java.lang.IllegalArgumentException: Missing keys: [timestamp] in '{teammate} flyttet saken til {status} {timestamp}' at io.intercom.android.sdk.utilities.Phrase.format(Phrase.java:0) 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.i

161
Emilygav
Intercom Team
Ask a question
Terms & Conditions