Skip to main content

​
Introduction

Integrate Gurubase with Confluence to use your pages as data sources for Gurubase. All the text files and images attached to your page content or comments are indexed as well.
For Gurubase Self-hosted version, this integration is currently in beta and available to selected users. For Gurubase Cloud version, this integration is available to all users.

​
Steps to Integrate

  1. Create your Atlassian API token
  2. Navigate to Integrations
    • Go to the Gurubase dashboard
    • Click on “My Gurus” under the profile
    • Click on the Guru you want to integrate with Jira
    • Click on the “Integrations” tab
    • Click on the “Confluence Bot” option
  3. Fill in the fields
    • Domain - Your Atlassian domain (e.g. your-domain.atlassian.net)
    • User Email - Your Atlassian user email
    • API Token - The API token you created in Step 1
Confluence Integration Fields

​
Using the Integration

After integrating with Confluence, you can add Confluence pages as data sources to your Guru in two ways:
Add Confluence Content Modal

​
Option 1: Add Individual Pages

Choose this option when you want to add specific Confluence pages by entering their URLs. This is best for targeted content where you know exactly which pages you want to include.
Add Individual Confluence Pages
When adding individual pages, you can:
  • Set Date Range: Define start and end dates to filter pages by creation date
  • Add Multiple Pages: Enter Confluence page URLs, with each page on a new line
  • Apply CQL Filters: Use optional CQL (Confluence Query Language) criteria to refine your selection
  • Fetch Pages: Click the “Fetch Pages” button to retrieve and add the pages

​
Option 2: Create Backfill Job

Choose this option to automatically import multiple pages based on CQL (Confluence Query Language) criteria. This is best for bulk imports and ongoing synchronization. You can also manually trigger the indexing process by clicking on the “Sync Now” option.
Create Confluence Backfill Job
When creating a backfill job, you can configure:
  • Sync Interval: How often to check for new content (minimum 1 hour)
  • CQL Query: Enter a CQL query to fetch Confluence pages that match your criteria
    • Example: space = "DOCS" AND type = "page", title ~ "project"
    • The query will be validated before creating the job
  • Automatic Updates: The job will periodically sync new pages that match your query
Use CQL queries to create powerful filters for Confluence content. For example:
  • space = "DOCS" AND type = "page" - Get all pages from the DOCS space
  • title ~ "API" AND lastModified >= "2024-01-01" - Get pages with “API” in title modified since 2024
  • creator = "john.doe" AND space in ("DEV", "QA") - Get pages created by john.doe in DEV or QA spaces

​
Content Indexing

The Confluence integration indexes:
  • Page Content: Full text content from Confluence pages
  • Comments: Text content from page comments
  • Attached Images: Images attached to pages and comments
  • Attached Text Files: Text files attached to pages and comments
The indexed pages are also shown in the Guru edit page as individual sources. This way, you can view the content that is actually indexed.

​
Next Steps

API Reference

Explore our API documentation

Add Discord Bot to Your Server

Learn how to add a Discord bot to your server
⌘I