# Intercom: Deploy an Endpoint **Cognigy Support** October 24, 2022 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](https://docs.cognigy.com/docs/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, navigate to your Project, click on the button in the lower left corner and create an Endpoint. _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. _Figure 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](https://www.intercom.com/) **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. _Figure 3: Link to the Developer Hub_ _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: _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. _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). _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). _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//admins/2672346`. _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 Token`, `Bot User ID` and the `Hub Secret`. You can also set a message delay to make a small pause before bot messages are sent. _Figure 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.