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

# Intercom

<Frame>
  <img class="image-center" src="https://mintcdn.com/cognigy-15abf2ba/gMdd3UtLaZzJw9j6/_assets/ai/deploy/endpoint-reference/intercom.png?fit=max&auto=format&n=gMdd3UtLaZzJw9j6&q=85&s=0f2966cb96ed1f43d53b0819943104a4" alt="Intercom Endpoint logo" width="236" height="71" data-path="_assets/ai/deploy/endpoint-reference/intercom.png" />
</Frame>

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

## Specific Endpoint Settings

<Accordion title="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. |
</Accordion>

## How to Set Up

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## 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)