Intercom.PNG

Within our Cognigy.AI platform you're able to connect your Cognigy Resources to your Intercom platform by using our Intercom Endpoint integration. This allows you to create a bot with Cognigy.AI that can answer support requests from Intercom when your agents are not online or even replace them.

By creating an Intercom Endpoint in Cognigy.AI, you can utilize the power of chatbots to respond to customers outside of your agents' working hours.

This tutorial covers the necessary steps for creating and connecting an Intercom Endpoint. If you want to get information about assigning a Flow to the Endpoint and setting up the Data Management see Endpoints.

Requires an Intercom Subscription

This guide assumes that you are already have an active Intercom subscription.

Requires a free Intercom user

You need to have an Intercom user that you can use for the bot. The bot will use this user for its replies.

Two Step Preparation Process

1 Create an Intercom Endpoint in Cognigy.AI.
2 Integrate the Intercom Endpoint with your Intercom Platform

1 Create an Intercom Endpoint

Location: Cognigy.AI

The first thing you need to do is to create an Intercom Endpoint in Cognigy.AI. In order to do this, navi

gate to your Project, click on the button in the lower left corner and create an Endpoint.

createIntercomEndpoint.PNG

Figure 1: Creating an Intercom Endpoint

After creating your Endpoint, you should be navigated to the Endpoint configuration of your Intercom Endpoint. Here you need to set the Flow that the Endpoint should point to, and you can change the NLU Connector of the Endpoint.

URL.PNGFigure 2: Obtaining the Endpoint URL from the Intercom Endpoint

Now that you have created the Intercom Endpoint, all that is left to do is to connect it to Intercom. The Intercom Endpoint contains Intercom Settings which are three settings we need in order to connect to your Intercom Platform. The settings are:

  • An Access Token
  • The admin ID of your bot
  • The Hub Secret for your Webhook

The next chapter will describe where you can find these settings in your Intercom Platform.

2 Integrate the Intercom Endpoint with your Intercom Platform

Location: Intercom Platform

Requirements
âś” Endpoint URL

2.1 Creating an App in the Developer Hub

In order to connect your Intercom Endpoint to your Intercom Platform you first have to create an app with a webhook in the Intercom Developer Hub so that all messages sent to your Intercom is also sent to your Cognigy.AI Flow. Do this by opening Settings > Developers in your Intercom Platform and clicking the Developer Hub link.

c27e261-Screenshot_from_2019-02-14_17-22-43.png
Figure 3: Link to the Developer Hub

93f7d28-Screenshot_from_2018-10-09_16-10-39.png
Figure 4: Navigating to the Developer Hub

You are now ready to create an app. Click on the New app button and fill in the necessary information into the form:

a72faad-Screenshot_from_2019-02-14_17-24-41.png
Figure 5: Create Intercom App Form

2.2 Creating the webhook

In the created app, you need to navigate to the webhook page. To create the webhook, you first need to copy the EndpointURL of your Intercom Endpoint which will be used as the request endpoint URL. You can find the EndpointURL in your Intercom Endpoint in the Cognigy.AI User Interface.

ff0c547-Screenshot_from_2019-02-14_17-27-34.png
Figure 6: Create webhook

You then need to select the topics you want to subscribe to. Here you have to select the conversation.user.created and the conversation.user.replied topics. Remember to click on the Save button in the top right corner

2.3 Getting the access token

You now have to navigate to the Authentication page. Here you can optionally edit the page to disable some permissions that the Intercom Endpoint don't need - the only permission the Endpoint needs is the "Write Conversations" and "Read Conversations" permissions. After changing permissions, you need to copy the Access Token at the top of the page to save it in your Intercom Endpoint in the Cognigy.AI User Interface (see final step).

32ac116-Screenshot_from_2019-02-14_17-38-30.png
Figure 7: Getting the Access Token

 

2.4 Getting the Hub Secret

You can now get the Hub Secret (also called Client Secret) from your Intercom App. To find this, navigate to the Basic information page in the Intercom App and copy the Client Secret. You have to insert in your Intercom Endpoint in Cognigy.AI (see final step).

32fc9d8-Screenshot_from_2019-02-14_17-44-41.png
Figure 9: Getting the Client Secret

2.5 Getting the Bot User ID

The Cognigy.AI bot needs its own Intercom user in order to be able to respond to messages. This user will be the user that your customers interact with in the Intercom Webclient. You therefore need to either use an existing user on your Intercom team or create a new user. After creating the user, navigate to the user's profile in Intercom and copy the admin ID. The admin ID is the 7-digit number in the page URL of the profile, e.g. 2672346 in the URL https://app.intercom.io/a/apps/<redacted>/admins/2672346.

9fe0014-Screenshot_from_2018-10-09_16-31-00.png
Getting the admin ID of the bot

After retrieving the admin ID, you need to paste it into the Bot User ID setting in the Intercom Settings of your Intercom Endpoint (see final step below).

2.6 Complete the Intercom Endpoint Settings

đź”— In Cognigy.AI

Navigate back to the Intercom Endpoint you created earlier in Cognigy.AI and open the Intercom Settings dropdown menu. Here you need to enter all of the credentials gathered in the previous steps including the  Access TokenBot User ID and the Hub Secret. You can also set a message delay to make a small pause before bot messages are sent.

IntercomSettings.PNGFigure 8: Saving the Access Token in the Cognigy.AI Endpoint Intercom Settings Menu

You are now finished connecting your Intercom Endpoint with your Intercom Platform! Open your Intercom Webclient on your website and send a message - you will now get a reply from your Flow. You can read the next guide for tips and tricks related to managing the bot's response times and more.


Comments

0 comments

Please sign in to leave a comment.

Was this article helpful?
0 out of 0 found this helpful