Skip to main content

Mobile SDKs

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

  • 428 Topics
  • 1,421 Replies
428 Topics
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.7.0

Release Date: 11-04-2025 🚀 Enhancements We've added a new API to enable setting JWTs in the Messenger. This should be called before any user login. To learn more go here. Resolved some differences between the registration of unidentified and identified users of iOS and Android. Both platforms now have matching implementations.

140
Brian B11
Intercom Team
O
Oleh StasulaNew Participant
asked in Mobile SDKs
macOS SDK

Are there any plans to have macOS SDK in the near future? Specifically I want to use it for embedding the help center inside the app.

562
J
M
Matias TebeleConnector
asked in Mobile SDKs
Build error on Android using React Native

Please help. I cannot build a release apk/aab, I’m getting the following error: > Task :app:compileReleaseKotlin FAILED e: Incompatible classes were found in dependencies. Remove them from the classpath or use '-Xskip-metadata-version-check' to suppress errors e: file:///Users/builder/.gradle/caches/transforms-4/a23eb7edad52ffdf2e2ff09828f4ac13/transformed/jetified-intercom-sdk-base-15.15.1-api.jar!/META-INF/intercom-sdk-base_release.kotlin_moduleModule was compiled with an incompatible version of Kotlin. The binary version of its metadata is 2.1.0, expected version is 1.9.0. Classes that weren't resolved: > com.google.common.util.concurrent.ListenableFuture I’m using the latest version of the library (8.3.0), and my build.gradle is: buildToolsVersion = "35.0.0"minSdkVersion = 23compileSdkVersion = 35targetSdkVersion = 35ndkVersion = "26.1.10909125"kotlinVersion = "1.9.22"

487
mateusz.leszkiewicz
Intercom Team
C
CurwerNew Participant
asked in Mobile SDKs
java.lang.NoSuchMethodError: No static method FlowRow

Hi, So I’ve implemented the Intercom SDK into our Android app the past few days and stumbled in to a strange thing. The SDK crash as I’m trying to open the write message view with this error. java.lang.NoSuchMethodError: No static method FlowRow(Landroidx/compose/ui/Modifier;Landroidx/compose/foundation/layout/Arrangement$Horizontal;Landroidx/compose/foundation/layout/Arrangement$Vertical;IILandroidx/compose/foundation/layout/FlowRowOverflow;Lkotlin/jvm/functions/Function3;Landroidx/compose/runtime/Composer;II)V in class Landroidx/compose/foundation/layout/FlowLayoutKt; or its super classes (declaration of 'androidx.compose.foundation.layout.FlowLayoutKt' appears in /data/app/~~MDeJzUHvf74b7jpNmGq6Rw==/com.sveasolar.staging-7N_jvukfhGCaqNo-t2IqvQ==/base.apk) at io.intercom.android.sdk.m5.conversation.ui.components.row.QuickRepliesKt.QuickReplies(QuickReplies.kt:38) at io.intercom.android.sdk.m5.conversation.ui.components.row.QuickRepliesKt.ComposerSuggestions(QuickReplies.kt:88) at io.

1406
M
G
Gil GoldenbergNew Participant
asked in Mobile SDKs
iOS SDK Crash when sending photo

Hi - We exprience a crash in the latest version of the iOS SDK version 18.6.3 The way to reproduce the crash:1. Open Intercom in the app, start a new chat (or existing one).2. In the conversation choose to add a photo (from library or from camera)3. Before choosing to send - take the internet off (by turning on airplane mode)4. Add the photo5. Tap the ! to try again - but take no action.6. Restore the internet by disable airplane mode7. Wait for Intercom to restore the connection and send the image automatically and after the image is shown as sent (not grayed out) - Tap Try again8. crash! Reproduced 100% of the times. ScreenReco...3-39_1.MP4

936
mateusz.leszkiewicz
Intercom Team
C
Cristi ConstantinNew Participant
asked in Mobile SDKs
[Android][Intercom SDK - 15.9.0] PdfRender crash

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.platform.AndroidUiDispatcher.access$performTrampolin

965
mateusz.leszkiewicz
Intercom Team
S
Somnath MandhareNew Participant
asked in Mobile SDKs
[iOS Native] When App is closed and push notification is clicked, the chat/post does not open in the app.

We are facing following issue in our iOS Native app: When the app is closed and the user clicks on the Intercom’s Push Notification, the app opens up but the chat/post opens momentarily and closes. This only happens when the app is closed and notification is clicked, it works fine if the app is in the background/active state. In our case when the app is opened via Push Notification in the app's closed state, main view get refreshed after data fetching. I have done all the Push Notification configuration as per the doc: https://developers.intercom.com/installing-intercom/ios/push-notifications We are using iOS SDK Intercom version: 17.1.2 Similar kind of issue was resolved by our Android Team by using Intercom.client().handlePushMessage() . However, such a method does not exist in the iOS Intercom SDK.

2626
mateusz.leszkiewicz
Intercom Team
M
Matias TebeleConnector
asked in Mobile SDKs
Prevent users from opening multiple conversations doesn't work

Hi! I have the “Prevent users from opening multiple conversations” option enabled in Intercom settings, but when calling Intercom.presentMessageComposer(); from my React Native app, it always creates a new conversation instead of navigating to the existing one. Is this the expected behavior, a known issue, or am I missing something in the implementation?What’s the best way to handle this scenario? Thanks!

333
M
K
Kostas TsalikisNew Participant
asked in Mobile SDKs
IllegalStateException The specified child already has a parent. You must call removeView() on the child's parent first

We are getting a great number of crashes on the Android version 14.1.0.This seems to happen to the conversation_list RecyclerView. You can find the stack trace bellow: 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:4471) at android.view.ViewGroup.addView(ViewGroup.java:4312) at android.view.ViewGroup.addView(ViewGroup.java:4252) at android.view.ViewGroup.addView(ViewGroup.java:4225) at androidx.compose.ui.viewinterop.AndroidViewHolder.setView$ui_release(AndroidViewHolder.android.kt:97) at androidx.compose.ui.viewinterop.ViewFactoryHolder.<init>(AndroidView.android.kt:332) at androidx.compose.ui.viewinterop.ViewFactoryHolder.<init>(AndroidView.android.kt:312) at androidx.compose.ui.viewinterop.AndroidView_androidKt$createAndroidViewNodeFactory$1.invoke(AndroidView.android.kt:247) at androidx.compose.ui.viewinterop.AndroidView_androidKt$createAndroidVi

14206
R
J
JuanFragaNew Participant
asked in Mobile SDKs
[Android] IllegalStateException in TaskStackBuilder when processing push notifications

Hi Intercom team, We're encountering a crash in our production app related to the Intercom SDK when processing push notifications. The error occurs in TaskStackBuilder.getPendingIntent() with the following stack trace: Fatal Exception: java.lang.IllegalStateException: No intents added to TaskStackBuilder; cannot getPendingIntent at androidx.core.app.TaskStackBuilder.getPendingIntent(TaskStackBuilder.java:333) at androidx.core.app.TaskStackBuilder.getPendingIntent(TaskStackBuilder.java:313) at io.intercom.android.sdk.m5.push.ConversationDeepLinkRouterKt.buildBasePendingIntent(ConversationDeepLinkRouter.kt:85) at io.intercom.android.sdk.m5.push.ConversationDeepLinkRouterKt.buildIntentForDeepLinkScreen(ConversationDeepLinkRouter.kt:42) at io.intercom.android.sdk.m5.push.ui.DeepLinkStylePushUIKt.buildDeepLinkNotification(DeepLinkStylePushUI.kt:44) at io.intercom.android.sdk.m5.push.IntercomNotificationHandler$processDeepLinkPushNotification$1.invoke(IntercomNotificationHandler.kt:69) at io

953
J
P
Praneeth DhanushkaNew Participant
asked in Mobile SDKs
Mobile carousel dismissing automatically on app start for logged-in users – React Native, Expo

We're experiencing an issue where the mobile carousel feature gets dismissed automatically on app start for logged-in users. Our app is built with React Native and Expo. To isolate the issue, we tested with a minimal project containing only an empty screen and Intercom login. The issue does not occur on the first app launch (since Intercom login hasn't been triggered yet). However, once the user is logged in and we send a carousel from Intercom, reopening the app causes the carousel to briefly appear before getting dismissed. We also ensured that Intercom login is only called on the first launch, as a support ticket suggested that calling it repeatedly might be causing the issue. Despite this, the problem persists. Additionally, we've attached a video demonstrating the issue: The splash screen appears first The carousel appears briefly The carousel gets dismissed Our white screen is displayed Similar issue is mentioned in

220
P
D
Damiano ColluNew Participant
asked in Mobile SDKs
Broken UI and unable to send any message on latest Intercom SDK for React Native (v8.3.0)

Hi Intercom We are trying to update the Intercom SDK for our app to the latest version, currently still on version 2.0.1 We are using React Native with Expo (version 51.0.39), and it works fine with version 2.0.1 (we are using the Expo plugin from version 8 of the React Native package), but if we try to update to the latest version, we get strange behaviors on iOS: For some users, during testing, some buttons are missing (for example the “close” button on the top left is missing, you can actually touch it but the icon is missing) Can’t send messages Can’t upload files from Google Drive Other users had a black screen that went away after restarting the app (all of these tests were made with a release build deployed to TestFlight for iOS and Play Store as closed beta) This issue is not happening on all devices and not for all users (we had issues on iPhone 11 Pro with iOS 18.3.1, but was working fine on an iPhone 16 Pro with iOS 18.2.0) This is how we have configured the Explo plugin: [

270
D
A
AxelNew Participant
asked in Mobile SDKs
Expo 50 With Official Plugin Realtime Chat Not Working

Hi there, I've just installed the latest version of the Expo plugin (6.8.1). Everything is mostly working, but there are some issues. I've noticed problems with push notifications, and I'm unsure if they are related to the following: 1. We're unable to retrieve the unread message count correctly. The listener isn't working, and even when the app is open, new messages aren't being fetched.2. In chat, replies from an "agent" aren't showing up in real-time. To see new messages, we have to close and reopen the conversation, which disrupts the chat experience. Any advice on these issues would be appreciated. Thank you

38513
mateusz.leszkiewicz
Intercom Team
N
Nikos KleidisNew Participant
asked in Mobile SDKs
Expo - Push notifications not working

Hello, We are currently migrating our react-native app to Expo and we are facing some issues with Intercom push notifications. We are using: "@intercom/intercom-react-native": "8.1.0", "expo": "52.0.28", And in app.config.ts, this is our intercom setup: '@intercom/intercom-react-native',{ appId: process.env.EXPO_PUBLIC_SECRETS_INTERCOM_APP_ID, androidApiKey: process.env.EXPO_PUBLIC_SECRETS_INTERCOM_ANDROID_API_KEY, iosApiKey: process.env.EXPO_PUBLIC_SECRETS_INTERCOM_IOS_API_KEY} We have followed the rest of the setup mentioned on github. It seems that the chat works when we open it from the app. The user can send and receive messages as expected. The problem is that the push notifications don’t seem to work at all. We don’t receive any notification when the app is on the background or closed. Could you please advice on what we can check? Thank you, Nikos

2586
mateusz.leszkiewicz
Intercom Team
M
Melvyn HillsNew Participant
asked in Mobile SDKs
Empty article pages using Android SDK

Using latest Android SDK with RN wrapper (tested 15.14.0 and 15.15.0), navigating to any article renders only an empty page (along with the emoji feedback footer). Video capture: https://www.dropbox.com/scl/fi/dqbc23sucijn5juajx9vd/intercom-android-article.mov?rlkey=ve8k12jphvlgizheo2qxr5bmv&dl=0

996
mateusz.leszkiewicz
Intercom Team
M
michael_leapNew Participant
asked in Mobile SDKs
Intercom crashes using Android SDK 15.11.2 on when attempting to open a chat or start a new chat

I recently updated my intercom version from v15.10.0 to v15.11.2 because my app started to crash whenever a user tries to type a message. After upgrading, my app crashes whenever a user opens a chat or tries to start a new chat Error log for v15.10.0 java.lang.IllegalArgumentException: offset(1) is out of bounds [0, 0] at androidx.compose.ui.text.MultiParagraph.requireIndexInRangeInclusiveEnd(MultiParagraph.kt:913) at androidx.compose.ui.text.MultiParagraph.getCursorRect(MultiParagraph.kt:748) at androidx.compose.ui.text.TextLayoutResult.getCursorRect(TextLayoutResult.kt:553) Error log for v15.11.2 java.lang.IllegalArgumentException: no paragraph (layoutCache=ParagraphLayoutCache(paragraph=null, lastDensity=InlineDensity(density=2.8125, fontScale=1.0)), textSubstitution=null) at androidx.compose.foundation.text.modifiers.TextStringSimpleNode.draw(TextStringSimpleNode.kt:418) at androidx.compose.ui.node.LayoutNodeDrawScope.drawDirect-eZhPAX0$ui_release(LayoutNodeDrawScope.kt:110) at and

1263
K
E
erickreutzNew Participant
asked in Mobile SDKs
Opening React Native app from Intercom push notification presents Intercom chat UI before the app is "ready"

I have a problem where I’m using expo-splash-screen to show a splash screen while I do loading tasks before presenting the application. The problem is that when the app receives a push notification from Intercom and we open the app from that notification Intercom presents the chat UI before the splash screen has been dismissed and the app UI has been shown. I imagine this is happening because `intercom-ios` does the handling of its push notifications internally and has not knowledge of whether the app is “ready” or not. How can we fix this?

692
M
K
Karlis LapsinsNew Participant
asked in Mobile SDKs
iOS SDK universal link keeps opening Safari

In our app we are sending Intercom Posts with universal links in them and opening a link from a post within the app does both - triggers the deeplink action and also opens Safari. In our AppDelegate we return true from application:continueUserActivity:restorationHandler: and even when we completely remove all deeplink related logic and the method contains nothing but return true it still opens Safari, this behavior contradicts to what's written here. We have IntercomUniversalLinkDomains configured in the Info.plist file. Expected behavior: Do not open Safari when a url is matched with an entry from IntercomUniversalLinkDomains and application:continueUserActivity:restorationHandler: returns true. iOS SDK version 16.2.3

3573
Y
M
Melvyn HillsNew Participant
asked in Mobile SDKs
Presenting secondary-level collections doesn't work on iOS SDK

Presenting secondary-level collections doesn't work on iOS SDK (opens the root help center) but works fine on Android SDK. Presenting top-level collections works as expected on both platforms.

100
M
T
ThiloNew Participant
asked in Mobile SDKs
Displaying of collections seems broken in react-native-intercom

Hey, After migrating from "@intercom/intercom-react-native": "^3.0.5", to latest version "@intercom/intercom-react-native": "^4.0.1", the displaying of specific helpcenter collections does not work anymore. Old code: Does not work after updating the SDK const res = await Intercom.displayHelpCenterCollections([‘1234567’])// true New code: Also does not work with the latest SDK const collections = await Intercom.fetchHelpCenterCollections();/**[ { "id": "1234567", "title": "FAQ" }]*/ const collectionIds = collections.map(_ => _.id);// [ "1234567" ] const collectionContent = IntercomContent.helpCenterCollectionsWithIds(collectionIds);/**{ "type": "HELP_CENTER_COLLECTIONS", "ids": [ "1234567" ]}*/const res = await Intercom.presentContent(collectionContent);// true The problem is the same for both methods:displayHelpCenterCollections and presentContent return true, but no Intercom popup is opened.

2893
M
M
Matias TebeleConnector
asked in Mobile SDKs
Latest version of intercom-android breaks API 34 RN apps

In the last version 15.15.0 of Android you updated androidx.activity:activity-compose to 1.10.1, which now requires to compile against version 35 of the Android APIs. Error below: ```Execution failed for task ':app:checkDebugAarMetadata'.> A failure occurred while executing com.android.build.gradle.internal.tasks.CheckAarMetadataWorkAction > 3 issues were found when checking AAR metadata: 1. Dependency 'androidx.activity:activity-ktx:1.10.1' requires libraries and applications that depend on it to compile against version 35 or later of the Android APIs. :app is currently compiled against android-34. Also, the maximum recommended compile SDK version for Android Gradle plugin 8.2.1 is 34. Recommended action: Update this project's version of the Android Gradle plugin to one that supports 35, then update this project to use compileSdk of at least 35. Note that updating a library or application's compileSdk (which allows newer APIs to be used) can be done separately from updating targetSdk

1671
Shaq Payne
Intercom Team
J
JuanFragaNew Participant
asked in Mobile SDKs
Android SDK - Uploaded videos to Intercom chat lose audio during processing

Hello Intercom team, I’m reaching out regarding an issue where videos uploaded to chat lose their audio during processing. The preview of the video shows sound, but once uploaded, the audio is missing. The issue occurs consistently, regardless of the video source (recorded directly or uploaded from the gallery). Could you please help us investigate if this is a known issue or if there’s something we’re missing? Any guidance or steps to resolve this would be greatly appreciated. Thank you in advance for your support!

271
Jacques Reynolds
Intercom Team
I
irisrNew Participant
asked in Mobile SDKs
content-available = 1 so we can add badge count

I need "content-available": 1 added to the payload, so we can handle the badge counter at our application

101
conor
Innovator ✨
M
Mai DevelopmentNew Participant
asked in Mobile SDKs
Intercom React Native unread message count not updated

Hi, We are developing a React Native app with Intercom integration using the https://www.npmjs.com/package/@intercom/intercom-react-native package. We want to get the unread message count for a user to show a notification when the app is open and the user receives a new Intercom message.We have tried using the addEventListener with IntercomEvents.IntercomUnreadCountDidChange but the passed in callback does not get invoked when new messages are received. We also tried calling the getUnreadConversationCount method and that returns the initial count of messages when our app starts and the user is logged in into Intercom, but subsequent calls always returns the initial value event when new messages are received in Intercom. Calling logout and login again in Intercom and then calling getUnreadConversationCount returns an updated count, so it looks like a bug in your code, or are we doing something wrong on our end? Thank you,Mikael Amborn

612
R
A
AdnanNew Participant
asked in Mobile SDKs
Deep links on Intercom push notifications for iOS do not send the user to the correct page.

Package: @intercom/intercom-react-native: ^3.0.3 When a push notification is sent via Intercom, with a deep link, the deep link opens correct on android (it opens to the correct in-app page when the app is in the background and the notification is clicked, as well as when the app is closed and the notification is clicked). However, on iOS, if the notification is clicked while the app is closed, the notification does not send the user to the correct page, it simply sends them to the home page (the page they would have landed on if they had simply opened the app by itself). If the notification is clicked while the app is backgrounded however, it does send them to the correct page. Anyone have any idea why this behaviour might be happening?

3825
M
Ask a question
Terms & ConditionsCookie settings

Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings