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

> Paste your Atlassian domain, email, and API token — OpenCX pulls Confluence pages.

<Tip>
  Configure the source at [**AI Training → Data Sources**](https://platform.open.cx/data-sources).
</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 a Confluence source">
    Click **Add source → Confluence**.

    | Field         | Example                     | Where to get it                                                                                                                          |
    | ------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
    | **Domain**    | `yourcompany.atlassian.net` | Your Atlassian instance domain. No `https://`.                                                                                           |
    | **Email**     | `you@yourcompany.com`       | The Atlassian account the API token belongs to.                                                                                          |
    | **API Token** | `ATATT…`                    | Generate at [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens). The token needs Confluence read access. |
  </Step>

  <Step title="Start the sync">
    Click **Connect**. The first run does a full pull of every page the credentials can read. Large instances take longer — expect 10 minutes to an hour for thousands of pages.
  </Step>

  <Step title="Verify in AI Instructions">
    Open [**AI Training → AI Instructions**](https://platform.open.cx/ai-instructions). Pages appear under **Confluence**, each linked to its source URL in your instance.
  </Step>
</Steps>

## What gets synced

<AccordionGroup>
  <Accordion title="All pages the credentials can read" icon="file-lines">
    Whole-instance pull. Page titles, body content (converted from Confluence storage format to HTML), and the `webui` back-link.
  </Accordion>

  <Accordion title="Visibility by space type" icon="eye">
    * Personal spaces (key starts with `~`) → **internal** — the AI uses them only in agent-facing surfaces.
    * All other spaces → **public** — the AI can cite them in customer replies.

    Override per-page in AI Instructions if a specific page needs different visibility.
  </Accordion>

  <Accordion title="Full refresh, not incremental" icon="arrows-rotate">
    Each sync run is a full re-pull with overwrite. The benefit: deletions in Confluence propagate correctly. The cost: each run is heavier than an incremental pull. Typical cadence is set by Airbyte's scheduler — adjust on the connection schedule if you need it less often for a huge instance.
  </Accordion>
</AccordionGroup>

## Limits

|                       | Value                                               |
| --------------------- | --------------------------------------------------- |
| **Streams synced**    | `pages`                                             |
| **Sync mode**         | `full_refresh_overwrite`                            |
| **Sync cadence**      | Airbyte polling — typically every few hours         |
| **Credential type**   | Domain + email + Atlassian API token                |
| **Deployment**        | **Cloud only.** Server / Data Center not supported. |
| **Selective scoping** | None today — whole instance pulled                  |
| **Attachments**       | Not synced                                          |

***

## Related Documentation

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

  <Card title="Troubleshooting" icon="wrench" href="/knowledge/sources/confluence/troubleshooting">
    Auth errors, missing pages, slow syncs.
  </Card>

  <Card title="Website crawler" icon="globe" href="/knowledge/sources/website/overview">
    Fallback for scoped subsets.
  </Card>

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