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

# Connect Intercom

> | Field | Example | Where to get it | |-------|---------|-----------------| | Access token | dG9rOjVj… | Intercom Developer Hub → your app → Access Token.

<Tip>
  Configure the source at [**AI Training → Data Sources**](https://platform.open.cx/data-sources). Not the same place as the [ticketing integration](/integrations/intercom/connect) — this is knowledge only.
</Tip>

## Set up the sync

<Steps>
  <Step title="Open Data Sources">
    Go to [**AI Training → Data Sources**](https://platform.open.cx/data-sources).
  </Step>

  <Step title="Add an Intercom source">
    Click **Add source → Intercom**.

    | Field            | Example                | Where to get it                                                                                                                                                   |
    | ---------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Access token** | `dG9rOjVj…`            | Intercom Developer Hub → your app → **Access Token**. Needs permission to read segments. Can be the same token as the ticketing integration.                      |
    | **Start date**   | `2024-01-01T00:00:00Z` | ISO 8601 format `YYYY-MM-DDTHH:mm:ssZ`. Earliest creation date to include. Defaults to `2020-01-01T00:00:00Z` if omitted in the API, but the UI asks for a value. |
  </Step>

  <Step title="Start the sync">
    Click **Connect**. Segments typically sync in seconds to minutes — most workspaces have tens, not thousands, of segments.
  </Step>

  <Step title="Verify in AI Instructions">
    Open [**AI Training → AI Instructions**](https://platform.open.cx/ai-instructions). Items appear under **Intercom**. If the folder is empty, see [Troubleshooting](/knowledge/sources/intercom/troubleshooting).
  </Step>
</Steps>

## Limits

|                              | Value                                                                                          |
| ---------------------------- | ---------------------------------------------------------------------------------------------- |
| **Streams synced**           | `segments`                                                                                     |
| **Sync mode**                | `full_refresh_append` on `updated_at`                                                          |
| **Sync cadence**             | Airbyte polling — typically every few hours                                                    |
| **Credential type**          | Personal access token (no OAuth in this surface)                                               |
| **Articles / conversations** | Not synced today — use the [Website crawler](/knowledge/sources/website/overview) for articles |
| **Multi-workspace**          | One Intercom workspace per connection                                                          |
| **Selective scoping**        | None — all segments the token can read are synced                                              |

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Intercom overview" icon="intercom" href="/knowledge/sources/intercom/overview">
    What this source does and what it doesn't.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/knowledge/sources/intercom/troubleshooting">
    Sync silently empty, auth failures.
  </Card>

  <Card title="Intercom integration" icon="intercom" href="/integrations/intercom/overview">
    Inbox, conversations, handoff.
  </Card>

  <Card title="Connect a knowledge source" icon="brain" href="/knowledge/sources/overview">
    Compare sources.
  </Card>
</CardGroup>