Skip to main content

Mobile SDKs

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

  • 403 Topics
  • 1,342 Replies
403 Topics
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.3.0

Release Date: 09-01-2025 🚀 Enhancements Added privacy policy to conversation screen. Updated icons in the more menu when you launch directly into a conversation. Updates to the Powered By Intercom view in conversations. 🐛 Bug Fixes Fixes issue around tapping on a message in a conversation to display timestamps. Fixes accessibility issue with icon colour in special notice view. Fixes an issue that could cause the typing indicator to continue displaying after a message was received. Note This release contains some beta features.

40
Brian B11
Intercom Team
2 days ago
F
Fergus FarrellNew Participant
asked in Mobile SDKs
User custom attributes with @intercom/messenger-js-sdk

I am using the @intercom/messenger-js-sdk SDK.It successfully records new users.The problem is that I cannot find how to set custom attributes for that user. I have the custom attribute `is_admin`. Here are the approaches I’ve tried:Basic objectIntercom({ app_id: APP_ID, api_base: process.env.NEXT_PUBLIC_INTERCOM_API_BASE_URL, user_id: user.id, email: user.email, user_hash: hash, is_admin: user.role.includes('admin'),});Object with custom_attributesIntercom({ app_id: APP_ID, api_base: process.env.NEXT_PUBLIC_INTERCOM_API_BASE_URL, user_id: user.id, email: user.email, user_hash: hash, custom_attributes: { is_admin: user.role.includes('admin'), }});Post instance update methodIntercom({ app_id: APP_ID, api_base: process.env.NEXT_PUBLIC_INTERCOM_API_BASE_URL, user_id: user.id, email: user.email, user_hash: hash,}

251
Emilygav
Intercom Team
1 day ago
R
Ronak DesaiNew Participant
asked in Mobile SDKs
Android Intercom Push Notification handling issue

I'm having trouble with handling push notifications from Intercom. When a push notification is received and selected, it opens the message conversation view momentarily, but then immediately redirects to the app's home screen.I am calling Intercom.client().handlePushMessage() in onResume() of the HomeActivity, but it seems like the Intercom SDK is not waiting for this method call. The issue is reproducible on the latest version (15.10.3) and the previous version (v15.9.1).Here’s the code snippet:Firebase Messaging Service class:override fun onMessageReceived(remoteMessage: RemoteMessage) {     val extras = remoteMessage.data     if (intercomPushClient.isIntercomPush(extras)) {         intercomPushClient.handlePush(application, extras)     } else {         …      } }HomeActivity class:override fun onResume() { super.onResume() Intercom.client().handlePushMessage()}It is reproducible using latest version 15.10.3 and previous v15.9.1 as well.Has anyone encountered a similar issue? A

1656
A
3 days ago
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.2.2

Release Date: 17-12-2024 🐛 Bug Fixes Resolves an issue with Fin streaming replies. Note This release contains some beta features.

131
Erin
7 days ago
K
Kirill IvanovNew Participant
asked in Mobile SDKs
Crash on attachments, Android 9

   Intercom crashes every time you try to attach any type of content (even embedded gifs) on Android 9java.lang.NullPointerException at androidx.compose.ui.node.LayoutNodeDrawScope.drawContent(LayoutNodeDrawScope.kt:49) at io.intercom.android.sdk.m5.conversation.ui.ConversationScreenKt$ConversationScreenContent$32$1$1.invoke(ConversationScreen.kt:581) at io.intercom.android.sdk.m5.conversation.ui.ConversationScreenKt$ConversationScreenContent$32$1$1.invoke(ConversationScreen.kt:580) at androidx.compose.ui.graphics.drawscope.DrawScope$record$1.invoke(DrawScope.kt:1077) at androidx.compose.ui.graphics.drawscope.DrawScope$record$1.invoke(DrawScope.kt:941) at androidx.compose.ui.graphics.layer.GraphicsLayer$clipDrawBlock$1.invoke(AndroidGraphicsLayer.android.kt:71) at androidx.compose.ui.graphics.layer.GraphicsLayer$clipDrawBlock$1.invoke(AndroidGraphicsLayer.android.kt:66

645
S
7 days ago
M
Mariusz SaramakNew Participant
asked in Mobile SDKs
[Android] Crash from release 15.8.0

I notice that we get a crash from intercom sdk. It was found in the version 15.8.3 but I notice that I can reproduce this issue from 15.8.0 to the latest version 15.9.1 I down the version to 15.7.1 and that version works.  FATAL EXCEPTION: main                                                                                                     Process: com.xxxxxxxxxxxx.grocery.staging, PID: 32714                                                                                                    java.lang.NoSuchMethodError: No static method rememberModalBottomSheetState(ZLkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/material3/SheetState; in class Landroidx/compose/material3/ModalBottomSheet_androidKt; or its super classes (declaration of 'androidx.compose.material3.ModalBottomSheet_androidKt' appears in /data/app/~~elspeVOmvltIcyF5hM5qXg==/com.xxxxxxx.grocery.staging-ezzAuVmfBiFxmCt3v8dawA==/base.apk)                                               

48310
mateusz.leszkiewicz
Intercom Team
17 days ago
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

31411
mateusz.leszkiewicz
Intercom Team
17 days ago
T
Tom WagnerConnector
asked in Mobile SDKs
Deadlock when unit testing on iOS

When running unit tests in Xcode Cloud we often get a test failure because the tests failed to start. In those cases we get a spindump indicating that there is a deadlock caused by something Intercom does as a result of [UIBarAppearance init] being called. Anyone seen something similar? It seems to be related to a global initializer so just linking against Intercom will cause the problem.  Just to be sure I’ve changed our code to not call any Intercom methods when running as part of XCTests but it appears to still be happening.

473
mateusz.leszkiewicz
Intercom Team
17 days ago
C
CalebNew Participant
asked in Mobile SDKs
Intercom working fine on Xcode Simulator builds but not loading on simulator

Edit: Title should be “Intercom working fine on Xcode Simulator builds but not loading on testflight builds” but I can't edit it or delete this.I have added the camera privacy reason. Yet on TestFlight builds Intercom does not load. I am wondering if the SDKs access to a certain URL is being blocked because it needs to be manually allowlisted somewhere in the privacy configuration? But not sure on that. Documentation does not say anything about this.Are there other reasons this may happen?

283
C
22 days ago
C
CalebNew Participant
asked in Mobile SDKs
Bug Report: Intercom overrides App tint at the top level of SwiftUI apps

Seems that when installed Intercom overrides the tint color for the whole app. There are ways around that of course but this is likely causing unexpected repercussions for SwiftUI apps using tints.

112
Jacques Reynolds
Intercom Team
22 days ago
A
Aquiles HernanNew Participant
asked in Mobile SDKs
I have a problem when I install the intercom library in react native

I wanted to know if you have any solution regarding this error?buildscript { ext { buildToolsVersion = "34.0.0" minSdkVersion = 23 compileSdkVersion = 34 targetSdkVersion = 34 ndkVersion = "26.1.10909125" kotlinVersion = "1.9.22" } repositories { google() mavenCentral() } dependencies { classpath("com.android.tools.build:gradle:4.0.1") classpath("com.facebook.react:react-native-gradle-plugin") classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") }}apply plugin: "com.facebook.react.rootproject"gradlew propertiesdistributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-8.6-all.zipnetworkTimeout=10000validateDistributionUrl=truezipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/distsI look forward to a quick response, thank you very much.

1452
A
24 days ago
C
Claude HouleNew Participant
asked in Mobile SDKs
Crash in IntercomSDK_ITBBlockListViewController

Hi!We’re experiencing a non negligible amount of crashes with our iOS app. We’re using the Intercom iOS SDK v18.2.0 (AKA the latest). As far as we can see, the user goes into the intercom integration, and at some point it crashes.Here is the crash-logs from Sentry: OS Version: iOS 18.0.1 (22A3370)Report Version: 104Exception Type: EXC_CRASH (SIGABRT)Crashed Thread: 0Application Specific Information:Expected dequeued view to be returned to the collection view in preparation for display. When the collection view's data source is asked to provide a view for a given index path, ensure that a single view is dequeued and returned to the collection view. Avoid dequeuing views without a request from the collection view. For retrieving an existing view in the collection view, use -[UICollectionView cellForItemAtIndexPath:] or -[UICollectionView supplementaryViewForElementKind:atIndexPath:]. Dequeued view: <IntercomSDK_ITBBlockCollectionViewCell: 0x1224ccc00; baseClass = UICollectionViewCell;

111
E
Intercom Team
24 days ago
D
David RappaNew Participant
posted in Mobile SDKs
Error to build in android using react native

Execution failed for task ':app:mergeExtDexDevelopmentDebug'.> Could not resolve all files for configuration ':app:developmentDebugRuntimeClasspath'.   > Failed to transform intercom-sdk-base-15.11.3.aar (io.intercom.android:intercom-sdk-base:15.11.3) to match attributes {artifactType=android-dex, asm-transformed-variant=developmentDebug, dexing-enable-desugaring=true, dexing-enable-jacoco-instrumentation=false, dexing-is-debuggable=true, dexing-min-sdk=24, org.gradle.category=library, org.gradle.dependency.bundling=external, org.gradle.libraryelements=aar, org.gradle.status=release, org.gradle.usage=java-runtime}.

381
Emilygav
Intercom Team
24 days ago
D
Didier Camus-FerlandNew Participant
asked in Mobile SDKs
Crash on launch for users on iOS 15.8

Hi!We’re using the Intercom SDK on our iOS app, currently using version 18.1.0. We’ve been getting a lot of crash reports and it seems to mostly happen to users on iOS 15.8, looking into it we found a stack trace that points to swizzling done by the Intercom SDK: Any ideas on how to fix this?

441
D
25 days ago
S
shogaryNew Participant
asked in Mobile SDKs
AirPlay Issues with Intercom API

I have determined that Our iPad app is experiencing Airplay issues that are being caused by the Intercom API. Setup:Intercom.setApiKey(apiKey, forAppId: appId)let userAttributes = ICMUserAttributes()userAttributes.userId = user.userIDIntercom.setUserHash(userHash)Intercom.loginUser(with: userAttributes) Steps to reproduce:cold launch the app Have above code run for Authenticated users Turn on Airplay to TV or Apple TV Issue: External screen is blackNote: Turning airplay off and back on solves the issue. Troubleshooting:Commenting the following lines of code solves the issue:Intercom.setUserHash(userHash)Intercom.loginUser(with: userAttributes)I have tried disabling Intercom swizzling as per your documentation but it has no affect.  Currently using Intercom 17.4.0

552
bernice
Intercom Team
26 days ago
C
Contato OficinaNew Participant
asked in Mobile SDKs
Issue with Opening Intercom Chat via Push Notification on iOS (React Native)

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

432
bernice
Intercom Team
26 days ago
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.2.1

Release Date: 11-12-2024 🐛 Bug Fixes Solves a crash in carousels. Addressed issue where video input wasn’t available in a conversation. Fixes issue where first part in a conversation would fail to show as failed in the scenario where it didn’t send. Resolved some layout issues in the conversation screen for users with large font sizes enabled. Note This release contains some beta features.

200
Brian B11
Intercom Team
1 month ago
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 chatError log for v15.10.0java.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.2java.lang.IllegalArgumentException: no paragraph (layoutCache=ParagraphLayoutCache(paragraph=null,

612
Erin
1 month ago
J
JérémieConnector
asked in Mobile SDKs
SwiftUI application using Intercom SDK cause slow launch time

We’re experiencing a slow launch time in our SwiftUI app, about 35% of the slow launch time is caused by Intercom initialization.  The stack trace indicates that multiple functions within the Intercom SDK, especially the initialization processes involving IMCCrashHandler, IMCConfig, HomeConfig, and HomeHeader, are contributing significantly to app launch latency. The UIKitCore and CoreImage components (like UIGraphicsImageRenderer and CIImage) invoked through ICAssets.backgroundImageViewWith also add processing overhead, which may impact the performance during launch.Here is the full stack trace given by XCodes tools:dyld start1. App.main() - SwiftUI2. AppDelegate.application(_:didFinishLaunchingWithOptions:) - SwiftUI3. IMCCrashHandler swizzleDidFinishLaunchingWithOptions - Intercom └ IMCCrashHandler sharedConfig - Intercom4. IntercomSDK_SentrySDK startWithConfigureOptions - Intercom5. IMCCrashHandler configureTags - Intercom6. IMCConfig sharedConfig - Intercom7. IMCConfig configFr

716
C
1 month ago
B
BohdanPodolianNew Participant
asked in Mobile SDKs
Start new conversation listener

Hello, I was wondering if there is a way to listen to the “Send Us Messages” event to track the click?SDK is used on Android - its version is 12.5.3  

484
Nathan Sudds
Expert User ✨
1 month ago
I
Irina VaaraNew Participant
asked in Mobile SDKs
[iOS] Video capture is not available since Intercom iOS SDK 17.2.0

Hello,I faced with unexpected experience when I cannot to capture video in Intercom messenger using iOS SDK since 17.2.0. Could you please help me to resolve this issue?My steps:Update iOS SDK to 18.2.0. Run the app, check that there is Intercom’s warning “Add NSMicrophoneUsageDescription...”  in Xcode console. Add NSMicrophoneUsageDescription to Info.plist according to Installation guide, step 2.  Run the app again, check the message is not printed. Open Intercom messenger, start a new conversation. Press a green plus icon. It opens an action sheet, choose Camera. The app asks only for camera permission, not microphone. Allow camera usage. Camera opens → only photo capturing is available, not video. Change SDK version to 17.1.2.  Run the app, repeat step 5, press a grey camera icon.  The app asks for microphone permission. Allow it. Camera opens. → Both options, Photo and Video, are available for choosing. Update SDK to 17.2.0, repeat steps 5-7. → Again, only photo capturing is availa

311
bernice
Intercom Team
1 month ago
Brian B11
Intercom Team
Brian B11Intercom Team
posted in Mobile SDKs
iOS SDK Release 18.2.0

Release Date: 01-11-2024 📱 New Feature Added the ability to upload files to a conversation. 🚀 Enhancements Added new API isUserLoggedIn. This enables developers to determine if a user is currently logged in to Intercom. Added new API fetchLoggedInUserAttributes. This enables developers to retrieve the attributes of the currently logged in user. 🐛 Bug Fixes Fixed some layout issues in the conversation view. Improvements to the photo previewer. Fixes some colour accessibility issues throughout the SDK. Fixes issue where clicking on the CTA in a post would not dismiss it.

1026
Brian B11
Intercom Team
1 month ago
M
madesignerNew Participant
asked in Mobile SDKs
What is a Mobile SDK?

A Mobile Software Development Kit (SDK) is a collection of tools, libraries, and APIs that help developers create apps for platforms like Android or iOS. It simplifies app development by providing pre-built components for features such as user authentication, payment systems, and analytics.Benefits of Mobile SDKs:Faster Development: Reduces coding effort with ready-to-use tools. Consistency: Ensures reliable implementation across apps. Scalability: Supports growing user bases and feature additions. Enhanced Experience: Enables features like push notifications and smooth integrations.Popular SDKs:Firebase: For analytics and crash reporting. Facebook SDK: For social login and ad integration. Apple iOS SDK & Android SDK: Native app development essentials.Mobile SDKs save time, streamline workflows, and allow developers to focus on creating innovative, user-friendly apps.

232
Nur Nahid
Super User ✨
1 month ago
C
CuraNew Participant
posted in Mobile SDKs
Issue in Latest Andorid SDK for Workflows, Workflows not updating in Messenger

Starting Android intercom SDK 15.10.2 and even in Latest 15.10.3 and 15.11.0, In Andorid messenger if a Workflow has been already triggered, it always remain there, No other Workflows get triggered afterwards.Eg. If Workflow-1 is trigger, then Workflow-2 is never triggered, even for the Rules of Workflow-2, We always see Workflow-1.This was fine until 15.10.1.  Kindly resolve this ASAP.

361
Emilygav
Intercom Team
1 month ago
Y
yd-theraNew Participant
asked in Mobile SDKs
UI Issue with Close Button in Intercom SDK on Android 15

We are currently working on our upcoming release to the Google Play Store, ensuring compatibility with Android 15. As part of this effort, we have recently updated our app to use the latest version of the Intercom SDK (15.9.1).During our testing phase, we encountered an issue specific to devices running Android 15. The problem pertains to the UI when attaching a video or image in the Intercom messenger.The "X" close button overlaps with the status bar, making it difficult to close the attachment preview.This behavior is observed only on Android 15 and seems related to the new edge-to-edge enforcement introduced in this version of Android.Here are the steps to reproduce the issue:1. Open the Intercom messenger in our app.2. Click on the attachment icon and choose Gallery.3. Select an image or video.4. Observe that the close ("X") button overlaps with the status bar, making it difficult to close the preview. You can view a screen shot of the issue here: Intercom UI Issue android 15 on at

28215
mateusz.leszkiewicz
Intercom Team
1 month ago
Ask a question
Terms & ConditionsCookie settings