# Intercom

## Setup Guide

You can create your Intercom app in the [Intercom Developer Hub](https://developers.intercom.com/).

You'll need the following information to set up your Intercom App with Konnect:

* Client ID
* Client Secret

### Prerequisites

* Developer account with [Intercom Developer Hub](https://developers.intercom.com/)

### Create an Intercom app

1. In the Intercom Developer Hub go to the `Your Apps` section
2. Click on the `New App` button and name your app
3. Select `Public App` type and then click `Save`

### Configure your Intercom app

1. Go to your App Details page and navigate to `Configure > Authentication`
2. Click the `Edit` button and check the box under the OAuth section titled `Use OAuth`
3. Click on the `Add Redirect URL` button and add the Konnect OAuth Redirect URL:\
   `https://connect.getkolla.com/oauth`
4. Navigate to `Configure > Basic Information` and note the Client ID and Client Secret for later
5. Add any permissions you will need for your integration in the `Authentication` section

{% hint style="warning" %}
Note: Intercome requires you to submit your app for approval before you can connect to your customers' accounts. It will let you test on your own account to start
{% endhint %}

### Add your Intercom app to Konnect

Get the following information from your Intercom App

* Client ID
* Client Secret 

Login to your Kolla admin portal and go to Connectors. Click on "Add New Connector" and select Intercom from the list of available connectors.

Input all the data from the previous steps and click "Create"


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getkolla.com/kolla/connector-guides/intercom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.