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

# Intercom

> Import help center articles from Intercom into AGO

Import help center articles from Intercom into AGO. The connector supports two modes: authenticated API access (for private or owned content) and public help center scraping (no API credentials needed).

| Feature            | Details                                               |
| ------------------ | ----------------------------------------------------- |
| **Authentication** | API Token (Mode 1) or None (Mode 2 - public scraping) |
| **Content type**   | Help center articles                                  |
| **Multi-language** | Yes                                                   |
| **Hierarchy**      | Yes (collections > sections > articles)               |
| **Attachments**    | Yes (embedded images)                                 |

## Prerequisites

**For API Access Mode:**

* Intercom workspace with Developer Hub access
* API access token with help center permissions
* Help center with published articles

**For Public Scraping Mode:**

* A publicly accessible Intercom help center URL
* No credentials required

## Setup Steps

### Mode 1: API Access

1. In Intercom, go to **Settings** > **Developers** > **Developer Hub**
2. Create a new app or use an existing one
3. Go to **Configure** > **Authentication** and copy your Access Token
4. In AGO, navigate to **Knowledge** > **Sources** > **Create**
5. Select **Intercom** as the connector type
6. Enter your **Access Token**
7. Optionally specify a **Help Center ID** (auto-detected if not provided)
8. Save and run a manual sync

### Mode 2: Public Scraping

1. In AGO, navigate to **Knowledge** > **Sources** > **Create**
2. Select **Intercom** as the connector type
3. Leave the API key field empty
4. Enter the help center **subdomain** (e.g., `your-company` for `intercom.help/your-company`)
5. Enter the **locale** code (e.g., `en`, `fr`)
6. Save and run a manual sync

## Configuration

| Setting            | Required | Default       | Description                                  |
| ------------------ | -------- | ------------- | -------------------------------------------- |
| API key            | Mode 1   | —             | Intercom API access token                    |
| Subdomain          | Mode 2   | —             | Help center subdomain                        |
| Locale             | Mode 2   | —             | Language code for public scraping            |
| Help center ID     | No       | Auto-detected | Specific help center to import               |
| Collection filter  | No       | All           | List of collection IDs to import             |
| Section filter     | No       | All           | List of section IDs to import                |
| Import collections | No       | Yes           | Whether to import collection-level documents |
| Import sections    | No       | Yes           | Whether to import section-level documents    |
| Import articles    | No       | Yes           | Whether to import article documents          |

### Finding Collection and Section IDs

1. Navigate to your Intercom Help Center in the Intercom app
2. Open a collection or section
3. The ID is in the URL: `https://app.intercom.com/a/apps/{app_id}/articles/collections/{collection_id}`

## What Gets Imported

The connector imports three levels of content:

```mermaid theme={null}
flowchart TD
    A[Help Center] --> B[Collection: Getting Started]
    A --> C[Collection: Features]
    B --> D[Section: Quick Start]
    B --> E[Article: Overview]
    D --> F[Article: Your First Steps]
```

* **Collections**: Top-level containers (can be nested)
* **Sections**: Organizational units within collections
* **Articles**: The actual help content, converted from HTML to Markdown

## Best Practices

* Start with a collection filter to import a subset, then expand
* Schedule regular syncs to keep content fresh
* Only published articles are imported — drafts are skipped

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication failed">
    * Verify your access token is valid and not expired
    * Check the token has help center read permissions
    * Regenerate the token in Developer Hub
  </Accordion>

  <Accordion title="No content imported">
    * Verify your help center has published articles (drafts are skipped)
    * Check collection/section filters aren't excluding all content
    * For public mode, verify the subdomain and locale are correct
  </Accordion>

  <Accordion title="Missing images">
    * Verify network access to Intercom's image CDN
    * Re-sync to refresh image references

    ***
  </Accordion>
</AccordionGroup>

## Related

* [Knowledge Connectors](./knowledge-connectors) — All available connectors
* [Knowledge Source Management](../features/knowledge-source-management) — Managing sources