Popular Topics

Is there a way to log an activity labeled Intercom Ticket with the details - similar to that of the current Intercom Conversation event.  Currently we can see any/all activity by KNOWN contacts, which is what we were hoping to see for the tickets -named differently of course and would allow us to build workflows based on these activity events in HUBSPOT. This would allow transparency across the business to see these insights without creating duplicate tickets, which I do see can actually be done based on this article in the community if there are specific workflows and teams that would be working in HubSpot vs. Intercom.  However for our business, we were planning to have all support/service and escalation processes handled via Intercom.  Is this something that can be done, if so how and what is the best practice here?

Hello everyone,I’m Darshan Hiranandani, I’ve been working on an API that allows me to create articles with titles and main content. So far, I’ve been able to create articles successfully, but I’m facing a challenge when it comes to uploading images or attachments to these articles.I know some platforms like Intercom have hosting services that allow you to upload and store attachments, but I’m not sure if they offer something similar for direct image uploads.Can anyone share their experience or suggestions on how to upload images or attachments via REST API? Any help or ideas on how to handle this would be greatly appreciated!Thanks in advance!RegardsDarshan Hiranandani

I own an iOS application that supports Teacher - student lessons. So I need a 1:1 chat where the student can be connected directly with the teacher and the teacher will only see their open chats with students that have started conversations with them. I did some quick prototyping on iOS and I see I can pretty easily set it up where the student can open up a global message queue (Messages Space) but how can I limit their scope to a particular conversation? Is that available in the iOS SDK or will I have to reach for some admin routes? 

Hello everyone,I’m Darshan Hiranandani, working on an application that has thousands of users, and I need to regularly create and update these users in Intercom, at least once a week. The problem is that the current Contacts API doesn't fully support bulk updates and comes with some significant limitations:It requires my app to track whether a contact already exists before performing a POST or PUT request. The API rate limits are very restrictive, especially for medium-sized user bases (166 requests per 10 seconds). It also requires storing the Intercom ID for updates, which isn’t ideal since my app uses an external ID for users. Additionally, the manual import process requires mapping each attribute, which is cumbersome and prone to errors.Given these constraints, I’m looking for a better approach or solution to enable bulk creation and updating of users in Intercom. Has anyone worked around these issues or found a better solution for handling bulk user operations?Would love to hear y

Hi there! We’re using the JavaScript implementation for web as followed on the docs, and we have some users reporting that they are either seeing a semi-colon added on the upper-right corner of the screen, or a full side panel that’s being injected when the “Need help?” badge is being shown. Please see the attached photos for a visual reference.Is this a bug that you are already on track or have a fix for? We’ve tried trying this to a simple page without any components, but it doesn’t seem to fix the issue. Any intel on this would be very helpful. Thanks!  

Hi all, I am working on a feature attempting to automate the creation of few contacts in our workspace by hitting the post endpoint for `{intercom_api_url}/contacts`.My current data body looks like:{ email: providerData.providerEmail, name: providerData.providerName, phone: providerData.providerPhoneNumber, // These custom attributes throw an error in intercom when added. custom_attributes: { Is_provider: true, // provider_start_date: new Date().toDateString(), }, }Although the Is_provider custom attribute exists in the test workspace, my call keeps throwing me a 400 error with Bad Request.Please help with understanding why this is happening and if possible a potential fix. This would allow us to onboard a lot more contacts very quickly.

Hello,I’m looking for any possible ways we might be able to create a Hubspot Ticket from within Intercom.Our use case is this: our Support Team directly supports our customers via chat and email in Intercom. If an issue is identified that requires Engineering help, we create a Ticket in Hubspot for Engineering to pick up.I’m looking for solution so that our Support Reps don’t have to keep a tab open in Hubspot to manually create tickets.Any possible ways to do this?

On the intercom landing page, we have some pinned articles. If you open the pinned article, and try to tap the "X" button, it will not close the article. However, swiping down will still allow you to close that article. This behavior only occurs on iOS - it does not occur on Android.Some notes:If you go from the landing page and select the "Help" to go to the collection of articles (rather than the pinned article on the landing page), then those articles CAN be closed via the "X" button. This behavior occurred on the latest react native SDK version, 19.1.2 We checked and found we had to regress to 19.0.3 to resolve the problem - however we cannot use this older version, otherwise we will lose the iOS 26 changes.

Hi,I am trying to use Custom Objects to show the orders of a users that message us, either through email or whatsapp. I created the custom object Order with the relevant attributes. I then created an external reference in People and Conversations, referencing Order via a one to many relationship. Then I created a webhook that triggers when a conversation is created or a reply is given. The webhook calls a service that posts to /custom_object_instances/OrderWe post an external_id and custom_attributes according to https://developers.intercom.com/docs/references/rest-api/api.intercom.io/custom-object-instances/createcustomobjectinstances -d '{ "external_id": "123", "external_created_at": 1392036272, "external_updated_at": 1392036272, "custom_attributes": { "order_number": "ORDER-12345", "total_amount": 99.99 }Now the documentation does not say anything about how to link the Order to People.Fin says, you need to put a customer property inside custom_attributes, fi

Hi everyone 👋We’re building a Canvas App Sheet for a live Intercom Messenger integration. Our goal is to let logged-in users view and update profile data — specifically values like First Name, Last Name, Primary Chapter, and SpotMe_Id — all of which are being passed into Intercom via a custom embed snippet.✅ These custom attributes show correctly on the user profile inside Intercom.🚫 But when the Canvas App loads via /sheet, the contact.custom_attributes payload does not include these fields (we checked with full logging of req.body). We tried accessing them via: jsconst contact = req.body.contact || req.body.context?.contact || {}; const attrs = contact.custom_attributes || {}; Even though we can see the correct attributes in Intercom, attrs only contains empty/default values like Member, or Global.We’ve verified: intercomSettings in the embed includes the attributes (they appear in the user profile) We’re using open_mode: "conversation" in our Canvas App button App is launched

We’re looking for a way to mass import our knowledge base articles from Zoho Desk into Intercom. What’s the best way to accomplish this? 

We’re Intercom customers and we need to build a variation of the checklist on our own page, not inside the Messenger widget. I assumed the most obvious solution would be to consume an API that returns these checklists, similar to how it works with articles. Do we have anything like that? I couldn’t find it in the documentation.This is very important for us!

We are experiencing an issue with the Intercom Android Mobile SDK. The issue is that the in-app message notifications appear underneath the navigation bar at the bottom of the screen, as opposed to sitting directly above the navigation icons.Our app currently uses the SDK version 17.1.1 – however we have been able to reproduce the issue even on the latest version of the SDK (17.3.0). The release notes for 17.2.0 indicate the issue was resolved.  Upon further investigation, it appears the issue stems from the fact our app still uses AppCompatActivity as our base Activity, instead of ComponentActivity which is what the sample app uses. I tested this theory but switching the ComponentActivity to an AppCompatActivity in the sample app and the bug was surfaced there as well. As it would not be trivial for us to switch our base Activity to ComponentActivity, I'm wondering if there are any further solutions currently being worked on for the next release of the Intercom SDK that would resolve

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!

We’re unable to safely download the Intercom iOS SDK to build with our application using Swift Package Manager. Adding the Intercom Package to our project on a clean SPM cache returns the following error:checksum of downloaded artifact of binary target 'Intercom' (83f26a63832df968d0279ecdd03d8e5039ebf9bb91a9e0b1783cf184101c5a82) does not match checksum specified by the manifest (b87d95eabe645523f417b9051c20151ca7720c93116b163435c2ce1e87aa65ac)fatalError There is a ‘patch’ raised by someone on a fork of the project, but as this is not an official fix by Intercom we do not consider this a safe approach to include your SDKThis looks very similar to an issue on your forum that was raised (and fixed) last year:  This is urgent for us as Intercom provides a critical piece of functionality that our customers rely on to report issues and get customer support.Please can this be fixed as quickly as possible as we are blocked from releasing new version of our app without this.

👋 Hi everyone! Karla here from the Technical Support Engineering team. Today, we’re diving into how to use Custom Actions and Custom Objects to reference People data — the kind of data that sticks with your users across multiple conversations. We’ll walk through setting up a Prescription Tracker workflow — a simple example that shows how to store and display data for each user inside Intercom Messenger. Let’s start with the why. Imagine you’re tracking prescriptions for your customers. If a user chats today about Tylenol, you’d want that stored on their profile. Then, if they return next week about Ibuprofen, that data should build on top of their record — not replace it. That’s what People data does: it acts like a long-term memory for your users. Each conversation can reference one item (the chat about Tylenol, for example), but the People record holds the full history of every prescription that’s ever been added for that user. Let’s start by checking out what my test API returns wh

Hi Intercom Team,After updating our app to Intercom iOS SDK 19.3.2, several developers on our team have encountered issues where Swift methods (e.g. loginUser(with:), logout(), etc.) are no longer properly inferred or recognized by the compiler.Details Integration: Swift Package Manager (official intercom-ios-sp repo) Project Type: Pure Swift (no Objective-C bridging) Issue:  Xcode only exposes the Objective-C versions of the APIs (e.g. loginUserWithUserAttributes:success:failure:). Error Messages: “Cannot infer type of function call” “No exact matches in call to function 'loginUser'” Troubleshooting Tried Cleared DerivedData and SPM caches Removed and re-added the Intercom package Could you please confirm: The officially supported Xcode versions for SDK 19.3.0? Whether there’s a known issue or upcoming patch related to this Swift interface mismatch when using SPM?

When updating to io.intercom.android:intercom-sdk version 17.2.0If R8/Proguard is enabled the following error occurs on the build:Missing class lombok.Generated (referenced from: io.ably.lib.network.HttpBody io.ably.lib.network.HttpResponse$HttpResponseBuilder.body and 94 other contexts) This does not happen on version 17.1.1  It looks like maybe something changed in the build but didn’t include a rule in it’s consumer-rules.pro?  gemini says: -dontwarn lombok.** may fix it?

We are experiencing a critical issue with Intercom integration in our web application.After a user logs in without a full page reload, the Intercom widget appears and lists existing conversations. However:- Existing conversations cannot be opened- Creating a new message often fails- Network tab shows intermittent 403 Forbidden errors with the message: “App suspended”- - Specifically on requests to: POST /messenger/web/conversations/:idIf the user reloads the page after login, everything works as expected:- Conversations open normally- New messages are sent successfullyContext:- We are using the react-use-intercom package for frontend integration.- The app performs a soft reboot after login (without reloading the browser tab). Call shutdown and boot with intercomUserJwt then- When I had this issue it was always because the app_id passed was 'undefined'We are unsure whether this issue originates from the `react-use-intercom` package or from Intercom itself.If you have any suggestions on

Release Date: 04-11-2025 🐛 Bug Fixes Fixed an issue where tapping the close button on an article in a conversation would not dismiss the article. Fixed an issue where tapping on a link in an article would not open the link. Fixed an issue where carousels were not dismissing correctly. Fixed an issue where reactions to articles were not being handled correctly.

Can I please have a code sample on how to implement dark mode (or switch themes) for Android. E.g. something likeimport io.intercom.android.sdk.ui.theme.ThemeMode;Intercom.client().setThemeMode(ThemeMode.DARK);I noted that Dark Mode was enabled on Android SDK v17.0.0

We are having issues when using presentContent for presenting an article, the close button does not close the modal, though it can be closed with a drag down.any workaround?

When using `Intercom.presentContent(.article(id: articleId))` with the current version of the iOS SDK (19.3.0), the app presents an empty view for a second or two and then crashes after outputting the following.*** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[IntercomSDKPrivate.ArticleHostingController setContentDelegate:]: unrecognized selector sent to instance 0x12aeec000'*** First throw call stack:(0x1863e28c8 0x1833597c4 0x18647e838 0x18cfb1484 0x18635f4f8 0x1863673a0 0x10915b2f4 0x18645dd64 0x10913e12c 0x10787c63c 0x1078962d0 0x1078b74c0 0x10788c778 0x10788c6b4 0x186384520 0x186336d14 0x186335c44 0x225726498 0x18bcb0ddc 0x18bc55b0c 0x18bd91860 0x10bad5448 0x10bad53bc 0x10bad7308 0x1833aee28)Exception received: NSInvalidArgumentException - -[IntercomSDKPrivate.ArticleHostingController setContentDelegate:]: unrecognized selector sent to instance 0x12aeec000 

Im trying to install the Messenger app in Salesforce Community. I found this old article but it seems incomplete.  Im wondering if I could get help with this integration.  I Edit the Head Markup in the Salesforce Community with the pre-filled script.Then in a lightning component I tried to Instantiate the Intercom instance:import { LightningElement, api } from 'lwc';export default class IntercomApp extends LightningElement { connectedCallback() { try { window.intercomSettings = { api_base: 'https://api-iam.intercom.io', app_id: 'my-app-id-here' }; } catch (error) { console.error(error); } }}I get this warning:frame-modern.812d2c17.js:1 [Intercom] The App ID in your code snippet has not been set. Set it to your App ID found in settings to complete installation: https://app.intercom.com/a/apps/_/settings/web With this message below:[Intercom] Launcher is disabled in settings or current page does not ma

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