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

# Zendesk Data Ingestion

> Import Zendesk tickets and help center articles as knowledge sources

Turn your Zendesk history into AI knowledge. Import resolved tickets, help center articles, and attachments so your Guru can answer questions based on real support conversations and documentation.

## Why Ingest Zendesk Data?

<CardGroup cols={2}>
  <Card title="Learn from Past Tickets" icon="ticket">
    Your resolved tickets contain answers to questions that will come up again
  </Card>

  <Card title="Knowledge Base Sync" icon="book">
    Keep your Guru updated with your latest help center articles
  </Card>

  <Card title="Attachments Included" icon="paperclip">
    Images and text files attached to tickets are indexed too
  </Card>

  <Card title="Auto-Sync" icon="rotate">
    Backfill jobs automatically import new content on a schedule
  </Card>
</CardGroup>

## What Gets Indexed

| Content Type    | What's Included                                    |
| --------------- | -------------------------------------------------- |
| **Tickets**     | Ticket body, all comments, resolution notes        |
| **Articles**    | Full article content from help center              |
| **Attachments** | Images and text files attached to tickets/articles |
| **Metadata**    | Ticket status, tags, and dates for context         |

<Note>
  **Self-hosted:** This integration is in beta for selected users.
  **Cloud:** Available to all users.
</Note>

***

## Setup

<Steps>
  <Step title="Create Zendesk API Token">
    1. Go to your Zendesk API settings:

    ```
    https://{your-subdomain}.zendesk.com/admin/apps-integrations/apis/zendesk-api/settings/tokens
    ```

    2. Click **Add API token**
    3. Copy the token
  </Step>

  <Step title="Navigate to Zendesk Integration">
    Go to **Gurubase Dashboard** → Select your Guru → **Integrations** → **Ingestions** → **Zendesk**
  </Step>

  <Step title="Connect Your Zendesk">
    Fill in the connection details:

    | Field          | Value                                                 |
    | -------------- | ----------------------------------------------------- |
    | **Domain**     | Your Zendesk domain (e.g., `yourcompany.zendesk.com`) |
    | **User Email** | Your Zendesk account email                            |
    | **API Token**  | The token you created in Step 1                       |

    <Frame>
      <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/zendesk/zendesk-fields.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=4ed735a5e0b0ba80827ad1e0a6312514" alt="Zendesk Integration Fields" width="1780" height="1282" data-path="images/ingestion/zendesk/zendesk-fields.png" />
    </Frame>
  </Step>
</Steps>

***

## Adding Zendesk Content

After connecting, you can import content in two ways:

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/zendesk/modal.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=69cc83d28b8863e68ba94771fb8b3e7e" alt="Add Zendesk Content Modal" width="3020" height="1646" data-path="images/ingestion/zendesk/modal.png" />
</Frame>

### Option 1: Add Individual Tickets/Articles

Best for importing specific tickets or articles by URL.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/zendesk/individual.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=a80af0530c06d6637ae0da9cf20de62f" alt="Add Individual Zendesk Data" width="3018" height="1634" data-path="images/ingestion/zendesk/individual.png" />
</Frame>

| Setting          | Description                                |
| ---------------- | ------------------------------------------ |
| **Content Type** | Choose "Fetch Tickets" or "Fetch Articles" |
| **URLs**         | Enter ticket or article URLs, one per line |
| **Date Range**   | Optionally filter by creation date         |

### Option 2: Create Backfill Job

Best for bulk imports and automatic ongoing sync.

<Frame>
  <img src="https://mintcdn.com/gurubase/VtcaSrKf-gN2CVzi/images/ingestion/zendesk/backfill.png?fit=max&auto=format&n=VtcaSrKf-gN2CVzi&q=85&s=0517c209d3f48044a8f6bcc411e14386" alt="Create Zendesk Backfill Job" width="3016" height="1612" data-path="images/ingestion/zendesk/backfill.png" />
</Frame>

| Setting           | Description                                         |
| ----------------- | --------------------------------------------------- |
| **Content Type**  | Tickets or Help Center articles                     |
| **Sync Interval** | How often to check for new content (minimum 1 hour) |
| **Sync Now**      | Manually trigger an immediate sync                  |

<Tip>
  Use backfill jobs to keep your Guru automatically updated with new resolved tickets and published articles.
</Tip>

***

## Viewing Indexed Content

Imported tickets and articles appear as individual sources in your Guru's data sources list. You can:

* View the exact content that was indexed
* Remove specific tickets or articles
* Check when content was last synced

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Zendesk Bot" icon="headset" href="/integrations/bots/zendesk">
    Deploy Gurubase as a Zendesk app for agents
  </Card>

  <Card title="Jira Ingestion" icon="jira" href="/integrations/ingestion/jira">
    Import Jira tickets as knowledge sources
  </Card>

  <Card title="Confluence Ingestion" icon="confluence" href="/integrations/ingestion/confluence">
    Import Confluence pages
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Add more knowledge sources
  </Card>
</CardGroup>