> ## Documentation Index
> Fetch the complete documentation index at: https://docs-classic.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom

![Intercom Endpoint logo](https://mintcdn.com/cognigy-docs-legacy/RomCLoWcsmr9N2pz/_assets/ai/deploy/endpoint-reference/intercom.png?fit=max\&auto=format\&n=RomCLoWcsmr9N2pz\&q=85\&s=a61d0233114658d9ef6c2da8812f64e6)

The Intercom Endpoint enables you to connect your AI Agent to the [Intercom platform](https://app.intercom.com/).

## Prerequisites

* Access to the [Intercom platform](https://app.intercom.com/).

## Generic Endpoint Settings

Learn about the generic Endpoint settings on the following pages:

* [Endpoints Overview](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/overview)
* [NLU Connectors](https://docs-classic.cognigy.com/ai/platform-features/nlu/external/nlu-connectors/overview)
* [Data Protection & Analytics](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/data-protection-and-analytics.md)
* [Real-Time Translation Settings](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/real-time-translation-settings.md)
* [Transformer Functions](https://docs-classic.cognigy.com/ai/for-developers/transformers/overview)

## Specific Endpoint Settings

> [accordion] Intercom Settings
>
> | **Parameter** | **Description** |
> | - | - |
> | Access Token | The token generated by your Intercom app that has the necessary permissions to communicate with Intercom. |
> | Bot User ID | The unique identifier of the Intercom teammate that will be used as your Intercom bot. |
> | Hub Secret | The client secret provided by Intercom. The secret allows Cognigy to authenticate and communicate with your Intercom bot. |
> | Message Delay | A delay in milliseconds for each letter in a message. This parameter allows you to control the typing speed of the Intercom bot. |

## How to Set Up

> [accordion] 1. Create an Intercom Endpoint
>
> 1. In the left-side menu of your Project, click **Deploy > Endpoints**.
> 2. On the **Endpoints** page, click **+ New Endpoint**.
> 3. In the **New Endpoint** section, do the following:
>    1. Select the **Intercom** Endpoint type.
>    2. Specify a unique name.
>    3. Select a Flow from the list. Save changes.
> 4. Go to the **Configuration Information** section and copy the URL from the **Endpoint URL** field.

> [accordion] 2. Create an App
>
> 1. Log in to your [Intercom account](https://app.intercom.com/).
> 2. Go to **Settings > Home > Integrations**, then click **Developer Hub**.
> 3. Click the app you want to use with Cognigy or create a new one.
> 4. In the app, go to **Configure > Webhooks**. Paste the copied Endpoint URL into the **Endpoint URL** field. Click **Send a test request**.
> 5. Go to **Configure > Basic information**. Copy the client secret from the **Client secret** field.
> 6. Go to **Configure > Authentication**. Make sure `Read Conversations` and `Write Conversations` are enabled. Copy the access token from the **Access token** field.

> [accordion] 3. Create a Teammate
>
> 1. In the Intercom interface, go to **Settings > Home > Workspace**, click **+ Add teammate**, then **+ Add new teammates**.
> 2. Enter an email address for your bot, for example, `bot@yourcompany.com`. Click **Continue and set permissions**.
> 3. Set the role and permissions. Grant limited permissions to your bot if you want to restrict access to inboxes or admin settings. Click **Send Invite**.
> 4. Accept the invitation via email. Open the teammate's profile and copy the Admin ID from the URL. The Admin ID is the 7-digit number in the URL: `https://app.intercom.io/a/apps/<app-id>/admins/<admin-id>`.

> [accordion] 4. Complete the Endpoint Configuration
>
> 1. In the Cognigy interface, go to the **Intercom Endpoint** you created.
> 2. In the **Access Token** field, paste the access token you copied from Intercom.
> 3. In the **Bot User ID** field, paste the Admin ID of the Intercom teammate you created.
> 4. In the **Hub Secret** field, paste the client secret you copied from Intercom.
> 5. *(Optional)* Set a **Message Delay** to control the typing speed of your bot. Save changes.

## More Information

* [Cognigy Help Center: Intercom Deployment](https://support.cognigy.com/hc/en-us/articles/360016183040-Intercom-Deploy-an-Endpoint)
* [Cognigy Help Center: Intercom Managing a Bot](https://support.cognigy.com/hc/en-us/articles/360016183200-Intercom-Managing-the-Intercom-Bot)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.