Confluence integration

​

Overview

The Confluence integration allows Wolfia to sync knowledge base articles, documentation, and team content from your Confluence 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)
• Attachments - Files and documents attached to Confluence pages (read-only)

​

Prerequisites

Before setting up the integration, you’ll need:

• Admin access to your Confluence instance (Cloud or Server)
• Ability to authorize OAuth applications in Confluence
• Access to the specific Confluence spaces you want to sync with Wolfia

​

Setup instructions

​

Step 1: Navigate to integrations

Start by accessing the Wolfia integrations page.

1. Log in to your Wolfia account at https://wolfia.com
2. Navigate to Integrations from the main menu or go directly to https://wolfia.com/integrations
3. In the Available Integrations section, find Knowledge category
4. Locate the Confluence integration card and click Connect

​

Step 2: Configure connection

Provide your Confluence credentials and connection details.

1. Domain (Optional): Enter your Confluence domain if you have a specific instance
   • For Confluence Cloud: yourcompany.atlassian.net
   • For Confluence Server/Data Center: Your custom domain
   • 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 and content 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: Complete integration setup

Finish the integration configuration in Wolfia.

1. After successful authorization, you’ll be redirected back to Wolfia
2. The integration will automatically fetch your available Confluence spaces
3. Click Finish to complete the initial setup
4. You’ll see a confirmation that the Confluence integration has been successfully connected

​

Step 5: Select spaces to sync

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

1. Navigate to Integrations → Confluence or go directly to https://wolfia.com/integrations/confluence
2. Click Manage to access space selection settings
3. Toggle spaces: Enable or disable specific spaces for syncing
   • Enabled spaces will have their content synced and made available to Wolfia
   • Disabled spaces will be excluded from syncing
4. Space information displayed:
   • Space name and key
   • Space type (Global, Personal, etc.)
   • Current sync status
   • Last sync time

​

What happens after setup

Once configured, Wolfia will:

• Import existing content – Sync pages and attachments from enabled Confluence spaces
• Continuous monitoring – Automatically detect and sync new or updated content
• 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 sync status

Monitor the health and activity of your Confluence integration:

1. Navigate to Integrations → Confluence
2. View integration dashboard showing:
   • Connection status - Active, paused, or error state
   • Enabled spaces - Number of spaces currently being synced
   • Last sync time - When content was last updated
   • Content statistics - Number of pages and attachments synced
   • Recent activity - Latest sync operations and any errors

​

Adding or removing spaces

Modify which spaces are included in your knowledge base:

1. Go to Integrations → Confluence → 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. Changes take effect immediately and trigger a sync update

​

Monitoring content updates

Track when Confluence content is refreshed in Wolfia:

1. Automatic syncing - Wolfia checks for updates periodically (typically every 15-30 minutes)
2. Manual refresh - Trigger immediate sync from the integration dashboard
3. Change notifications - View recent content updates in the activity feed

​

Pausing the integration

Temporarily stop syncing without removing the integration:

1. Navigate to Integrations → Confluence
2. Toggle the Active switch to pause syncing
3. Content remains available in Wolfia but stops updating
4. Toggle back to resume automatic syncing

​

Disconnecting Confluence

Remove the integration entirely:

1. Go to Integrations → Confluence
2. Click Disconnect or Remove Integration
3. Confirm the disconnection in the dialog
4. All synced content will be removed from Wolfia’s knowledge base
5. The OAuth authorization will be revoked

​

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
• Content tagging - Automatically tags content with source space information
• Search scoping - Allows filtering search results by Confluence space

​

Content types supported

The integration handles these Confluence content types:

• Confluence pages - Documentation pages with text and formatting
• Page 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 admin permissions: Confirm your Confluence account has admin or space admin permissions

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. Personal space filtering: Personal spaces are excluded by default for privacy
4. Service account setup: If using a service account, ensure it has been granted access to the required spaces
5. Refresh the page: Sometimes spaces take a moment to load after initial connection

​

Syncing and content issues

Spaces enabled but no content appears

1. Check sync status: Go to Integrations → Confluence and verify “Last sync” shows recent timestamp
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 integration user
4. Wait for initial sync: Large spaces can take 15-30 minutes for first sync to complete

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. Look for sync errors: Check the integration dashboard for specific error messages about failed pages

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
4. Storage limits: If approaching Wolfia storage limits, new attachments may be skipped

​

Performance and reliability

Sync takes very long or times out

1. Large space issue: Spaces with thousands of pages may require multiple sync attempts
2. Network connectivity: Check your internet connection and Confluence server status
3. Confluence rate limits: Heavy API usage may trigger temporary rate limiting
4. Retry sync: Use the manual sync button in Integrations → Confluence → Manage

Integration shows as disconnected

1. Token expiration: OAuth tokens expire - simply reconnect through the setup flow
2. Permission changes: If your Confluence permissions change, reconnection may be needed
3. Service account changes: If using a service account, check if the account was deactivated or permissions modified
4. Server issues: Check Confluence server status and wait if there’s an outage
5. Revoked access: 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 manual sync 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 space administrator.

​

Getting specific help

Before contacting support, gather:

1. Confluence instance type: Cloud, Server, or Data Center version
2. Error messages: Exact text from any error dialogs or sync logs
3. Space details: Names and keys of affected spaces (remove sensitive info)
4. Sync timing: When the issue started and last successful sync time
5. 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 instance type and version
• Error messages - Specific errors from sync logs or setup 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.