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

# Crisp

> Import help center articles from Crisp into AGO

Import help center articles from Crisp into AGO. Sync your customer support documentation for AI-powered assistance.

## Overview

| Feature            | Details                        |
| ------------------ | ------------------------------ |
| **Authentication** | API Token                      |
| **Content Type**   | Help center articles           |
| **Hierarchy**      | Categories, sections, articles |
| **Filter Support** | By category, section           |

## Prerequisites

* Crisp account with Help Center enabled
* API token with read access

## Getting Your API Token

1. Log in to Crisp
2. Navigate to **Settings** > **API**
3. Generate a new token with Help Center read permissions
4. Copy the token

## Configuration

### Required Fields

| Field     | Description     | Example          |
| --------- | --------------- | ---------------- |
| `api_key` | Crisp API token | `your-api-token` |

### Optional Fields

| Field               | Type    | Description                    |
| ------------------- | ------- | ------------------------------ |
| `import_categories` | boolean | Import category structure      |
| `import_sections`   | boolean | Import section structure       |
| `import_articles`   | boolean | Import article content         |
| `category_filter`   | array   | List of category IDs to import |
| `section_filter`    | array   | List of section IDs to import  |

## Setup Steps

1. Navigate to **Knowledge** → **Sources**
2. Click **Create Source**
3. Select **Crisp** as the source type
4. Enter your API token
5. Configure import options:
   * Enable/disable categories, sections, articles
   * Add filters if needed
6. Click **Save**
7. Click **Sync** to start importing

## Filtering Content

### Import Specific Categories

```json theme={null}
{
  "import_categories": true,
  "import_articles": true,
  "category_filter": ["category-id-1", "category-id-2"]
}
```

### Import Specific Sections

```json theme={null}
{
  "import_sections": true,
  "import_articles": true,
  "section_filter": ["section-id-1", "section-id-2"]
}
```

## Content Hierarchy

Crisp help centers are organized as:

```mermaid theme={null}
flowchart TD
    A[Help Center] --> B[Category 1]
    A --> C[Category 2]
    B --> D[Section A]
    B --> E[Section B]
    D --> F[Article 1]
    D --> G[Article 2]
    E --> H[Article 3]
    C --> I[Section C]
    I --> J[Article 4]
```

This hierarchy is preserved in AGO.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Failed">
    * Verify your API token is correct
    * Check the token hasn't expired
    * Ensure the token has Help Center permissions
  </Accordion>

  <Accordion title="No Content Imported">
    * Verify you have published articles
    * Check import flags are enabled
    * Review filters aren't too restrictive
  </Accordion>

  <Accordion title="Partial Import">
    * Check category/section filters
    * Verify all content is published (not draft)
  </Accordion>
</AccordionGroup>

## Related Documentation

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