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.cognigy.com/ai/agents/deploy/endpoints/overview)
- [NLU Connectors](https://docs.cognigy.com/ai/platform-features/nlu/external/nlu-connectors/overview)
- [Data Protection & Analytics](https://docs.cognigy.com/ai/agents/deploy/endpoints/data-protection-and-analytics)
- [Real-Time Translation Settings](https://docs.cognigy.com/ai/agents/deploy/endpoints/real-time-translation-settings)
- [Transformer Functions](https://docs.cognigy.com/ai/for-developers/transformers/overview)

## Specific Endpoint Settings

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.AI 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

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.

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.AI 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.

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>`.

4. Complete the Endpoint Configuration

1. In the Cognigy.AI 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)

Last modified on June 15, 2026