Firstly you will need to choose how you would like to install the messenger. If you select Code snippet, React, Angular, Vue, Ember or Shopify as the installation method, you'll have the choice of installing Intercom for website visitors without logins.

The instruction for installing Code snippet, React, Angular, Vue, Ember or Shopify will update as you select each of the options. For the methods listed that allow the installation for both Users with logins and Visitors without, you will need to copy the code snippet for each installation method you wish to use.

For Users with logins, you will need to switch on the toggle Enable connection to messenger to continue to the installation code.

Now follow the instructions given for the method you selected. For example, if you selected Shopify you'll see the steps required for this installation method.

If you selected the Code snippet, React, Angular, Vue, or Ember method, you'll be provided with an NPM package containing a code snippet to copy and paste into the codebase of your own app. This snippet is pre-populated with your unique workspace ID, so it's ready to go.

You can also find the package directly on the NPM site.

There are several other templates available such as including the code snippet in a Basic JavaScript or Single-page app, or you can also use the Rails gem to install the snippet.

Click Copy code and paste it before the </body> tag on every page you want the Messenger to appear on your app.

After adding the code, you can visit any page where you have installed the messenger and it should appear in the bottom right hand corner or you can use the Check installation option in the install process.

To secure your messenger and prevent anyone from impersonating your logged-in users or seeing their conversations, you will need to choose how you installed your Messenger (with an NPM package or with an integration).

If you’ve installed Intercom with Shopify, you can go ahead and enforce Identity Verification using the Enforce Identity Verification for messenger toggle, with no configuration needed.

For Code snippet installations, you'll need to generate an HMAC on your server for each logged-in user and send it to Intercom.

First, choose how you want to uniquely identify your users: via User ID or Email. Then choose the server-side language or framework you're using to get your code to generate an HMAC for your app.

Everywhere you load user data and have a window.intercomSettings code snippet, add a new attribute called user_hash and assign the HMAC code to it.

We offer an updated code snippet which includes HMAC value as a parameter sent to the Intercom Messenger. Simply click Copy code to use it.

Once you’ve set up Identity Verification and started sending user_hashes for each user, check the installation is working as expected.

Click on Check the installation. This button will display a table of the domains where the Messenger has been found, as well as their Identity Verification status. A green tick indicates success, and a warning triangle indicates that the Messenger was not found with the correct Identity Verification settings.

You can also use our hash checker to verify that the user hash values you're sending over to Intercom are correct, ensuring that Identity Verification will work correctly. Here, you can verify what the expected user hash is based on: user_id or email (if you're not using user_id's).

Once you’ve correctly modified your Messenger code and see no errors, you can enforce Identity Verification by toggling on the option Enforce Identity Verification for messenger. This can take up to 10 seconds to activate.

Once enforced, any requests without user hashes will be rejected, preventing impersonation of your users via the Messenger.

Firstly you'll need to choose your installation platform of choice; iOS, Android or React Native. All chosen platforms have steps specific to that platform and you'll be provided with options for how to install Intercom into your mobile apps and some code snippets to help with the installation.

The next step will be to Initialize Intercom within the codebase of your mobile app. You can also manage your API keys in this step.

You will then need to follow the platform specific instructions to integrate the Intercom messenger in your mobile app.

The Check installation button at the end offers a success notification if the Messenger has been successfully found for your chosen installation, or it indicates whether something has gone wrong.

To secure the Messenger with Identity Verification on mobile, you will first need to choose the installation platform; iOS, Android or React Native.

If you choose React Native, then similar to the installation step, you will be asked to choose which platform you wish to install the React Native SDK with (iOS or Android).

Code snippets and instructions are provided on how to generate a HMAC code (Hash-based Message Authentication Code) within your backend codebase and provide it to the Intercom Messenger. This HMAC code is used by Intercom to verify the authenticity of user interactions in the Messenger.

An additional code snippet is provided so you can include the HMAC when initializing Intercom within your mobile app.

For React Native, we provide an example code snippet for how you can use the HMAC code to initialize Intercom with identity verification.

The final step in the identity verification process is to enforce identity verification. Once this is done all requests from the Messenger which do not include the valid HMAC code will be rejected.

Within this step you will again have the option of the installation platform; iOS or Android. You can configure push notifications from this section, but it will not guide you through the process. Instead our developer docs should be used for push notification setup:

iOS Instructions

Android Instructions

React native is not offered as an option for mobile push notifications.

This optional step is marked as complete when push notifications have been detected as set up for either an iOS or an Android app.