Confluence integration via OAuth

​

Overview

The Confluence integration allows Wolfia to sync pages, blog posts, and other content from your Confluence Cloud instance. This integration provides access to your organizational knowledge stored in Confluence spaces, making it available for responses to security questionnaires, RFPs, and team questions.

​

What we sync

• Confluence pages - Documentation, articles, and content from enabled spaces (read-only)
• Blog posts - Blog post content from enabled spaces (read-only)
• Databases - Confluence database content from enabled spaces (read-only)
• Whiteboards - Whiteboard content from enabled spaces (read-only)
• Attachments - Files and documents attached to Confluence pages (read-only)

​

Prerequisites

Before setting up the integration, you’ll need:

• A Confluence Cloud instance (e.g., yourcompany.atlassian.net)
• A Confluence account with read access to the spaces you want to sync
• Admin role in Wolfia to connect the integration

​

Setup instructions

​

Step 1: Navigate to Knowledge Hub

Start by accessing the Wolfia Knowledge Hub.

1. Log in to your Wolfia account at https://wolfia.com
2. Navigate to Knowledge Hub from the left sidebar, or go directly to https://wolfia.com/knowledge-hub
3. Find the Confluence integration and click Connect to Confluence

​

Step 2: Configure connection

Provide your Confluence Cloud domain.

1. Domain (Optional): Enter your Confluence Cloud domain if prompted
   • Example: yourcompany.atlassian.net
   • Leave blank to use the default Confluence Cloud authorization
2. Authentication: The integration uses OAuth 2.0 for secure authentication
3. Click Continue to proceed to the authorization step

​

Step 3: Authorize Wolfia access

Complete the OAuth authorization process with Confluence.

1. You’ll be redirected to Confluence’s authorization page
2. Sign in to your Confluence account if not already logged in
3. Review permissions: Wolfia requests read-only access to:
   • View pages, blog posts, databases, and whiteboards in accessible spaces
   • Read space information and metadata
   • Access page attachments and files
4. Grant access by clicking Accept or Allow in the Confluence authorization dialog

​

Step 4: Connection completes

After you authorize access, the connection is established automatically.

1. The authorization window will close and you’ll return to Wolfia
2. You’ll see a success notification confirming the Confluence integration is connected
3. Wolfia will begin fetching your available Confluence spaces in the background

​

Step 5: Select spaces to sync

Choose which Confluence spaces to include in your Wolfia knowledge base.

1. On the Knowledge Hub → Confluence page (https://wolfia.com/knowledge-hub/confluence), click Manage
2. In the management dialog, toggle spaces on or off:
   • Enabled spaces will have their content synced and made available to Wolfia
   • Disabled spaces will be excluded from syncing
3. For finer control, expand a space to select individual pages instead of syncing the entire space
4. Click Save to apply your selections

​

What happens after setup

Once configured, Wolfia will:

• Import existing content – Sync pages, blog posts, and attachments from enabled Confluence spaces
• Daily sync – Automatically check for new or updated content once per day
• Knowledge enrichment – Use Confluence content to provide better responses to questionnaires and RFPs
• Search integration – Make Confluence content searchable within Wolfia’s knowledge base

​

Managing the integration

​

Viewing synced content

Monitor your synced Confluence content:

1. Navigate to Knowledge Hub → Confluence
2. Use the space selector to filter by a specific Confluence space
3. The content table shows each synced page with:
   • Name – The page title (click to view in Confluence)
   • Last modified – When the content was last changed in Confluence
   • Last synced – When Wolfia last synced this content

​

Adding or removing spaces

Modify which spaces are included in your knowledge base:

1. Go to Knowledge Hub → Confluence and click Manage
2. Enable new spaces: Toggle on additional spaces to include them in syncing
3. Disable existing spaces: Toggle off spaces to stop syncing their content
4. Click Save – changes take effect immediately and trigger a sync

​

Refreshing content

Content syncs automatically once per day. To trigger an immediate refresh:

1. Click Manage on the Confluence integration page
2. Click the Refresh button in the management dialog to discover new spaces
3. For page-level refresh, content will sync on the next daily cycle or you can save your space selections again to trigger a sync

​

Disconnecting Confluence

Remove the integration entirely:

1. Go to Knowledge Hub → Confluence
2. Click Disconnect
3. Confirm the disconnection in the dialog
4. All synced content will be removed from Wolfia’s knowledge base

​

Content organization

​

Space-based organization

Wolfia organizes Confluence content by space:

• Space hierarchy – Maintains the original space structure
• Page relationships – Preserves parent-child page relationships when selecting individual pages

​

Content types supported

The integration syncs these Confluence content types:

• Pages – Documentation pages with text and formatting
• Blog posts – Blog content published in Confluence spaces
• Databases – Confluence database content
• Whiteboards – Whiteboard content
• Attachments – Files and documents attached to pages

​

Content processing

Wolfia processes Confluence content through:

• Text extraction – Extracts readable text from pages while preserving structure and meaning
• Document parsing – Processes attached files for searchable content
• Metadata preservation – Keeps page titles, authors, creation/modification dates

​

Troubleshooting

​

Connection and setup issues

Integration setup fails or gets stuck

1. Check browser settings: Disable ad blockers and allow pop-ups for wolfia.com and your Confluence domain
2. Try incognito mode: Use a private/incognito browser window to avoid cached credentials or session conflicts
3. Verify Confluence URL: If you specified a domain, ensure it matches exactly (e.g., yourcompany.atlassian.net)
4. Check Wolfia role: You need the Admin role in Wolfia to connect integrations

OAuth authorization fails

1. Verify account access: Ensure you can log in to Confluence normally in the same browser
2. Check organization policies: Some companies disable OAuth applications - contact your IT administrator
3. Clear browser data: Clear cookies and cache for both Wolfia and Confluence domains
4. Try different browser: Test with Chrome, Firefox, or Safari to isolate browser-specific issues

“No spaces found” after successful connection

1. Verify space permissions: You need at least read access to see spaces in the selection list
2. Check space status: Archived or deleted spaces won’t appear - ask your admin to restore if needed
3. Wait for initial sync: Spaces may take a moment to load after the initial connection
4. Click Refresh: In the Manage dialog, click the Refresh button to re-fetch spaces from Confluence

​

Syncing and content issues

Spaces enabled but no content appears

1. Wait for sync: After enabling spaces, the initial sync may take some time to complete
2. Verify space has content: Empty spaces or spaces with only restricted pages won’t sync content
3. Review page permissions: Pages with view restrictions may not be accessible to the account used for the integration
4. Check the space selector: Make sure you’ve selected the correct space in the dropdown filter

Some pages missing from sync

1. Check page restrictions: Pages with specific user/group permissions may not sync
2. Verify page status: Draft or archived pages are typically excluded from sync
3. Review parent pages: Child pages may not sync if parent pages are restricted
4. Check page selection: If you chose to sync individual pages, verify the missing pages are selected in the Manage dialog

Attachments not syncing

1. Verify file size: Very large files (>50MB) may be skipped during sync
2. Check file types: Some file formats may not be supported for text extraction
3. Review permissions: Attachment permissions must match or be more permissive than page permissions

​

Performance and reliability

Sync takes very long or times out

1. Large space issue: Spaces with thousands of pages may require more time
2. Network connectivity: Check your internet connection and Confluence Cloud status
3. Confluence rate limits: Heavy API usage may trigger temporary rate limiting

Integration shows as disconnected

1. Token expiration: OAuth tokens may expire - simply reconnect through the setup flow
2. Permission changes: If your Confluence permissions changed, reconnection may be needed
3. Revoked access: An Atlassian admin may have revoked OAuth app access - check with your administrator

​

Error messages and fixes

“Invalid domain” error during setup

• Solution: Enter just the domain without https:// (e.g., company.atlassian.net not https://company.atlassian.net)

“Access denied” during authorization

• Solution: Contact your Confluence administrator to enable OAuth applications for your organization

“Sync failed - rate limited”

• Solution: Wait 15-30 minutes and try again. Large instances may need multiple sync attempts.

“Space not found” for previously working spaces

• Solution: Space may have been archived, deleted, or permissions changed. Check with your space administrator.

​

Getting specific help

Before contacting support, gather:

1. Error messages: Exact text from any error dialogs
2. Space details: Names and keys of affected spaces (remove sensitive info)
3. Sync timing: When the issue started and last successful sync time
4. Browser info: Which browser and version you’re using

Quick diagnostic steps:

1. Try disconnecting and reconnecting the integration
2. Test with a different, smaller Confluence space
3. Check if the issue occurs for other team members
4. Verify Confluence is accessible and working normally outside of Wolfia

​

Support

If you encounter any issues during setup or ongoing operation, please contact Wolfia support at support@wolfia.com with:

• Integration details - Confluence Cloud instance URL
• Error messages - Specific errors from the setup or sync process
• Space information - Space names and types (without sensitive content)
• Screenshots - Setup screens or error dialogs (redact sensitive information)

For immediate assistance with Confluence-specific permissions, consult your Confluence administrator or refer to Atlassian’s OAuth documentation.