# Intercom Knowledge Base

> Migrate your Intercom knowledge to Quickchat AI, or run both side by side during a switch from Intercom's Fin AI.

**Migrate your Intercom knowledge to Quickchat AI in minutes.** If you're using Intercom's Fin AI and want to switch to Quickchat AI — or run both side by side — these endpoints make it seamless. Your entire Intercom Help Center (the articles that power Fin AI's responses) can be synced to Quickchat's Knowledge Base with a single API call.

**How it works:**
1. Connect your Intercom account via the [Quickchat Dashboard](https://app.quickchat.ai/) or the [Intercom App Store integration](https://www.intercom.com/app-store/apps/quickchat)
2. Use **Import Intercom Articles** to pull all your Help Center articles into Quickchat's Knowledge Base, optionally only in the languages you choose
3. Use **Refresh Intercom Articles** to keep content in sync as you update articles in Intercom
4. If you decide to disconnect, **Delete Intercom Articles** cleanly removes all synced content

This means your AI Agent immediately has access to the same knowledge that Fin AI uses, with zero manual content migration. For a full walkthrough of the Intercom integration, see the [Intercom channel guide](/docs/channels/intercom). To learn more about switching from Fin AI, visit [Quickchat as a Fin AI alternative](https://quickchat.ai/intercom-fin-ai-alternative).

## Refresh Intercom Articles

Re-fetch existing articles from Intercom and import new ones.

Articles imported with `locales` are refreshed in the same languages, and all language versions of an Intercom article are refreshed together.

**Scope: write_all**

`POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/refresh_articles`

**Request Body**

| Parameter | Description |
|-----------|-------------|
| `article_ids` <br/> array of integers | IDs of the Knowledge Base articles to re-fetch, as returned by [List Articles](/docs/api-reference/knowledge-base/articles#list-articles) with `types=Intercom`. Default: none, so no existing article is re-fetched. To refresh every article, pass all of their IDs. |
| `fetch_new_articles` <br/> boolean | Whether to fetch new articles (default: `true`) |

**Response** `200 OK` (empty JSON object). Returns `400` if an ID is not an Intercom article in your Knowledge Base.

## List Intercom Help Center Languages

List the languages your Intercom Help Center publishes, with the number of published articles in each, and the languages suggested for import (your AI Agent's language when the Help Center has it).

**Scope: read_all**

`GET https://app.quickchat.ai/v1/api/knowledge_base/intercom/locales`

**Response** `200 OK`

```json
{
  "locales": [
    { "locale": "uk", "article_count": 259 },
    { "locale": "en", "article_count": 220 }
  ],
  "suggested_locales": ["uk"]
}
```

An empty `locales` list means your Help Center doesn't publish language versions; import without `locales`.

## Import Intercom Articles

Import all articles from Intercom.

**Scope: write_all**

`POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/import`

**Request Body** (optional)

| Parameter | Description |
|-----------|-------------|
| `locales` <br/> array of strings | Help Center languages to import, such as `["uk"]`. Each language is imported as separate articles, which count toward your plan's article limit. Omit it to import one version of each article: English when available, otherwise the Help Center's default language. |

**Response** `200 OK` — Returns a list of imported article snapshots. Returns `400` if no article is published in the selected languages.

## Delete Intercom Articles

Remove all Intercom-sourced articles from the Knowledge Base.

**Scope: write_all**

`POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/delete`

**Response** `200 OK` (empty JSON object)

---
