> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/knowledge-base/confluence.md).
# Confluence
Confluence is Atlassian's team collaboration and knowledge management platform that provides a centralized space for creating, organizing, and sharing documentation. Connecting Confluence to Harmony enables your AI to access your organization's knowledge base, providing accurate and contextual responses to IT support requests.
Harmony connects to Confluence via OAuth, so setup is fast and secure - no API tokens required. Confluence is its own dedicated integration, independent from Jira Service Management, so you can authorize each separately based on your needs.
### What the Confluence integration enables
| Capability | Description |
| -------------------------- | --------------------------------------------------------------------------- |
| Knowledge Base Sync | Import selected Confluence spaces and pages to power Harmony's AI responses |
| Intelligent Search | Find relevant documentation instantly within support conversations |
| Contextual Responses | AI provides answers based on your actual IT documentation |
| Automated Documentation | Create and update Confluence pages from Harmony workflows |
| Permission-Aware Retrieval | Respect Confluence space and page permissions when surfacing articles |
| Real-Time Updates | Keep AI knowledge current with automatic page sync |
### Prerequisites
* **Atlassian Cloud Admin Access**: Site admin or org admin role
* **Confluence Instance**: Active Confluence Cloud instance (on-premises Confluence is not supported)
* **Harmony Account**: Active Harmony workspace
### Connect Confluence to Harmony
#### Step 1: Navigate to Integrations
1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **Confluence** under **Knowledge Base** and click **Connect**
#### Step 2: Start Authentication
1. Click **Connect** to start the OAuth authentication process
#### Step 3: Authorize in Atlassian
1. You will be redirected to Atlassian's login page
2. Enter your Atlassian account email
3. Complete the authentication process
4. Authorize Harmony to access your Confluence instance via Atlassian's standard OAuth flow
#### Step 4: Select Confluence Spaces to Sync
After authorizing, Harmony fetches your available Confluence spaces - including both KB-type and global spaces. You can select exactly which spaces to include in your Harmony Knowledge Base rather than ingesting your entire Confluence tenant.
1. Review the list of available spaces displayed during the setup flow
2. Select one or more spaces you want Harmony to sync
3. Confirm your selection to complete setup
Only content from your chosen spaces will be indexed, keeping your Knowledge Base focused and relevant to your support workflows. You can update your space selection at any time from the integration settings.
### What Harmony Syncs
**From Confluence:**
* Confluence pages and spaces (limited to your selected spaces)
* Page content, titles, and hierarchy
* Page metadata and last updated timestamps
* Custom fields and labels
* Attachments and embedded content
* Space-level and page-level permission rules
### Permission-Aware Knowledge Base Retrieval
When Harmony syncs your Confluence content, it captures both space-level access rules and page-level restrictions, then uses that information to filter knowledge base results at query time. This ensures your AI agents only surface content that a user is actually authorized to see.
* **Space-level permissions**: Users and groups who can access a Confluence space are synced and respected - users without space access will never see content from that space in Harmony responses.
* **Page-level restrictions**: Any additional restrictions applied to individual pages are also captured and enforced, so restricted pages are only surfaced to users with explicit access.
No additional configuration is required - permission filtering happens automatically as part of the sync process.
### Use Cases
Knowledge Base Integration
Surface Confluence articles during AI-powered support conversations
Intelligent Responses
AI provides answers based on your actual Confluence documentation
Automated Documentation
Create and update Confluence pages from ticket resolutions
Self-Service Portal
Empower users with instant access to Confluence knowledge
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.harmony.io/integrations/knowledge-base/confluence.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.