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

# Intercom

> Connect Intercom to Minimal AI

Connect Intercom to Minimal AI by creating an app in Intercom's Developer Hub and adding its credentials to the Intercom integration on our platform. You will copy the app's **access token** and **client secret** into Minimal AI, and configure **webhooks** so Intercom sends conversation events to Minimal.

## Create an app in the Developer Hub

<Steps>
  <Step title="Open the Developer Hub">
    In Intercom, go to **Settings > Integrations > Developer Hub**.

    <Frame>
      <img src="https://mintcdn.com/minimalai/WiWW5v5SPdv0vcL0/images/integrations/intercom/1-intercom-settings-developer-hub.png?fit=max&auto=format&n=WiWW5v5SPdv0vcL0&q=85&s=183ec56eecfb5605b1bf40247a2032d0" alt="Intercom settings with the Developer Hub option under Integrations" width="1024" height="727" data-path="images/integrations/intercom/1-intercom-settings-developer-hub.png" />
    </Frame>
  </Step>

  <Step title="Create a new app">
    On the **Your apps** page, click **New app** and create an app for your workspace.

    <Frame>
      <img src="https://mintcdn.com/minimalai/WiWW5v5SPdv0vcL0/images/integrations/intercom/2-developer-hub-your-apps.png?fit=max&auto=format&n=WiWW5v5SPdv0vcL0&q=85&s=38a03a174259e1a656be937f4cb090b0" alt="Developer Hub Your apps page with the New app button" width="1024" height="466" data-path="images/integrations/intercom/2-developer-hub-your-apps.png" />
    </Frame>
  </Step>
</Steps>

## Add the credentials to Minimal AI

Open your app and go to **Configure > Authentication**. You will find the access token and client secret here.

<Frame>
  <img src="https://mintcdn.com/minimalai/WiWW5v5SPdv0vcL0/images/integrations/intercom/3-authentication-access-token.png?fit=max&auto=format&n=WiWW5v5SPdv0vcL0&q=85&s=47d84c2a59b74df7fd8ba3195ade9a0b" alt="Intercom app Authentication page showing the access token, OAuth client secret, and permissions" width="1024" height="549" data-path="images/integrations/intercom/3-authentication-access-token.png" />
</Frame>

<Steps>
  <Step title="Copy the access token">
    Copy the **access token** and paste it into the Intercom integration in [Dashboard > Integrations](https://gominimal.ai/dashboard/integrations).
  </Step>

  <Step title="Copy the client secret">
    Generate (if needed) and copy the **client secret**, then add it to the same Intercom integration in Minimal AI.
  </Step>
</Steps>

<Warning>
  Never share your access token or client secret with third parties. Only paste them into Minimal AI's Intercom integration.
</Warning>

## Configure webhooks

In your Intercom app, go to **Configure > Webhooks** and set the endpoint URL to:

```text theme={null}
https://gominimal.ai/api/webhook-ingress/intercom
```

Subscribe to the following topics:

* `conversation.admin.replied`
* `conversation.operator.replied`
* `conversation.user.created`
* `conversation.user.replied`
* `ticket.created`

Once the credentials are saved in Minimal AI and the webhooks are active, Intercom conversations will flow into Minimal AI.