Intercom Integration Troubleshooting
Below we've listed some key points on fixing common issues with Upscope's Intercom integration.
Joe avatar
Written by Joe
Updated over a week ago

To use Upscope with Intercom:

Step 1: Paste the Upscope javascript snippet below Intercom's on all pages you wish to screen share on. Want to see what the integration looks like? Go here:

Step 2: Add the Upscope Intercom app from the Intercom app store.

Test your first co-browsing session
Once Upscope is running you can begin your first screen share, during a chat with a customer, by clicking on the Upscope icon within the chat window under the apps button as shown below:

Below we cover the steps to check if you have any problems with the installation:

1. Reload Intercom and ask the customer to reload their page

Intercom will need to be reloaded after you add a new attribute. Make sure you and all your agents reload the intercom app.

The customer might already be on your site when you've added the Upscope javascript snippet. They'll need to reload the page for the snippet to be active. Once they've refreshed they'll appear within the user list and the Upscope Intercom integration will also work.

2. Make sure the code is on the page you wish to screen share on

The Upscope javascript snippet needs to be on all pages that you wish to screen share on. The most common reason for "user not found" type errors is not having the code on the page along with not having refreshed the page after you've installed Upscope for the first time.

3. Check whether Upscope sees intercom

After the page has loaded, open up the inspector / console. Then type the following:


An alert should open up with the word intercom  in it.

The alert does not have intercom  in it.

If the alert has the word undefined or null  in it, you will need to ensure that the Upscope code snippet is loaded after Intercom. All you need to do is paste our code below Intercom's.

If the alert has any other word in it, you might have multiple live chat systems installed on your website. Please get in touch with our team for help.

4. Take a look at the console log

On your page, open the console / inspector and type the following.

localStorage.debug = 'upscope:integrations'

Then, reload the page while keeping the console open. You should see debugging information about the integration.

5. Contact our team

If none of the above fixed the problem, you will need to contact our team through intercom or at

⚠️ Please provide a way for our tech team to access the page you are attempting to integrate Upscope and Intercom on, as we wouldn't be able to assist you otherwise. If you can't provide access, please provide a pastebin link with the code that loads both Intercom and Upscope.

Did this answer your question?