Intercom Integration Setup

Requirements

In order to successfully set up the Intercom integration, you must make sure that —

a) You have integrated Receptive with your product, either through the Javascript integration or via the API.

b) Your Intercom integration must share the same User IDs as Receptive. You can ensure this in two ways:

1. Install the Receptive widget into your app, which will pass the same User IDs to Receptive and Intercom.
2. Create a user in Receptive through the API using the same User ID for Receptive and Intercom.

User IDs

For the integration to work correctly, the user IDs must be the same for both Receptive and Intercom.

In other words, the "user_id" attribute in "window.intercomSettings" must be set to a customer's user ID in Receptive.

You provide Receptive with the user IDs when you configure the Receptive integration. You should then ensure that you supply Intercom with the same IDs. 

You can find an example of the "window.intercomSettings" object here.

You can find your customer's user ID by going to their profile page, either by searching their name or going to Customers > [Account Name] > [User Name].

Setup

Follow these steps to successfully set up the Intercom integration:

1: Navigate to Settings > Third Party Integrations and click "Authenticate with Intercom".

2: You then need to authorize access to Receptive.

3: You'll be redirected to the Intercom app store listing for Receptive.

That's all it takes. You'll now be able to use Receptive from within your Intercom chat widget.

Adding the Button

We recommend adding the "submit feedback" button to your Intercom messenger home screen. This will make it easier for your customers to submit feedback, and save your Support team a lot of time.

To do this, head to your Messenger Settings in Intercom.

Click on the "Users" tab, and then click on "Add an app".

Select Receptive, and then "Ask customer to submit request".

This places a button on your Intercom Messenger home screen that will look like this:

Automating with Answer Bot

Intercom's Answer Bot enables you to automatically reply to messages you receive. You can use this with our Intercom integration to save even more time and effort.

From your Intercom dashboard, navigate to Operator > Answer Bot.

From here you can click on "New Answer". You should then fill in the questions or statements your customers often use when they want to provide you with feedback.

Examples might include:

• "I have an idea..."
• "I think you should..."
• I have some feedback..."

For your answer, you need to insert the Receptive app, and select the "Ask customer to submit request" option.

Once you're happy with the question and answer, you can click on "Set Live" and your new answer bot will start doing all the hard work for you.

For more information on how to use the Intercom integration after you've set it up, head here.