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

# Confluence

> Connect Atlassian Confluence and sync wiki pages into your chatbot's knowledge base.

Pull content from your Confluence spaces and keep it synced automatically.

## Prerequisites

* An Atlassian Confluence Cloud instance
* Your Confluence **email** and an **API token**

## Connecting Confluence

<Info>
  Confluence is connected **per-user**, not per-chatbot. Connect once on the Integrations page.
</Info>

<Steps>
  <Step title="Go to Integrations page">
    Navigate to **Integrations** in the sidebar.
  </Step>

  <Step title="Click Add on Confluence">
    The connection dialog opens with three fields.
  </Step>

  <Step title="Create an API token">
    If you don't have one:

    1. Go to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
    2. Click **Create API token**
    3. Label it (e.g. "FIFE.BOT")
    4. Copy the token
  </Step>

  <Step title="Enter credentials">
    | Field     | Example                             |
    | --------- | ----------------------------------- |
    | Site URL  | `https://yourcompany.atlassian.net` |
    | Email     | `you@company.com`                   |
    | API Token | *(paste from step 3)*               |
  </Step>

  <Step title="Click Connect">
    FIFE.BOT validates the credentials and saves the connection.
  </Step>
</Steps>

## Adding Confluence as a Knowledge Source

<Steps>
  <Step title="Open Knowledge Base tab">
    Go to your chatbot → **Knowledge Base** tab.
  </Step>

  <Step title="Click Add Source → Confluence">
    Select your Confluence connection.
  </Step>

  <Step title="Browse spaces and pages">
    A page browser shows your Confluence spaces. Navigate and select pages to sync.
  </Step>

  <Step title="Save">
    Selected pages are fetched, chunked, and embedded.
  </Step>
</Steps>

## Auto-Sync

Confluence sources are automatically re-synced on a schedule. Updated pages are re-fetched and re-indexed.

## Managing Connections

On the **Integrations** page:

* **Rename** a Confluence connection
* **Disconnect** — removes credentials and stops syncs

## Routing Instructions

Add source-specific instructions for Confluence content.

**Example:**

> "This Confluence space contains engineering documentation. Include links to related Jira tickets when relevant."

## Troubleshooting

| Issue             | Solution                                                         |
| ----------------- | ---------------------------------------------------------------- |
| Connection failed | Verify your site URL, email, and API token are correct           |
| No spaces visible | Check that your Confluence account has read access to the spaces |
| Sync errors       | The API token may have expired — create a new one and reconnect  |