Install Intercom for logged-in users

Install the Intercom Messenger and start having conversations with your users.

Emanuele avatar
Written by Emanuele
Updated over a week ago

It only takes a few minutes to install the Messenger on your website. Once installed, you’ll be able to welcome, onboard, and support customers as they become loyal users of your app.

  • The Messenger is easily customized to suit your brand.

  • You choose who can see the Messenger, and how they can start conversations.

  • The Messenger connects directly to apps you use, like Google Meet, Statuspage, Stripe and 60 others.

You'll need an Intercom trial or subscription to install the Messenger.


Install the JavaScript code

First, go to the the web settings and ensure that the web integration is enabled:

When this is disabled, all requests to Intercom will fail.

Next, copy the code snippet under Install for logged in users on the same page. This snippet is pre-populated with your unique workspace ID, so it's ready to go:

How to use the code

  • Edit the code to send Intercom the email address or user_id and signed-up date of the user who is currently logged in.

  • Paste the code right before the closing body tag of every page where you want the Intercom Messenger to appear.

  • After adding the code, open your app and the Messenger will appear.

  • You can also send Intercom Custom attributes about your users.

Important:

  • You can identify users with either a user_id or email address.

  • If you send a user_id and an email address, the user_id will take priority when identifying your users.

  • If you choose to use user_id, email address can still be used to identify your users in Intercom, so we recommend enabling identity verification.

  • If you're using the zoom CSS on your webpage, make sure that Intercom's widgets are not receiving it.


Installing Intercom for a client

If you don't have access to the Intercom workspace, you can grab the JavaScript code here 👇 You will need to manually replace WORKSPACE_ID with the unique workspace ID for your Intercom account.

<script>
var APP_ID = "WORKSPACE_ID"; // Replace this with your workspace ID
window.intercomSettings = {
app_id: APP_ID,
name: "Jane Doe", // Full name
email: "customer@example.com", // Email address
created_at: 1312182000 // Signup date as a Unix timestamp
};
</script>
<script>(function(){var w=window;var ic=w.Intercom;if(typeof ic==="function"){ic('reattach_activator');ic('update',w.intercomSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Intercom=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://widget.intercom.io/widget/' + APP_ID;var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();</script>

The value for created_at should be the date that a customer signed up for your app, site or service, sent as a Unix timestamp.


Install Intercom in a desktop environment?

It is technically possible to include Intercom in a desktop application, however, we do not officially support desktop environments. The Intercom Messenger has been designed and developed to run in a web environment (list of supported browsers). These web environments support specific web functionality that our Messenger depends on (e.g. Javascript and CSS).

Electron and similar technology enables you to build desktop applications using web technology, and it is possible to install Intercom in these types of applications -- there are even community libraries to help install Intercom in Electron environments, however, it's not something we officially support.

What’s next?


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?