Skip to main content

Confluence as a data source

Connect a Confluence Cloud space to Biel.ai to index your team's pages and make them searchable through the assistant.

Available on all plans, including spaces that require sign-in.

Prerequisites​

  • A Biel.ai account.
  • An existing project.
  • For spaces that require sign-in, an Atlassian account with access to the pages you want to index.
  • Confluence Cloud (Server is not supported).

1. Generate a Confluence API token​

For a public space, skip this step. Add the space URL in Sources, leave Credentials (optional) as Public access, click Save, then Refresh sources. Only pages available without sign-in are included.

  1. Open your Atlassian account's API tokens.
  2. Click Create API token, enter a name, and select an expiration date. Use a token without scopes for Biel.ai's connection to your site's URL.
  3. Click Create, then Copy to clipboard. You cannot view the token again after closing this screen.

See Manage API tokens for your Atlassian account for details.

2. Connect Confluence to Biel.ai​

  1. In the Biel.ai dashboard, select your project.
  2. Go to Settings > Sources > Confluence.
  3. Enter the space URL, such as https://yourcompany.atlassian.net/wiki/spaces/DOCS.
  4. If the space requires sign-in, open Advanced options and click Create Confluence credentials.
  5. In the new tab, enter a name, the Site URL such as https://yourcompany.atlassian.net, your Atlassian Email and Access token.
  6. Click Save credentials and return to Sources.
  7. Select the credentials for each space on that site that should use them.
  8. Click Save, then Refresh sources.

Several spaces and projects in the same team can use the same credentials. The credentials’ site must match the space URL. See Credentials to change credentials, disable access or delete credentials.

Finding your space URL

Navigate to any page in your Confluence space and copy the URL up to /spaces/SPACENAME.

Monitor the loading status in the project dashboard and open Logs to check which pages were indexed.

Troubleshooting​

Authentication failed​

  • Verify your email matches your Atlassian account.
  • Check the API token is correct and hasn't expired.
  • Ensure you have access to the specified space.

Pages not indexing​

  • Check that pages are published (not drafts).
  • Verify space permissions allow API access.
  • Large spaces may take longer to process.

Content quality issues​

  • Confluence macros may not render properly in AI responses.
  • Consider excluding template or boilerplate pages with URL filters.